Gérer le contexte de Claude Code : /compact, /clear et la fenêtre de contexte (2026)

TL;DR — L'essentiel en 5 points

La qualité des réponses de Claude Code commence à se dégrader dès que 20 à 40 % de sa fenêtre de contexte est remplie, bien avant d'atteindre la limite technique (bonnes pratiques Claude Code, 2026). Gérer le contexte n'est donc pas un détail d'expert : c'est le levier n°1 pour garder un agent précis sur les sessions longues. Voici comment piloter les commandes /clear, /compact et /context au bon moment, et pourquoi une session « propre » vaut mieux qu'une session « pleine ».

C'est quoi la fenêtre de contexte de Claude Code ?

La fenêtre de contexte est la mémoire de travail de Claude Code pendant une session : elle contient l'intégralité de la conversation — chaque message que vous tapez, chaque fichier que l'agent lit, chaque sortie de commande qu'il exécute. Les modèles Claude (Sonnet, Opus) disposent d'une fenêtre de 200 000 tokens en standard, extensible jusqu'à 1 million de tokens en bêta (Anthropic, 2026). Un token représente environ 4 caractères, soit à peu près 0,75 mot.

Concrètement : quand vous demandez à Claude de lire dix fichiers, de lancer une suite de tests puis de discuter d'une refonte, tout cela s'empile dans la même fenêtre. Tant qu'il reste de la place, l'agent voit tout. Mais une fois la fenêtre saturée, il doit « oublier » le début de la conversation pour continuer — et c'est là que les ennuis commencent.

Pourquoi Claude Code devient moins bon quand la session s'allonge ?

Parce que la fenêtre pleine n'est pas le vrai problème : la dégradation commence bien avant. Le mécanisme d'attention des modèles accorde moins de poids aux instructions les plus anciennes à mesure que le contexte se remplit. Résultat : Claude Code produit ses meilleures réponses au début d'une session, puis devient progressivement moins fiable — il oublie une consigne donnée 40 messages plus tôt, mélange deux fichiers, ou réintroduit un bug déjà corrigé. Ce phénomène est parfois appelé « context rot » (pourrissement du contexte).

« La sortie de Claude commence à se dégrader dès 20 à 40 % de la fenêtre de contexte, bien avant que la moindre limite technique n'entre en jeu, parce que le mécanisme d'attention accorde moins de poids aux instructions initiales à mesure que le contexte se remplit. » — Synthèse des bonnes pratiques Claude Code, 2026

La conséquence est contre-intuitive : garder une session ouverte « pour ne pas perdre le contexte » est souvent une mauvaise idée. Une session courte et ciblée, relancée proprement entre deux tâches, donne de meilleurs résultats qu'un fil géant qui traîne depuis trois heures. Le réflexe pro en 2026 : viser un remplissage sous 60 % de la capacité et repartir au propre au-delà (SmartScope, 2026).

Un exemple parle mieux qu'une théorie. Imaginez une session de trois heures : vous corrigez un bug d'authentification (Claude lit huit fichiers), puis vous enchaînez sur l'ajout d'une feature, puis sur la rédaction de tests, puis sur un correctif de style. À la quatrième tâche, la fenêtre est saturée des fichiers d'auth qui ne servent plus à rien. Claude commence à confondre les modules, propose du code incohérent, réintroduit une régression. Le problème n'est pas le modèle : c'est le contexte pollué. Un simple /clear entre chaque tâche aurait maintenu la fenêtre à moins de 20 % et l'agent au sommet de sa forme du début à la fin.

/clear ou /compact : quelle commande utiliser et quand ?

Ce sont les deux commandes de base pour reprendre la main sur le contexte, et elles ne font pas la même chose. /clear vide entièrement la fenêtre : Claude oublie toute la conversation et repart de zéro (il garde uniquement votre CLAUDE.md). /compact au contraire résume la session : Claude condense ce qui compte — décisions prises, fichiers modifiés, patterns de code — puis continue avec ce résumé au lieu de l'historique complet.

La règle simple : /clear entre deux tâches indépendantes (vous passez du fix d'un bug d'auth à la rédaction d'un README), /compact quand une même tâche longue sature la fenêtre (une grosse refonte qui s'étale sur 50 échanges). Beaucoup de développeurs sous-utilisent /clear par peur de « tout perdre » ; c'est justement l'inverse qu'il faut faire.

Comment utiliser /compact intelligemment (avec instructions) ?

Le compactage automatique se déclenche seul quand la fenêtre est presque pleine, mais il devine ce qui est important. Vous pouvez faire mieux en guidant le résumé. Au lieu de taper /compact tout seul, ajoutez une instruction : Claude conservera ce que vous nommez plutôt que ce qu'il croit prioritaire.

