Gestion du contexte - Aide-memoire

La gestion du contexte dans Claude Code détermine la qualité de chaque réponse générée. Cet aide-mémoire couvre l'anatomie de la fenêtre de contexte (jusqu'à 1M tokens sur les modèles actuels), les stratégies d'optimisation, le mode Plan, la compaction automatique et le scaling multi-sessions. Gardez cette fiche pratique sous la main pour maîtriser votre consommation de contexte au quotidien.

La gestion du contexte dans Claude Code est la discipline qui consiste à maximiser la pertinence des réponses en contrôlant ce que le modèle voit dans sa fenêtre de contexte. Les modèles actuels (Opus 4.6 et plus, Sonnet 4.6) offrent une fenêtre allant jusqu'à 1 million de tokens (GA). La valeur de 200 000 tokens reste celle des modèles plus anciens et la valeur par défaut sur Bedrock, Vertex et Foundry. Le modèle par défaut dépend de votre plan : Sonnet 4.6 sur Pro et Team Standard, Opus 4.8 sur Max, Team Premium, Enterprise et API. À titre de repère, 200 000 tokens représentent environ 150 000 mots.

Un token correspond approximativement à quelques caractères de texte. Maîtriser cette ressource finie est la compétence la plus rentable pour tout développeur utilisant Claude Code.

Quelles sont les commandes essentielles pour gérer le contexte ?

Voici le tableau de référence rapide des commandes les plus fréquentes. Chaque ligne est autonome et citable.

Pour retrouver toutes les commandes slash disponibles, consultez l'aide-mémoire des commandes slash essentielles qui détaille chaque raccourci.

À retenir : /compact, /context, /cost et /clear sont vos quatre leviers principaux pour surveiller et gérer votre fenêtre de contexte.

Comment fonctionne la fenêtre de contexte ?

La fenêtre de contexte est la mémoire de travail du modèle. Elle contient tout ce que Claude Code voit pour générer une réponse : le prompt système, les fichiers lus, votre historique de conversation et les résultats d'outils.

En pratique, un fichier TypeScript de 500 lignes consomme environ 4 000 tokens. Un git diff de 200 lignes occupe environ 1 600 tokens. Le fichier CLAUDE.md du projet consomme entre 500 et 3 000 tokens selon sa taille.

Concrètement, lorsque la conversation approche environ 95 % de la fenêtre de contexte, Claude Code déclenche automatiquement la compaction. Vous pouvez suivre la consommation en observant l'indicateur de coût dans le prompt. Pour comprendre ce mécanisme en profondeur, explorez le tutoriel complet sur la gestion du contexte.

À retenir : même une fenêtre de 1M tokens n'est pas infinie, et sur les modèles plus anciens ou les valeurs par défaut de Bedrock/Vertex/Foundry (200k tokens), un fichier volumineux plus un long historique peuvent la saturer en quelques échanges.

Comment optimiser le contexte pour des réponses précises ?

Voici les stratégies concrètes pour garder un contexte propre et pertinent. Chaque technique réduit le bruit et améliore la qualité des réponses.

Cibler les fichiers chargés

Évitez de charger des fichiers entiers quand vous n'avez besoin que d'une section. Utilisez les paramètres offset et limit de l'outil Read :

# Au lieu de lire tout le fichier (2000 lignes = ~16000 tokens)
# Ciblez la section pertinente
# Read avec offset=150, limit=50 → seulement 400 tokens

Formuler des prompts concis

Réduisez la taille de vos messages. Un prompt de 200 mots consomme environ 300 tokens. Un prompt de 50 mots bien ciblé obtient souvent de meilleurs résultats.

# ❌ Prompt verbeux (≈300 tokens)
"Peux-tu regarder le fichier src/auth.ts et me dire s'il y a des problèmes de sécurité, notamment au niveau de la validation des tokens JWT, la gestion des sessions..."

# ✅ Prompt ciblé (≈50 tokens)
"Audite src/auth.ts : vulnérabilités JWT et sessions"

Utiliser /compact avec des instructions ciblées

La commande /compact accepte un argument textuel. Spécifiez exactement ce que vous voulez conserver :

/compact garde le schéma de la base de données et les endpoints modifiés

Pour découvrir d'autres raccourcis qui accélèrent votre workflow, consultez l'aide-mémoire de vos premières conversations avec Claude Code.

