La compaction après inactivité (idle compaction) est une fonction de Claude Code arrivée avec la v2.1.299. Quand une conversation de plus de 200 000 tokens reste sans activité pendant environ 54 minutes dans le terminal, Claude Code la résume juste avant que son cache de prompt d’une heure expire. Ton message suivant envoie ce résumé au lieu de tout l’historique, et tu évites de faire retraiter la session entière à ton retour. Elle est active par défaut et se coupe avec "idleCompaction": false dans settings.json.

Pourquoi reprendre une longue session après une pause coûtait cher ?

Le modèle ne garde rien d’une requête à l’autre. À chaque message, Claude Code renvoie donc tout le contexte, des instructions système jusqu’au dernier résultat d’outil. Le cache de prompt évite de tout retraiter : l’API relit la partie déjà vue au tarif réduit et ne traite en entier que ce qui a changé.

Ce cache expire après une période sans requête. Si tu pars déjeuner au milieu d’une session de 300 000 tokens, ton premier message au retour recalcule toute l’entrée sans cache, et ce tour est nettement plus lent.

Lancer /compact à ce moment-là ne sauve pas grand-chose. Le résumé est produit par une requête qui contient tout l’historique. Tant que le cache est chaud, elle le relit depuis le cache pour une fraction du prix. Une fois le cache expiré, elle retraite tout au prix plein. La doc le dit sans détour : /compact coûte le plus cher quand tu reprends une vieille session.

Que fait la compaction après inactivité ?

Elle lance la compaction vers 54 minutes d’inactivité, juste avant la fin du cache d’une heure, pendant qu’il est encore chaud. À ton retour, la conversation affiche Compacted while idle, before the prompt cache expired et ta prochaine requête part avec le résumé.

Toutes ces conditions doivent être réunies :

  • tu es dans une session interactive du terminal ;
  • la conversation utilise le cache d’une heure ;
  • le contexte a atteint le seuil, 200 000 tokens par défaut ;
  • environ 54 minutes se sont écoulées depuis la dernière requête, et ton ordinateur n’est pas en veille à ce moment-là ;
  • Claude Code arrive à récupérer auprès d’Anthropic les options qui activent certaines fonctions.

Pourquoi ça dépend du cache d’une heure ?

L’API propose deux durées de vie pour le cache : 5 minutes et 1 heure. D’après la doc tarifaire de l’API, une écriture dans le cache d’une heure coûte 2 fois le prix d’entrée de base, contre 1,25 fois pour celui de 5 minutes.

Par défaut, Claude Code ne demande le cache d’une heure que sur un abonnement Claude, dans l’usage inclus de ton forfait, et pour la conversation principale (plus quelques requêtes annexes). Avec une clé API, un fournisseur cloud ou des crédits d’usage (y compris quand tu dépasses ton forfait), la conversation principale passe à 5 minutes et la compaction après inactivité ne se déclenche pas.

Si tu utilises une clé API et que tu laisses souvent des sessions ouvertes pendant de longues pauses, tu peux demander le cache d’une heure pour la conversation principale avec la clé promptCacheTtl (v2.1.242 minimum) :

{
  "promptCacheTtl": "1h"
}

Pour une seule session, CLAUDE_CODE_PROMPT_CACHE_TTL=1h fait la même chose.

La ligne Prompt cache (main) de /usage t’indique si le cache est chaud et quelle durée s’applique.

Comment régler ou couper la compaction après inactivité ?

Pour la couper, ajoute cette clé dans settings.json. Elle est reconnue depuis la v2.1.290 :

{
  "idleCompaction": false
}

Pour changer le seuil, utilise CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS. Une valeur sous 100 000 est remontée à 100 000. La doc donne cet exemple pour une fenêtre de 200K, où la compaction automatique classique passe avant que la conversation atteigne 200 000 tokens :

{
  "env": {
    "CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS": "150000"
  }
}

DISABLE_AUTO_COMPACT=1 coupe à la fois la compaction automatique classique et la compaction après inactivité. /compact reste utilisable à la main.

Quand vaut-il mieux la désactiver ?

Ce que le résumé laisse de côté sort du contexte de Claude. Quand je laisse une session en plein débogage, avec une trace d’erreur précise et des pistes déjà écartées, je préfère retrouver la conversation complète et payer le retraitement une fois. Pour ce genre de projet, mets "idleCompaction": false dans le .claude/settings.json du projet.

Elle ne se déclenche pas non plus sur un fournisseur tiers comme Amazon Bedrock, Google Cloud ou Microsoft Foundry, ni quand tu as défini DISABLE_TELEMETRY ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, car Claude Code ne récupère alors pas les options dont elle dépend.

Quand préférer /compact ou /clear à la main ?

La compaction après inactivité rattrape la pause que tu n’avais pas prévue. Si tu sais que tu t’arrêtes, compacte toi-même avant de partir, pendant que le cache est chaud, et dis ce qu’il faut garder :

/compact garde les décisions sur le schéma de la base et la liste des fichiers modifiés

Si la tâche est terminée, /clear suffit : la suivante démarre avec un contexte propre et il n’y a rien à résumer. Pour une vieille session rouverte avec --resume, Claude Code propose déjà sur Pro et Max de repartir d’un résumé quand elle dépasse 100 000 tokens et environ une heure d’inactivité.

Pour aller plus loin

Le module 7 de la formation, Optimisation & Workflow pro, détaille la gestion du contexte au quotidien, du réflexe /clear entre deux tâches jusqu’à l’usage de /compact avec des consignes.