Glossaire Claude Code

Compaction

La compaction résume les conversations pour libérer de l'espace dans la fenêtre de contexte, automatiquement ou sur commande.

Aussi appelé : auto-compact, /compact, context compaction, conversation summarized

La compaction se produit lorsque la fenêtre de contexte se remplit : la conversation est résumée pour libérer de l'espace. La auto-compaction se déclenche automatiquement ; /compact la déclenche manuellement. Ce qui survit est plus important que ce que la plupart des gens réalisent.

Vérifié : la auto-compaction conserve les INVOKED SKILLS dans la limite de jetons — lorsque la conversation est résumée, Claude Code rattache l'invocation la plus récente de chaque compétence après le résumé, en conservant les 5 000 premiers jetons de chacune. Les compétences rattachées partagent un budget combiné de 25 000 jetons, rempli en commençant par la compétence la plus récemment invoquée, de sorte que les anciennes compétences peuvent être complètement supprimées après la compaction si vous en avez invoqué plusieurs au cours d'une session.

Le CLAUDE.md à la racine du projet survit également : après /compact, Claude le relit depuis le disque et le réinjecte. Les fichiers CLAUDE.md imbriqués dans des sous-répertoires ne sont PAS réinjectés automatiquement ; ils se rechargent la prochaine fois que Claude lit un fichier dans ce sous-répertoire. Donc, si une instruction a disparu après la compaction, elle a été donnée uniquement en conversation ou se trouve dans un CLAUDE.md imbriqué qui ne s'est pas rechargé. Les événements PreCompact et PostCompact se déclenchent autour de cela.

Conséquence pratique : une longue session qui a invoqué une douzaine de compétences n'aura pas les douze en contexte par la suite. Ce processus est lié à la gestion de la context-window et peut être influencé par des techniques de progressive-disclosure. Des compétences comme Compact Guard peuvent aider à gérer l'état entre les événements de compaction.

← Tous les termes du glossaire