En pratique, un développeur qui applique ces techniques maintient un contexte efficace sur beaucoup plus d'échanges qu'un usage non optimisé.

À retenir : ciblez vos lectures, compactez régulièrement et formulez des prompts courts. Ces trois habitudes augmentent nettement votre autonomie en contexte.

Pourquoi utiliser le mode Plan pour économiser des tokens ?

Le mode Plan est un mode de fonctionnement où Claude Code réfléchit et explore sans exécuter d'actions. Il consomme moins de tokens car il n'appelle pas d'outils coûteux (pas de bash, pas d'édition de fichier).

Quand activer le mode Plan ?

Activez le mode Plan dans ces situations :

1. Vous explorez une base de code inconnue
2. Vous planifiez une refactorisation multi-fichiers
3. Vous évaluez plusieurs approches avant de coder
4. Vous voulez un plan d'action avant d'écrire du code

# Basculez en mode Plan
Shift+Tab

# Demandez une exploration
"Analyse l'architecture du dossier src/api/ et propose un plan de refactorisation"

# Rebasculez en mode Normal pour implémenter
Shift+Tab

le mode Plan réduit fortement la consommation de tokens par rapport au mode normal pour les phases d'exploration. La fiche complète sur la gestion du contexte détaille les cas d'usage avancés du mode Plan.

Pour aller plus loin sur l'optimisation de vos workflows, SFEIR Institute propose une formation Claude Code d'une journée. Vous y pratiquerez la gestion du contexte, le mode Plan et les stratégies d'optimisation dans des labs encadrés.

À retenir : le mode Plan (Shift+Tab) réduit fortement votre consommation de tokens pendant les phases d'exploration. Utilisez-le systématiquement avant de coder.

Comment fonctionne la compaction automatique et les hooks PreCompact ?

La compaction automatique se déclenche lorsque la conversation approche environ 95 % de la fenêtre de contexte. Claude Code résume alors l'historique pour libérer de l'espace. Ce déclenchement est automatique : il n'expose pas de variable de configuration documentée pour ajuster son seuil.

Le processus de compaction

1. Claude Code détecte que le seuil d'environ 95 % est atteint
2. Il génère un résumé structuré de la conversation
3. L'historique complet est remplacé par ce résumé
4. La conversation continue avec le résumé comme base

En pratique, la compaction remplace l'historique complet par un résumé compact, libérant une grande partie de la fenêtre de contexte.

Configurer un hook PreCompact

Les hooks PreCompact vous permettent d'exécuter du code avant chaque compaction. Configurez-les dans votre fichier .claude/settings.json :

{
 "hooks": {
 "PreCompact": [
 {
 "matcher": "auto",
 "hooks": [
 {
 "type": "command",
 "command": "echo '=== CONTEXTE CRITIQUE ===' && cat .claude/context-notes.md",
 "timeout": 5
 }
 ]
 }
 ]
 }
}

Ce hook injecte vos notes de contexte critiques dans le résumé de compaction. Concrètement, cela garantit que certaines informations survivent à chaque cycle de compaction.

Commandes de compaction

Pour configurer des hooks avancés, consultez l'aide-mémoire d'intégration Git qui montre des exemples de hooks dans différents contextes. Vous pouvez aussi consulter la FAQ sur la gestion du contexte pour les questions fréquentes sur la compaction.

À retenir : la compaction automatique est votre filet de sécurité, les hooks PreCompact sont votre moyen de contrôler ce qui survit au résumé.

Comment scaler avec les multi-sessions et le parallélisme horizontal ?

Quand une seule fenêtre de contexte ne suffit pas, répartissez le travail sur plusieurs sessions Claude Code en parallèle. C'est le scaling horizontal du développement assisté par IA.

Lancer des sessions parallèles

# Terminal 1 : session backend
claude  # dans le répertoire backend-api

# Terminal 2 : session frontend
claude  # dans le répertoire frontend-ui

# Terminal 3 : session tests
claude  # dans le répertoire test-suite