Par exemple, sur une refonte d'API, demandez à Claude de compacter en gardant les changements d'endpoints et les messages d'erreur rencontrés, et de résumer brièvement les explorations de fichiers. Le résumé préserve alors la substance de la tâche et jette le bruit.

Encore plus puissant : inscrivez votre politique de compactage directement dans le CLAUDE.md du projet. À chaque compactage automatique, Claude appliquera la même règle sans que vous ayez à la retaper. Une politique type tient en quatre lignes :

Lors du compactage : conserver toutes les modifications d'API et leur justification ; garder les messages d'erreur et leur solution ; maintenir la liste des fichiers modifiés ; résumer brièvement les tentatives d'exploration.

Vous transformez ainsi une fonction « boîte noire » en un comportement prévisible et reproductible pour toute l'équipe.

Quelles autres commandes pilotent le contexte ?

Au-delà de /clear et /compact, quelques commandes complètent la panoplie 2026 :

• /context — affiche le taux de remplissage de la fenêtre. C'est votre jauge d'essence : consultez-la avant de vous demander « pourquoi Claude patine ? ».
• /resume — reprend une session précédente. Utile pour continuer un travail sans repartir de zéro, mais attention : vous rechargez aussi le contexte accumulé.
• /cost — montre les tokens consommés. Un contexte gonflé coûte plus cher à chaque tour, car toute la fenêtre est renvoyée au modèle à chaque message.
• Les sous-agents — déléguer une tâche lourde (audit, exploration massive) à un sous-agent isole son contexte du vôtre. Le sous-agent lit cent fichiers dans SA fenêtre et ne vous renvoie que la conclusion. Votre session principale reste propre.

Cette dernière technique est le secret des workflows avancés : on ne remplit jamais la fenêtre principale avec de la recherche brute. On délègue, on récupère la synthèse, on continue au propre.

5 réflexes pour garder un contexte propre

1. Un fil = une tâche. Faites /clear dès que vous changez de sujet. Les sessions courtes battent les sessions longues.
2. Surveillez /context. Au-delà de 60 % de remplissage, compactez ou repartez au propre plutôt que de forcer.
3. Guidez vos /compact. Ne laissez pas l'agent deviner : dites-lui quoi garder.
4. Déléguez la recherche lourde à des sous-agents. Gardez la fenêtre principale pour la décision, pas pour le bruit.
5. Écrivez un CLAUDE.md concis. Sous 150 lignes : c'est le seul contexte qui survit à un /clear, autant qu'il soit dense et utile.

Maîtriser ces réflexes change radicalement l'expérience : au lieu d'un agent qui se dégrade au fil de l'après-midi, vous gardez un Claude Code aussi précis au 200e message qu'au premier.

FAQ

Est-ce que /clear supprime mon CLAUDE.md ?

Non. /clear vide l'historique de conversation mais Claude Code recharge votre CLAUDE.md (utilisateur et projet) au démarrage de chaque nouvelle session. Vos règles permanentes survivent toujours à un /clear — c'est justement pour ça qu'il faut y mettre l'essentiel.

Quelle est la différence entre /compact et la mémoire (Auto Memory) ?

/compact agit sur la session en cours : il résume la conversation pour libérer de la place. La mémoire (CLAUDE.md et Auto Memory) est persistante entre les sessions. L'un gère le court terme, l'autre le long terme.

Combien de tokens fait la fenêtre de contexte de Claude Code ?

200 000 tokens en standard, jusqu'à 1 million en bêta selon le modèle (Anthropic, 2026). Mais la limite pratique est plus basse : la qualité baisse dès 20 à 40 % de remplissage, donc ne raisonnez pas « limite » mais « fraîcheur ».

Faut-il compacter souvent ou rarement ?

Rarement si vous faites /clear entre les tâches. Le /compact est réservé aux tâches longues et continues qui ne peuvent pas être coupées. Si vous compactez toutes les dix minutes, c'est le signe qu'il fallait plutôt découper le travail ou déléguer à un sous-agent.

Perd-on en qualité après un /compact ?

Un peu : le résumé remplace le détail, donc des nuances fines peuvent disparaître. C'est pourquoi il faut guider le compactage avec des instructions et inscrire une politique dans le CLAUDE.md, pour ne jamais perdre les informations critiques.

Gérer le contexte est l'une des compétences les plus rentables et les moins enseignées de Claude Code. C'est exactement le genre de réflexe pratique que nous décortiquons dans la formation MaitriseIA, avec des cas concrets et des templates prêts à l'emploi.

Commencer la formation → maitriselia.fr