Comment éviter que la fenêtre de contexte de votre agent de codage IA ne se remplisse

Chaque agent de codage IA travaille à l'intérieur d'une fenêtre de contexte — la quantité finie de texte qu'il peut « voir » à la fois : vos messages, ses réponses, les fichiers qu'il lit, la sortie des commandes qu'il exécute. Lorsque cette fenêtre se remplit, la qualité chute de manières qui semblent mystérieuses. L'agent oublie une décision que vous avez prise il y a vingt minutes, relit un fichier qu'il a déjà modifié, ou se contredit discrètement. Sur toute tâche qui dure plus de quelques minutes, la gestion du contexte est le levier le plus important dont vous disposez sur la qualité du résultat. Voici comment le faire de manière délibérée.

Pourquoi une fenêtre pleine nuit

Les modèles ne se dégradent pas élégamment lorsque la fenêtre se remplit. Deux choses se produisent. Premièrement, les messages plus anciens sont poussés vers les bords, où le modèle leur prête moins d'attention de manière fiable — le classique problème du « perdu au milieu » (lost in the middle). Deuxièmement, la plupart des agents résument automatiquement lorsqu'ils manquent de place, et un résumé automatique réalisé sous pression est lacunaire : il peut omettre la contrainte précise qui vous importait. La solution consiste à garder le contrôle de ce que l'agent conserve, plutôt que de le laisser se remplir et improviser.

Surveillez le niveau de remplissage de la fenêtre

Vous ne pouvez pas gérer ce que vous ne voyez pas. Dans Claude Code, exécutez /context pour afficher l'utilisation actuelle en pourcentage. Une bonne règle empirique issue des praticiens consiste à agir aux alentours de 60 % d'utilisation sur une tâche complexe — bien avant le seuil d'environ 80 % où le compactage automatique se déclenche. Cursor et Codex affichent un indicateur similaire dans leurs interfaces. Jeter un œil à ce chiffre de temps en temps transforme la gestion du contexte d'une inquiétude vague en un signal concret.

Compactez aux points de contrôle — ne continuez pas simplement

Lorsque vous atteignez un point de contrôle naturel (une fonctionnalité marche, les tests passent, un bug est corrigé), compressez l'historique au lieu de le laisser grossir. Dans Claude Code, /compact remplace la transcription complète par un résumé généré par le modèle — une conversation de 70 000 tokens peut tomber à environ 4 000 tokens. Point crucial : vous pouvez orienter ce qui est conservé :

/compact "Keep the API contract and the DB schema we agreed on. Summarize the debugging session — I only need the root cause, not every step."

Compacter de manière proactive, tant qu'il reste de la marge, produit un meilleur résumé qu'un résumé automatique déclenché à la dernière seconde, car le modèle a encore une mémoire claire de l'ensemble de la conversation au moment où il rédige le résumé.

Effacez lorsque vous changez de tâche

/compact sert à poursuivre le même fil de travail. /clear sert à l'abandonner. Lorsque vous pivotez vers quelque chose de sans rapport — vous terminez une correction backend et passez à une fonctionnalité frontend — repartez de zéro. Reporter l'ancien contexte n'aide pas ; cela ne fait que gaspiller des tokens et risque de pousser l'agent à faire du pattern matching sur la tâche précédente. L'effacement est aussi le remède lorsque le contexte est « empoisonné » : le modèle s'est accroché à une hypothèse erronée et y revient sans cesse, quelle que soit la manière dont vous le corrigez.

Placez les connaissances stables dans un fichier, pas dans le chat

Si vous vous surprenez à réexpliquer les mêmes choses — votre commande de test, vos conventions de nommage, le répertoire où se trouve l'API — cette information n'a pas sa place dans la conversation. Placez-la dans un fichier de projet que l'agent lit automatiquement : CLAUDE.md pour Claude Code, AGENTS.md pour Codex et d'autres, .cursorrules pour Cursor. Il se charge au début de chaque session, de sorte que l'agent en dispose dès le premier message, et il survit à chaque /clear et /compact. Gardez-le concis, cependant — il coûte des tokens à chaque requête, si bien qu'un CLAUDE.md surchargé est sa propre forme de gaspillage de contexte.

Donnez-en moins à l'agent, pas plus

L'instinct qui consiste à déverser dix fichiers « pour qu'il ait tout » se retourne contre vous. Chaque fichier que vous collez ou mentionnez avec @ consomme du budget et dilue l'attention du modèle. Un seul fichier bien choisi vaut généralement mieux que dix. Commencez de manière minimale et n'ajoutez du contexte que lorsque l'agent en a réellement besoin. Si vous ne savez pas quel fichier importe, demandez d'abord à l'agent de le trouver plutôt que de précharger tout le répertoire.

Déléguez l'exploration désordonnée à un sous-agent

Certaines tâches sont intrinsèquement verbeuses — « cherche dans le codebase chaque endroit où nous appelons l'API de paiement ». Si vous exécutez cela dans votre session principale, la sortie brute de la recherche inonde votre fenêtre. À la place, déléguez-la à un sous-agent (l'outil Task de Claude Code, ou un agent Cursor distinct). Le sous-agent réalise l'exploration bruyante dans sa propre fenêtre isolée et ne vous renvoie que la conclusion — les trois fichiers qui comptent — ce qui garde votre contexte principal propre.

Un rythme de travail

Mis bout à bout, une longue session saine ressemble à ceci :

1. Commencez avec un CLAUDE.md concis pour que l'agent connaisse votre projet.
2. Cadrez chaque tâche de manière étroite ; ne référencez que les fichiers qu'elle touche.
3. Jetez un œil à /context toutes les 30 à 45 minutes ou après chaque jalon.
4. /compact avec une instruction personnalisée à chaque point de contrôle.
5. /clear dès l'instant où vous passez à un travail sans rapport.

Rien de tout cela n'est ésotérique. C'est la différence entre un agent qui reste affûté tout au long d'une session de deux heures et un agent qui démarre en force puis perd lentement le fil — et cela vous coûte quelques secondes d'attention plutôt qu'un mystérieux après-midi passé à démêler sa confusion.