Blog

La fenêtre de contexte de Claude Code, et ce qui survit à une compaction

Par , formateur IA & Claude Code ·

Une session de Claude Code n’arrive pas vide. Le fichier CLAUDE.md, la mémoire automatique, les noms des outils MCP et les descriptions des skills y sont déjà. Avant votre première frappe.

Ensuite, chaque fichier lu s’ajoute. Et quand la fenêtre approche de sa limite, Claude Code la compacte, tout seul.

Ce qui se passe à ce moment décide de ce que votre session sait encore. La documentation d’Anthropic le détaille, et le tableau mérite d’être connu avant de le découvrir en pleine tâche.

Ce qui est chargé au départ

Quatre choses, d’après la documentation. Le CLAUDE.md, la mémoire automatique, les noms des outils MCP, les descriptions des skills. Les fichiers AGENTS.md peuvent s’y ajouter.

Pendant le travail, trois mécanismes alimentent la fenêtre. Chaque fichier lu. Les règles par chemin, chargées avec les fichiers qui leur correspondent. Et les hooks, ces automatismes qui se déclenchent après chaque modification.

Un mot sur les chiffres. La page d’Anthropic contient une simulation avec des valeurs en jetons. Elle précise elle-même qu’il s’agit de nombres représentatifs. Ce ne sont pas des mesures, et je ne reprends aucun chiffre de cette simulation.

Ce que fait une compaction

Une compaction remplace la conversation par un résumé structuré. Et elle tombe au milieu d’une tâche, jamais entre deux.

La documentation le dit noir sur blanc. Claude Code compacte automatiquement à l’approche de la limite, donc une fenêtre pleine n’arrête pas votre session. Le seuil dépend de votre modèle et de votre configuration.

Ce qui survit, et ce qui passe au résumé

C’est le tableau qui compte. Le voici.

Continuent de s’appliquer. Le prompt système et le style de sortie.

Rechargés depuis le disque, comme au démarrage. Le CLAUDE.md de la racine du projet et les règles sans portée. La mémoire automatique. Le plan écrit en mode plan.

Relus. L’état Git, que Claude Code relit directement dans votre dépôt. Et jusqu’à cinq fichiers que Claude avait lus ou modifiés, les plus récemment modifiés d’abord.

Rechargés plus tard, à la demande. Les règles à en-tête paths, l’en-tête étant les quelques lignes du haut du fichier. Et les CLAUDE.md des sous-dossiers. Ils reviennent quand Claude relit un fichier qui les déclenche.

Résumés avec le reste. Le contexte que des hooks avaient ajouté plus tôt.

Perdue. La liste des descriptions de skills, chargée au démarrage, ne revient pas. Seuls les skills que vous avez invoqués sont conservés.

Continuent de tourner. Les commandes et les sous-agents lancés en arrière-plan. Claude Code rappelle à Claude lesquels sont encore en cours.

Rejoués. Les hooks SessionStart réglés sur la source compact. Claude Code les exécute et ajoute leur sortie au contexte compacté. C’est la seule ligne du tableau sur laquelle vous pouvez agir.

Il y a un détail à connaître sur les fichiers relus. Un fichier de plus de 5 000 jetons revient comme une référence de chemin, sans son contenu.

Formation en entreprise · finançable OPCO

Ce que ça donne quand une équipe s'y met vraiment

Animée par Fathi Sehla, qui construit des agents Claude Code et des automatisations n8n en production. Il anime lui-même les sessions. Sur Malt, 4,7/5, moyenne de 8 avis, pour 14 projets.

  • 1 000 € HT la journée, quel que soit le nombre de participants
  • Finançable par votre OPCO, souvent jusqu'à 100 %. Dossier et convention portés par Alfie Formation, organisme certifié Qualiopi
  • Chez Digital.Green, une équipe qui ne savait pas encore tirer pleinement parti de l'IA, formée en neuf jours. Deux workflows d'audit tournent encore

Une question avant de vous engager ? Appelez, c'est le plus rapide : 07 43 44 61 22.

Ce que la compaction fait à une règle par chemin

Une règle à en-tête paths entre dans l’historique des messages au moment où son fichier déclencheur est lu. Donc la compaction la résume avec le reste de la conversation.

La documentation donne le remède dans la même phrase. Pour qu’une règle survive à une compaction, on retire son en-tête paths. Ou on la déplace à la racine.

C’est un arbitrage réel pour une équipe. Une règle par chemin économise du contexte au démarrage et ne survit pas au résumé. Une règle à la racine coûte du contexte à chaque session et tient.

Les skills, et un conseil de rédaction qui en découle

Le corps des skills invoqués est réinjecté après une compaction. Avec deux plafonds : 5 000 jetons par skill, 25 000 au total, les plus anciens abandonnés en premier.

