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 sans détour : 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. La croyance la plus répandue traite ce seuil comme un mur dur, alors qu'il fonctionne comme un signal de départ pour un résumé, lui même borné par une limite qu'il ne contrôle pas.

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.

Ce qu'il reste à retenir

Deux conséquences pratiques découlent de ces deux mécanismes. D'abord, un seuil personnalisé plus haut que la fenêtre du modèle ne sert à rien, il faut vérifier la fenêtre réelle du modèle en cours avant de régler quoi que ce soit. Ensuite, une session qui affiche une erreur de thrashing signale un problème de contenu, pas un défaut du logiciel : le bon réflexe est de retirer 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.