Optimiser la vitesse de Claude Code : diagnostiquer les sessions lentes

Quand Claude Code ralentit, le modèle n’est pas toujours le problème. Le plus souvent, la session transporte trop d’historique, lit trop de fichiers, avale des logs bruts ou reçoit une consigne trop large. Sur ce site, les sessions les plus lentes combinaient rédaction, traduction, build, déploiement et debug dans le même fil. Le vrai gain est venu d’un rituel : regarder /usage et /context, compacter avec une intention, puis limiter clairement les fichiers à lire. Ce guide donne une méthode utilisable par un débutant : diagnostiquer, réduire l’exploration, écrire un CLAUDE.md léger, déléguer aux sous-agents et éviter les erreurs classiques.

Diagnostiquer avant d’optimiser

Commencez par /usage. Les utilisateurs API voient les tokens de session et une estimation locale du coût; les abonnés voient les barres de plan et l’attribution. Ce n’est pas la facture finale, mais un tableau de bord utile. Regardez ensuite /context. Vous verrez si l’espace est pris par l’historique, la mémoire, MCP, les outils ou les règles. Si le poids vient d’instructions permanentes, changer de modèle ne suffit pas. /compact résume l’historique. Ajoutez ce qui doit survivre: fichiers modifiés, tests en échec, décisions et questions ouvertes. La session reste plus légère sans perdre le fil.

# Run these inside Claude Code before changing the workflow
/usage
/context
/compact Preserve changed files, test failures, decisions, and open questions

Construire un workflow rapide par défaut

Le flux de base: /usage et /context au début d’une grosse tâche, /compact à chaque pause naturelle, /clear pour une tâche sans rapport. Effacer le contexte est parfois la meilleure optimisation. Deuxième réflexe: borner la lecture. Indiquez les fichiers à lire, le test à exécuter, les dossiers à ignorer et les preuves attendues dans la réponse. Troisième réflexe: garder CLAUDE.md court. La documentation memory recommande d’y placer seulement les faits nécessaires à chaque session; le reste doit aller dans rules ou skills.

claude -p "Fix only the null-check bug in src/api/auth.ts.
Read src/api/auth.ts and tests/auth.test.ts first.
Do not scan node_modules, dist, coverage, or unrelated feature folders.
Return the changed files, commands run, and remaining risks."

Ne garder dans CLAUDE.md que les faits toujours nécessaires

L’exemple est volontairement court : il donne à Claude une carte stable du dépôt sans transformer la mémoire en dépôt permanent de documentation.

# CLAUDE.md

## Project commands
- Build: npm run build
- Test: npm run test
- Type check: npm run typecheck

## Fast navigation
- API code: src/api/
- UI components: src/components/
- Tests: tests/

## Do not read unless explicitly requested
- node_modules/
- dist/
- coverage/
- .wrangler/

## Compact instructions
When compacting, preserve changed files, failing tests, decisions, credentials policy, and next actions.

Mesurer avec un petit benchmark

N’optimisez pas seulement au ressenti. Lancez une tâche similaire avec un prompt large puis borné, puis comparez durée, fichiers lus et qualité des preuves.

$runs = @(
  @{ Name = "wide"; Prompt = "Find and fix the auth bug in this project" },
  @{ Name = "scoped"; Prompt = "Fix the null-check bug in src/api/auth.ts only" }
)

foreach ($run in $runs) {
  $elapsed = Measure-Command { claude -p $run.Prompt }
  [pscustomobject]@{
    Name = $run.Name
    Seconds = [math]::Round($elapsed.TotalSeconds, 1)
  }
}

Trois cas d’usage pratiques

Petit correctif

Donnez le fichier, le test en échec et le critère d’acceptation. Claude lit moins et corrige plus vite.

Refactorisation large

Séparez recherche, modification, test et revue. Compactez entre les phases en conservant décisions et risques.

Pipeline éditorial

Traduction, listes et vérifications répétitives peuvent partir en sous-agent. La session principale garde les décisions.

Échecs à éviter

/compact sans consigne peut perdre le détail du test en échec ou la raison d’un choix d’architecture.
Un CLAUDE.md trop long devient une taxe permanente: incidents anciens, notes personnelles et procédures rares sont relus tout le temps.
Supprimer la vérification pour gagner du temps crée des retours arrière. Filtrez les logs, mais gardez les lignes utiles.

Documentation officielle vérifiée

Claude Code costs and /usage: https://code.claude.com/docs/en/costs
Claude Code monitoring and telemetry: https://code.claude.com/docs/en/monitoring-usage
Claude Code memory and CLAUDE.md: https://code.claude.com/docs/en/memory

Ce qui a été vérifié pour cette réécriture

Cette version suit les docs actuelles Costs, Monitoring et Memory, avec /usage, /context, /compact et CLAUDE.md comme base.

Prochaine étape

Si votre équipe veut accélérer Claude Code, ne commencez pas par un modèle plus grand ou plus d’automatisation. Standardisez d’abord le prompt, la mémoire et la preuve de vérification.