Explorez la fenêtre de contexte
Une simulation interactive de la façon dont la fenêtre de contexte de Claude Code se remplit pendant une session. Voyez ce qui se charge automatiquement, ce que coûte chaque lecture de fichier, et quand les règles et les hooks s'exécutent.
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 vous montre ce qui se charge et quand. 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 :
/compactremplace 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écanisme | Après compaction |
|---|---|
| Invite système et style de sortie | Inchangé ; ne fait pas partie de l'historique des messages |
| CLAUDE.md à la racine du projet et règles sans portée | Réinjectés depuis le disque |
| Mémoire automatique | Ré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épertoires | Perdu jusqu'à ce qu'un fichier de ce sous-répertoire soit lu à nouveau |
| Corps de compétences invoqués | Réinjectés, limités à 5 000 jetons par compétence et 25 000 jetons au total ; les plus anciens sont supprimés en premier |
| Hooks | Non 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.
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.
Ressources connexes
Pour une couverture plus approfondie des fonctionnalités présentées dans la chronologie, consultez ces pages :
- Étendre Claude Code : quand utiliser CLAUDE.md par rapport aux compétences par rapport aux règles par rapport aux hooks par rapport à MCP
- Stocker les instructions et les mémoires : hiérarchie CLAUDE.md et mémoire automatique
- Sous-agents : déléguer la recherche à une fenêtre de contexte séparée
- Meilleures pratiques : gérer le contexte comme votre contrainte principale
- Mise en cache des invites : quelles actions invalident le préfixe mis en cache
- Réduire l'utilisation des jetons : stratégies pour maintenir l'utilisation du contexte faible