Et la troncature garde le début du fichier.

D’où le conseil que la documentation en tire, et qui change la façon d’écrire un skill. Les instructions les plus importantes vont en haut du SKILL.md.

Les cinq gestes pour reprendre la main

La documentation les liste, du plus fin au plus radical.

Compacter avec une consigne. /compact suivi d’une instruction, par exemple pour garder ce qui touche à un bogue précis. Le résumé garde ce que vous choisissez au lieu de ce que la passe automatique devine.

Compacter une partie de la conversation. /rewind, puis choisir un message et résumer à partir de là ou jusque-là.

Compacter plus tôt. /autocompact avec un nombre de jetons, pour décider à quel remplissage la passe automatique se déclenche.

Vider entre deux tâches. /clear en changeant de sujet. La documentation en donne la raison. Une vieille conversation chasse les fichiers dont vous avez besoin ensuite. Et elle coûte des jetons à chaque message.

Déléguer les grosses lectures. Envoyer la recherche à un sous-agent, pour que le contenu des fichiers reste dans sa fenêtre. Le mécanisme est détaillé dans les sous-agents de Claude Code.

Comment regarder sa propre session

/context donne la répartition en direct par catégorie. Il donne aussi des suggestions d’optimisation, et la liste des fichiers CLAUDE.md et de mémoire chargés.

C’est la première chose à faire quand une équipe se demande où part son contexte.

Ce que ça change pour une équipe

Deux décisions sortent de ce tableau, et aucune n’est technique.

Où vivent vos règles. Racine ou portée par chemin, selon qu’elles doivent survivre à une compaction. La logique complète est dans le fichier CLAUDE.md.

Quand on vide. Une équipe qui enchaîne trois sujets dans la même session paie le premier sur les deux suivants.

Le cadre général, pourquoi le contexte se choisit au lieu de se remplir, est dans context engineering.

C’est ce qu’on règle pendant la formation Claude Code, sur vos dépôts, avec /context ouvert.

Source relevée le 29 septembre 2026, la documentation de la fenêtre de contexte d’Anthropic.

FAQ

Questions fréquentes

Qu'y a-t-il dans la fenêtre de contexte avant ma première frappe ?

Quatre choses, d'après la documentation d'Anthropic. Le fichier CLAUDE.md, la mémoire automatique, les noms des outils MCP et les descriptions des skills. Les fichiers AGENTS.md peuvent s'y ajouter. Relevé le 29 septembre 2026.

Que fait la commande /compact dans Claude Code ?

Elle remplace la conversation par un résumé structuré. La documentation précise que Claude Code compacte aussi tout seul à l'approche de la limite. Une fenêtre pleine n'arrête donc pas votre session.

Qu'est-ce qui survit à une compaction dans Claude Code ?

Trois choses sont rechargées depuis le disque, d'après la documentation d'Anthropic relevée le 29 septembre 2026. Le CLAUDE.md de la racine, la mémoire automatique et le plan du mode plan. Le prompt système et le style de sortie, eux, continuent de s'appliquer. Claude Code relit aussi jusqu'à cinq fichiers.

Qu'est-ce qui ne survit pas à une compaction dans Claude Code ?

Les règles à en-tête paths et les CLAUDE.md des sous-dossiers entrent dans l'historique des messages. La compaction les résume donc. La liste des descriptions de skills, elle, ne revient pas. Documentation d'Anthropic relevée le 29 septembre 2026.

Comment voir ce que consomme la fenêtre de contexte de Claude Code ?

En lançant /context. La documentation le présente comme la façon d'obtenir une répartition en direct par catégorie. La commande donne aussi des suggestions d'optimisation, et la liste des fichiers CLAUDE.md et de mémoire chargés.

Comment libérer du contexte dans Claude Code sans perdre le fil ?

La documentation donne cinq gestes. Compacter avec une consigne. Compacter une partie de la conversation avec /rewind. Compacter plus tôt avec /autocompact. Lancer /clear entre deux sujets. Déléguer les grosses lectures à un sous-agent.

Un skill est-il réinjecté après une compaction ?

Le corps des skills invoqués l'est. Le plafond est de 5 000 jetons par skill et de 25 000 au total. Les skills invoqués le plus anciennement sont abandonnés en premier. La troncature garde le début du fichier. Documentation d'Anthropic relevée le 29 septembre 2026.

Parlons de votre équipe

On regarde ensemble ce que votre équipe peut déléguer ?

L'audit de cadrage est offert. On identifie vos cas d'usage et on priorise ce qui vaut le coup, puis je bâtis le programme dessus. Devis sous 48 h ouvrées.

C'est moi qui réponds. Et si je n'ai rien à vous apporter, je vous le dis.

Par écrit : contact@formation-ia-claude.fr