Chaque session dispose de sa propre fenêtre de contexte. Sur les modèles actuels (jusqu'à 1M tokens chacun), trois sessions parallèles offrent jusqu'à 3 millions de tokens de contexte total.

Orchestrer avec le mode headless

Pour les tâches automatisées, utilisez le mode headless qui exécute Claude Code sans interface interactive :

# Lancer un audit en arrière-plan
claude -p "Audite tous les fichiers src/**/*.ts pour les vulnérabilités XSS" --output-format json > audit.json

# Lancer plusieurs tâches en parallèle
claude -p "Corrige les types dans src/models/" &
claude -p "Ajoute les tests manquants dans tests/" &
wait

Pour exploiter le mode headless en CI/CD, l'aide-mémoire du mode headless et CI/CD fournit des pipelines prêts à l'emploi.

le mode multi-sessions peut améliorer la productivité sur les projets qui touchent plusieurs fichiers simultanément. En pratique, les développeurs qui adoptent le multi-sessions réduisent souvent leur temps de refactorisation en parallélisant les tâches indépendantes.

À retenir : ouvrez une session par domaine fonctionnel. Chaque session bénéficie de 100 % de la fenêtre de contexte sans interférence.

Quels raccourcis clavier accélèrent la gestion du contexte ?

Voici la référence complète des raccourcis liés à la gestion du contexte dans Claude Code.

Pour maîtriser l'ensemble des commandes et raccourcis, l'aide-mémoire d'installation et premier lancement couvre la configuration initiale des raccourcis.

Si vous souhaitez aller au-delà de cet aide-mémoire, SFEIR Institute propose la formation Développeur Augmenté par l'IA sur 2 jours. Vous y apprendrez à orchestrer plusieurs agents, à optimiser vos pipelines de contexte et à intégrer Claude Code dans vos workflows d'équipe. Pour les profils confirmés, la formation Développeur Augmenté par l'IA – Avancé d'une journée approfondit le scaling multi-sessions et les hooks personnalisés.

À retenir : Shift+Tab et Esc (double-tap) sont les deux raccourcis qui impactent le plus votre budget de contexte.

Quelles erreurs courantes gaspillent le contexte ?

Évitez ces pièges fréquents qui consomment inutilement des tokens.

En pratique, la majorité des dépassements de contexte proviennent de fichiers chargés sans filtrage. Un fichier package-lock.json peut à lui seul consommer 80 000 tokens.

Pour identifier et corriger ces erreurs dans votre usage quotidien, consultez le guide des erreurs courantes de gestion du contexte. Vous pouvez aussi explorer les possibilités du protocole MCP pour externaliser certaines données hors du contexte principal.

À retenir : un seul fichier mal ciblé peut consommer une grande part de votre fenêtre. Vérifiez toujours la taille avant de charger.

Comment mettre en place un workflow quotidien de gestion du contexte ?

Voici un workflow type pour une journée de développement avec Claude Code, optimisé pour la gestion du contexte.

Séquence de démarrage

1. Lancez Claude Code dans le répertoire du projet : claude
2. Vérifiez que le fichier CLAUDE.md est à jour : /init
3. Activez le mode Plan pour explorer : Shift+Tab
4. Formulez votre objectif en une phrase ciblée

Séquence de travail

1. Explorez en mode Plan (lecture seule, économie de tokens)
2. Basculez en mode Normal pour implémenter : Shift+Tab
3. Compactez toutes les 8 à 10 interactions : /compact
4. Séparez les tâches longues en sessions dédiées

Séquence de fin de journée

1. Compactez une dernière fois avec instructions : /compact résumé des changements du jour
2. Notez l'ID de session pour reprise : visible dans le prompt
3. Reprenez le lendemain : claude --continue (dernière conversation) ou claude --resume (session spécifique)

# Workflow complet en commandes
claude # 1. Démarrer
/init # 2. Initialiser CLAUDE.md
# Shift+Tab # 3. Mode Plan
# ... explorer et planifier ...
# Shift+Tab # 4. Mode Normal
# ... implémenter ...
/compact garde les modifs auth # 5. Compacter
# ... continuer ...
/compact résumé final # 6. Fin de journée

Concrètement, ce workflow permet de maintenir un contexte optimal sur une journée complète de 8 heures avec 40 à 60 interactions. Pour approfondir chaque étape, la fiche de référence rapide sur la gestion du contexte centralise toutes les ressources.

À retenir : démarrez en mode Plan, compactez régulièrement, séparez les domaines en sessions : ces trois principes couvrent la grande majorité des besoins.

---

Contenu rédigé par SFEIR Institute - organisme de formation IT spécialisé dans les technologies cloud et IA. Retrouvez nos formations sur sfeir.com.