Passer au contenu principal
La fenêtre de contexte de Claude Code contient tout ce que Claude sait sur votre session : vos instructions, les fichiers qu’il lit, ses propres réponses, et le contenu qui n’apparaît jamais dans votre terminal. La chronologie ci-dessous joue une session complète du démarrage à la compaction : ce qui se charge avant que vous ne tapiez, ce que chaque lecture de fichier, règle et hook ajoute pendant que Claude travaille, et comment un sous-agent garde les lectures volumineuses en dehors de votre contexte. Consultez la description écrite pour le même contenu sous forme de liste.

Ce que la chronologie montre

La session parcourt un flux réaliste avec des comptages de jetons représentatifs :
  • Avant que vous ne tapiez quoi que ce soit : CLAUDE.md, la mémoire automatique, les noms d’outils MCP, et les descriptions de compétences se chargent tous dans le contexte. Votre propre configuration peut ajouter plus ici, comme un style de sortie ou du texte provenant de --append-system-prompt, qui vont tous deux dans l’invite système de la même manière.
  • Pendant que Claude travaille : chaque lecture de fichier s’ajoute au contexte, les règles délimitées par chemin se chargent automatiquement aux côtés des fichiers correspondants, et un hook PostToolUse s’exécute après chaque modification.
  • L’invite de suivi : un sous-agent gère la recherche dans sa propre fenêtre de contexte séparée, de sorte que les lectures de fichiers volumineux restent en dehors de la vôtre. Seul le résumé et une petite remorque de métadonnées reviennent.
  • À la fin : /compact remplace la conversation par un résumé structuré. La plupart du contenu de démarrage se recharge automatiquement ; le tableau ci-dessous montre ce qui se passe pour chaque mécanisme.

Ce qui survit à la compaction

Quand une longue session se compacte, Claude Code résume l’historique de la conversation pour l’adapter à la fenêtre de contexte. Ce qui arrive à vos instructions dépend de la façon dont elles ont été chargées :
MécanismeAprès compaction
Invite système et style de sortieInchangé ; ne fait pas partie de l’historique des messages
CLAUDE.md à la racine du projet et règles sans portéeRéinjectés depuis le disque
Mémoire automatiqueRéinjectés depuis le disque
Règles avec frontmatter paths:Perdues jusqu’à ce qu’un fichier correspondant soit lu à nouveau
CLAUDE.md imbriqué dans les sous-répertoiresPerdu jusqu’à ce qu’un fichier de ce sous-répertoire soit lu à nouveau
Corps de compétences invoquésRéinjectés, limités à 5 000 jetons par compétence et 25 000 jetons au total ; les plus anciens sont supprimés en premier
HooksNon applicable ; les hooks s’exécutent en tant que code, pas en tant que contexte
Les règles délimitées par chemin et les fichiers CLAUDE.md imbriqués se chargent dans l’historique des messages quand leur fichier déclencheur est lu, de sorte que la compaction les résume avec tout le reste. Ils se rechargent la prochaine fois que Claude lit un fichier correspondant. Si une règle doit persister à travers la compaction, supprimez le frontmatter paths: ou déplacez-le vers le CLAUDE.md à la racine du projet. Les corps de compétences sont réinjectés après compaction, mais les grandes compétences sont tronquées pour s’adapter au plafond par compétence, et les compétences invoquées les plus anciennes sont supprimées une fois le budget total dépassé. La troncature conserve le début du fichier, donc mettez les instructions les plus importantes près du haut de SKILL.md.

Quand votre contexte se remplit

Claude Code se compacte automatiquement à mesure que vous approchez de la limite, de sorte qu’une fenêtre de contexte complète ne termine pas votre session. La passe automatique fonctionne de la même manière que l’étape /compact dans la chronologie. Consultez Quand le contexte se remplit pour voir ce qu’elle préserve. Vous pouvez également agir avant que la passe automatique ne s’exécute :
  • Compacter avec un focus : exécutez /compact avec des instructions, comme /compact focus on the auth bug fix, avant de commencer une longue nouvelle tâche. Le résumé conserve ce que vous choisissez au lieu de ce que la passe automatique devine être important.
  • Effacer entre les tâches : exécutez /clear quand vous passez à un travail non lié. L’ancienne conversation encombre les fichiers dont vous avez besoin ensuite et coûte des jetons à chaque message.
  • Déléguer les lectures volumineuses : envoyez la recherche à un sous-agent de sorte que le contenu du fichier reste dans sa fenêtre de contexte, pas dans la vôtre.
Si vous avez besoin d’une fenêtre plus grande plutôt qu’une conversation plus petite, Fable 5, Sonnet 5, Opus 4.6 et versions ultérieures, et Sonnet 4.6 supportent une fenêtre de contexte de 1 million de jetons. Consultez Contexte étendu pour la disponibilité par plan et comment sélectionner une variante de modèle [1m]. Sonnet 5 s’exécute à 1M sans variante [1m] à sélectionner ; consultez Fenêtre de contexte Sonnet 5 pour ses seuils de compaction automatique et l’exception de la passerelle LLM. La compaction fonctionne de la même manière à la limite plus grande.

Vérifiez votre propre session

La visualisation utilise des nombres représentatifs. Pour voir votre utilisation réelle du contexte à tout moment, exécutez /context pour une ventilation en direct par catégorie avec des suggestions d’optimisation. Exécutez /memory pour vérifier quels fichiers CLAUDE.md et de mémoire automatique se sont chargés au démarrage. Pour une couverture plus approfondie des fonctionnalités présentées dans la chronologie, consultez ces pages :