Gérer le Contexte Claude Code : /compact, Context Rot 2026

Gérer le contexte Claude Code : le guide pour éviter le context rot

Pour gérer le contexte Claude Code efficacement, utilisez /compact de façon proactive vers 50-60 % de remplissage, /clear quand vous changez de tâche, et laissez le microcompact nettoyer les anciens résultats d'outils. C'est la compétence qui sépare un usage frustrant d'un usage productif de l'agent.

La fenêtre de contexte n'est pas qu'une limite technique : c'est le facteur numéro un de la qualité du code généré sur les longues sessions. Ce guide explique comment gérer le contexte de Claude Code en pratique.

Sommaire

Qu'est-ce que le context rot dans Claude Code ?

Le context rot (ou "pourrissement du contexte") désigne la dégradation progressive de la qualité des réponses quand la fenêtre de contexte se remplit. Concrètement, autour de 60 % de capacité, le modèle commence à se répéter, oublie des contraintes établies plus tôt et ignore certaines instructions.

Ce n'est pas un bug : c'est une propriété structurelle des modèles de langage. Plus l'historique de conversation grossit, plus les informations fondamentales (votre fichier CLAUDE.md, vos décisions d'architecture) se diluent dans le bruit des résultats d'outils accumulés.

Le symptôme typique : après deux heures de session, vous devez ré-expliquer des décisions que vous pensiez actées. C'est le signe qu'il faut gérer le contexte de Claude Code activement plutôt que d'attendre la saturation.

Pour aller plus loin sur les fondamentaux, consultez notre [guide complet de Claude Code](/blog/claude-code-guide-complet).

/compact vs /clear : quelle commande choisir ?

Claude Code propose deux commandes natives pour gérer le contexte. Choisir la bonne au bon moment évite 80 % des problèmes de context rot.

La commande /compact

/compact génère un résumé de la conversation puis remplace l'historique complet par cette version condensée. Une session de 70 000 tokens peut tomber à 4 000 tokens tout en conservant l'intention, les décisions et la direction du travail.

Utilisez /compact quand vous êtes au milieu d'une tâche et voulez continuer sans perdre le fil. Le coût : la compaction nécessite un appel au modèle, donc une minute environ et quelques tokens dépensés. Vous pouvez préciser ce qui doit être conservé : /compact garde la logique d'auth et le schéma de la base.

La commande /clear

/clear efface totalement l'historique de conversation et libère quasiment tout le contexte. Vous repartez d'une feuille blanche : tout le contexte implicite construit (préférences, compréhension du codebase) disparaît.

Utilisez /clear quand vous passez à une tâche sans rapport avec la précédente. C'est plus rapide et plus propre qu'une compaction, mais à proscrire si vous voulez garder la continuité.

Le microcompact automatique

Le microcompact nettoie en arrière-plan les anciens résultats d'outils devenus inutiles : un fichier lu il y a 30 minutes mange encore des milliers de tokens sans valeur. Contrairement à /compact, il ne résume pas la conversation, il purge seulement le bruit. Il agit automatiquement et préserve votre raisonnement actif.

Comment gérer le contexte Claude Code de façon proactive ?

La règle d'or : ne jamais attendre que la barre de contexte soit à 95 %. La plupart des utilisateurs gèrent mal le contexte de Claude Code précisément parce qu'ils réagissent trop tard.

Voici une routine éprouvée :

Cette discipline rejoint nos [meilleures pratiques Claude Code](/blog/meilleures-pratiques-claude-code) et conditionne la réussite des [workflows autonomes longue durée](/blog/workflows-autonomes-long-running-claude-code).

Optimiser la fenêtre de contexte de 1 million de tokens

Avec le passage au [contexte de 1 million de tokens](/blog/claude-opus-4-6-context-1-million-tokens), beaucoup pensent que la gestion du contexte n'est plus nécessaire. C'est faux : la qualité du modèle se dégrade bien avant d'atteindre la limite.

Un million de tokens ne signifie pas un million de tokens utiles. La bonne nouvelle, c'est que cette fenêtre élargie vous laisse plus de marge pour compacter proactivement avec une description précise de l'objectif, sans casser votre flux de travail.

En pratique, le context engineering moderne combine trois leviers : la mémoire persistante (CLAUDE.md, fichiers de mémoire), la compaction (résumé) et le nettoyage des outils (microcompact). Maîtriser ces trois leviers, c'est garder un raisonnement net même sur des sessions de plusieurs heures.

Les erreurs fréquentes de gestion du contexte

Les pièges les plus courants quand on veut gérer le contexte de Claude Code :

Cette compétence fait partie du socle enseigné dans une [formation Claude Code structurée](https://go.saas-ia.io/se-faire-remplacer-par-lia), car elle change radicalement la fiabilité de l'agent.

FAQ sur la gestion du contexte Claude Code

Quand utiliser /compact dans Claude Code ?

Dès 50-60 % de remplissage de la fenêtre de contexte, quand vous voulez continuer la même tâche sans perdre les décisions prises. Ne jamais attendre 90-95 %.

Quelle différence entre /compact et /clear ?

/compact résume et conserve l'essentiel de la conversation ; /clear efface tout pour repartir de zéro. Compact pour continuer, clear pour changer de sujet.

Le context rot existe-t-il avec le contexte de 1M tokens ?

Oui. La fenêtre élargie repousse la limite mais la qualité se dégrade dès ~60 % de capacité. La gestion proactive du contexte reste indispensable.

Faut-il désactiver le microcompact automatique ?

Non. Le microcompact nettoie le bruit (anciens résultats d'outils) sans toucher à votre raisonnement actif. Il est bénéfique dans la quasi-totalité des cas.

Où mettre les règles que Claude Code doit toujours respecter ?

Dans le fichier CLAUDE.md, jamais dans la conversation. Les résumés de compaction sont volontairement incomplets et peuvent perdre une consigne placée dans le chat.

Comment savoir que mon contexte Claude Code est saturé ?

Surveillez l'indicateur de contexte et les symptômes : répétitions, instructions ignorées, décisions oubliées. Ces signaux précèdent toujours la saturation visible.

Conclusion

Savoir gérer le contexte de Claude Code est l'une des compétences à plus fort impact sur la qualité du code généré. Compaction proactive, /clear au bon moment, microcompact et CLAUDE.md bien construit : ces quatre leviers transforment un agent capricieux en collaborateur fiable sur des sessions de plusieurs heures.

Articles connexes