Accueil / Contexte et coût

Le seuil d'auto-compactage ne fait pas ce qu'on croit

Le seuil d'auto-compactage déclenche un résumé de la conversation quand le contexte l'atteint, ce n'est pas un mur qui ferme la fenêtre : une valeur réglée au-dessus de la fenêtre réelle du modèle actif est plafonnée à cette fenêtre, un comportement documenté dont l'absence d'avertissement à l'écran reste à vérifier soi-même.

Le seuil d'auto-compactage n'est pas une clôture qui empêcherait le contexte de dépasser une taille donnée. C'est un point de déclenchement : quand la conversation atteint ce seuil, Claude Code lance un résumé automatique de l'historique. Rien dans ce mécanisme ne referme la fenêtre elle-même, et une valeur de seuil réglée au-dessus de la fenêtre réelle du modèle actif ne produit aucune erreur affichée : elle est simplement plafonnée à cette fenêtre.

Le plafond, sans garantie d'avertissement

La documentation officielle le formule ainsi : la limite retenue reste toujours celle du modèle, quelle que soit la valeur de seuil configurée par ailleurs. Régler un seuil à un million de jetons pendant que le modèle actif ne dispose que d'une fenêtre de deux cent mille jetons ne repousse rien, le calcul retombe sur les deux cent mille jetons réels. La documentation ne dit pas explicitement si ce plafonnement s'accompagne ou non d'un avertissement à l'écran, elle documente seulement le plafonnement lui-même : le vérifier sur votre propre poste vaut mieux que le supposer silencieux.

Quand le résumé boucle sur lui-même

Un second mécanisme complique le tableau. Après une compaction, si le contexte se remplit de nouveau jusqu'à la limite presque immédiatement, et que ce cycle se répète plusieurs fois de suite, Claude Code arrête de relancer la compaction et affiche une erreur explicite plutôt que de continuer à boucler.

Autocompact is thrashing: the context refilled to the limit...

Ce début de message, la documentation elle-même le cite avant de couper sur des points de suspension, signale un garde anti-thrashing, un dispositif qui reconnaît qu'un résumé après l'autre ne résout rien tant que la source du remplissage, un gros fichier relu à chaque appel d'outil par exemple, reste dans la conversation. Le garde s'arrête après quelques tentatives et remonte cette erreur plutôt que de continuer à boucler sans le dire.

Une compaction que vous n'avez pas lancée

Depuis octobre, une conversation longue laissée inactive dans le terminal peut être compactée peu avant l'expiration du cache d'une heure, pour que le message suivant ne retraite pas toute la conversation. La page de documentation sur le cache l'indique et donne le réglage idleCompaction pour la couper, et les avis affichés après une telle compaction disent comment faire. Une gêne ressentie comme « la fenêtre de contexte » peut donc être cette compaction : relevez à chaque fois si elle était manuelle, à saturation ou au repos avant de toucher un seuil. La figure donne le délai et la taille relevés au journal.

Deux autres changements concernent le seuil lui-même. Le réglage /autocompact est enregistré par modèle, chaque modèle garde donc le sien quand vous en changez. La variable CLAUDE_CODE_AUTO_COMPACT_WINDOW accepte les suffixes k et M : la valeur 200k fixait auparavant en silence une fenêtre moitié moindre, et la variable avertit désormais d'une valeur hors plage ou ignorée.

Que faire de ces deux mécanismes

Un seuil personnalisé plus haut que la fenêtre du modèle ne sert à rien : vérifiez la fenêtre réelle du modèle en cours avant de régler quoi que ce soit. Une session qui affiche une erreur de thrashing signale un problème de contenu, pas un défaut du logiciel : retirez ce qui remplit le contexte plutôt que de relancer la même action en espérant un résultat différent. La leçon voisine sur compacter, effacer, lire juste ce qu'il faut détaille comment choisir entre ces deux commandes une fois ce seuil compris.