Gérer le contexte

La fenêtre de contexte contient tout ce que Claude sait de votre session : vos instructions, les fichiers qu’il a lus, ses propres réponses, les sorties de commandes, et aussi des éléments que vous ne voyez jamais dans le terminal. Bien la gérer, c’est obtenir de meilleures réponses et payer moins. Cette leçon explique ce qui la remplit, ce qui se passe quand elle déborde et les commandes pour la piloter.

Ce qui remplit le contexte

Avant même votre premier message, Claude Code charge vos fichiers CLAUDE.md, la mémoire automatique, les noms des outils MCP et les descriptions des skills. Ensuite, chaque fichier lu, chaque sortie de commande et chaque réponse s’ajoutent. Certaines extensions sont économes : les skills ne chargent leur contenu complet qu’au moment où elles servent, et les définitions complètes des outils MCP ne sont chargées qu’à la demande.

Pour voir ce qu’il en est réellement, lancez /context : vous obtenez la répartition par catégorie, avec des suggestions d’optimisation et la liste des fichiers CLAUDE.md et de mémoire effectivement chargés.

Le manque de place n’est plus le vrai problème

Les conseils anciens disaient de surveiller la fenêtre de contexte de près. La documentation actuelle est plus nuancée : la plupart des modèles récents disposent d’une fenêtre d’un million de jetons, et la conversation est compactée automatiquement près du haut de cette fenêtre, si bien qu’on en manque rarement. Mais vous payez le contexte : chaque requête renvoie toute la conversation. Une session qui a accumulé trois tâches sans rapport relit les trois à chaque tour de la quatrième. Le cache réduit ce coût tant qu’il est chaud, puis le plein tarif s’applique. La commande /usage montre où partent vos jetons.

Ce que fait la compaction

Quand la conversation approche de la limite, Claude Code la résume automatiquement. Le résumé conserve vos demandes et les extraits de code importants, mais les instructions détaillées données au début de la conversation peuvent se perdre. La règle qui en découle : ce qui doit durer va dans CLAUDE.md, pas dans la conversation. Après une compaction, le CLAUDE.md à la racine du projet est relu depuis le disque et réinjecté, tout comme la mémoire automatique ; une consigne donnée seulement à l’oral, elle, peut avoir disparu.

Vous pouvez orienter le résumé de deux façons :

• lancer /compact avec une consigne avant d’attaquer une nouvelle tâche longue, par exemple /compact focus on the API changes ;
• ajouter une section « Compact Instructions » à votre CLAUDE.md, qui dit ce qu’un résumé doit toujours garder.

Repartir de zéro avec /clear

/clear démarre une conversation vierge ; l’ancienne reste enregistrée et peut être reprise. C’est le bon réflexe entre deux tâches sans rapport : un contexte ciblé donne de meilleures réponses et coûte moins cher.

C’est aussi le bon réflexe quand une tâche part de travers. La consigne officielle est nette : après deux corrections ratées, ne tentez pas une troisième. La conversation contient déjà deux essais manqués que Claude continue de relire. Faites /clear et écrivez une nouvelle demande qui intègre ce que vous avez appris.

Revenir en arrière et résumer une partie

/rewind, ou deux pressions sur Échap quand l’invite est vide, ouvre le menu de retour en arrière. Il liste vos messages ; pour celui que vous choisissez, vous pouvez :

• Restore code and conversation : ramener le code et la conversation à ce point ;
• Restore conversation : revenir à ce message en gardant le code actuel ;
• Restore code : annuler les modifications de fichiers en gardant la conversation ;
• Summarize from here : résumer la conversation à partir de ce point pour libérer de la place ;
• Summarize up to here : résumer ce qui précède en gardant les derniers messages intacts.

Le résumé partiel est un /compact ciblé : idéal pour condenser une longue séance de débogage sans perdre vos consignes de départ. Attention à une limite : les points de contrôle ne suivent que les fichiers modifiés par les outils d’édition de Claude. Un fichier changé uniquement par une commande Bash n’est pas restauré, et les points de contrôle ne remplacent pas git.

Garder le bruit hors de la conversation

Deux outils évitent d’encombrer le contexte principal :

• /btw pose une question rapide sur ce que Claude sait déjà de la session, sans l’ajouter à l’historique (« /btw comment s’appelait ce fichier de configuration ? ») ; il n’a pas accès aux outils.
• Un sous-agent fait une recherche ou une tâche bruyante dans son propre contexte et ne renvoie qu’un résumé : lancer la suite de tests et ne rapporter que les échecs, par exemple. Claude Code délègue déjà de lui-même les recherches larges à son sous-agent Explore.

Piloter la session

Trois gestes valent d’être connus par cœur. Échap arrête Claude au milieu d’une action en gardant ce qui est fait. /rewind permet d’essayer d’abord l’approche audacieuse, puisqu’on peut revenir en arrière. /clear repart de zéro. Pour un travail qui s’étale sur plusieurs jours, nommez la session avec /rename migration-oauth : claude --resume migration-oauth la rouvrira plus tard, points de contrôle compris.

À vous de jouer

Lire votre contexte. Au milieu d’une session chargée, lancez /context et repérez ce qui prend le plus de place. Essayez ensuite /compact avec une consigne de ce qu’il faut garder, puis comparez. Pour la tâche suivante, sans rapport avec la précédente, utilisez /clear.

Sources officielles : Context management (Claude Academy) · Explore the context window · How Claude Code works · Checkpointing · Best practices

Points clés à retenir

• /context montre ce qui occupe le contexte ; /usage montre ce que cela coûte
• La compaction automatique peut perdre les consignes données au début : mettez les règles durables dans CLAUDE.md, et orientez le résumé avec /compact <consigne>
• /clear entre deux tâches, et après deux corrections ratées plutôt qu’une troisième
• /rewind (ou Échap deux fois) restaure le code, la conversation ou les deux, et peut résumer une partie de la session
• /btw pour une question en aparté, un sous-agent pour une tâche bruyante