# Idle compaction dans Claude Code : ce que ça fait, comment la couper

URL: https://agentvera.dev/fr/blog/claude-code-idle-compaction/ · Publié: 2026-11-06

Claude Code résume désormais les longues conversations laissées inactives une heure. Ce qui a changé de v2.1.299 à v2.1.318, comment la couper, et l’effet sur vos agents.

**En bref:**

- Depuis la v2.1.299 (14 octobre 2026), Claude Code résume une conversation de plus de 200K tokens restée inactive environ une heure, juste avant l’expiration de son cache d’une heure.
- Pour la couper : "idleCompaction": false dans settings.json ou la ligne Idle compaction de /config (v2.1.302+). DISABLE_AUTO_COMPACT=1 la coupe avec la compaction automatique.
- Chaque session parallèle a son propre cache et est compactée séparément : un agent qui attend votre réponse depuis une heure peut reprendre à partir d’un résumé.

Vous laissez une longue session Claude Code une heure, vous revenez et un message inconnu s’affiche : **« Compacted while idle, before the prompt cache expired. »** C’est l’idle compaction, la compaction en cas d’inactivité, une fonction lancée par Anthropic en octobre 2026 et enrichie dans presque chaque version depuis. Elle est activée par défaut, ce qui explique que beaucoup la découvrent avant d’en avoir entendu parler.

Cet article explique ce qu’elle fait, quand elle se déclenche, comment la régler ou la couper, et ce qu’elle change quand plusieurs agents tournent côte à côte.

## Ce qui a changé, et quand

Les dates sont celles de publication de chaque version sur npm ; les descriptions viennent du [changelog de Claude Code](https://code.claude.com/docs/en/changelog "Claude Code changelog").

| Version | Date | Changement |
| --- | --- | --- |
| 2.1.299 | 14 octobre 2026 | Idle compaction dans le terminal : une conversation de plus de 200K tokens inactive depuis environ 54 minutes est compactée avant l’expiration de son cache d’une heure. Ajout de `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` et du paramètre `idleCompaction`. |
| 2.1.302 | 16 octobre 2026 | Une ligne **Idle compaction** dans `/config` pour la couper ou la réactiver. L’avis affiché après une compaction indique désormais comment la désactiver. |
| 2.1.314 | 30 octobre 2026 | Idle compaction dans VS Code et dans l’onglet Code de l’app de bureau. Elle fonctionne aussi pour les abonnés avec télémétrie désactivée, ainsi que sur Bedrock, Vertex, Foundry et les passerelles LLM une fois le cache d’une heure activé. |
| 2.1.318 | 3 novembre 2026 | Corrigé : l’idle compaction pouvait remplacer la conversation par une réponse qui n’était pas un résumé. |

Si vous l’utilisez, passez à la 2.1.318 ou plus récente pour ce dernier correctif.

## Pourquoi Claude Code compacte pendant votre absence

Chaque message renvoie toute la conversation. Ce qui rend cela abordable, c’est le cache de prompts : l’API réutilise ce qu’elle a déjà traité. Mais le cache expire après une période d’inactivité. Si vous revenez après, votre message suivant retraite tout l’historique comme une entrée non mise en cache, ce qui est lent et coûteux pour une conversation de plus de 200K tokens.

Compacter coûte le moins cher tant que le cache est encore chaud, car la requête de résumé lit l’historique depuis le cache. L’idle compaction profite de cette fenêtre : peu avant l’expiration du cache d’une heure, Claude Code écrit le résumé. À votre retour, le message suivant repart de ce résumé court au lieu de tout reconstruire. La [documentation sur le cache de prompts](https://code.claude.com/docs/en/prompt-caching "How Claude Code uses prompt caching") détaille ce compromis.

## Quand l’idle compaction se déclenche

D’après la [référence des paramètres](https://code.claude.com/docs/en/settings-reference#idlecompaction "idleCompaction"), une conversation n’est concernée que si toutes ces conditions sont réunies :

- **Session :** une session interactive dans le terminal, le panneau de chat de l’extension VS Code ou l’onglet Code de l’app de bureau quand la session tourne sur votre machine ou via SSH.
- **Compaction automatique** (`autoCompactEnabled`) activée.
- **Cache de prompts :** la conversation utilise le TTL d’une heure.
- **Taille :** le contexte a atteint le seuil, 200 000 tokens par défaut.
- **Inactivité :** environ une heure s’est écoulée depuis la dernière requête, et l’ordinateur reste éveillé jusque-là.

La condition sur le cache compte plus qu’il n’y paraît. Par défaut, Claude Code ne demande le TTL d’une heure que pour la conversation principale, sur un abonnement Claude et dans les limites de votre forfait. Avec une clé d’API ou un fournisseur cloud, c’est cinq minutes par défaut : l’idle compaction ne tourne pas sauf si vous réglez `promptCacheTtl` sur `1h`. Si vous dépassez la limite du forfait et passez sur des crédits d’usage, la conversation principale redescend aussi à cinq minutes.

## Comment la couper

Au choix :

- **Fichier de paramètres :** ajoutez `"idleCompaction": false` à `~/.claude/settings.json`, ou au fichier de paramètres d’un projet pour la couper dans ce seul dépôt.
- **`/config` :** changez la ligne **Idle compaction**. Le choix est enregistré dans vos paramètres utilisateur et s’applique tout de suite (v2.1.302 ou plus récent).
- **Variable d’environnement :** `DISABLE_AUTO_COMPACT=1` coupe l’idle compaction en même temps que la compaction automatique. Le `/compact` manuel reste disponible.

```json
{
  "idleCompaction": false
}
```

Si `/config` n’affiche pas la ligne, une autre source de paramètres définit sans doute la clé : paramètres gérés, fichier de projet ou `--settings`. Modifiez-la là.

## Régler le seuil

`CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` fixe la taille à partir de laquelle l’idle compaction s’applique. Les valeurs sous 100 000 sont remontées à 100 000.

Un détail mérite d’être connu. Sur un modèle à fenêtre de 200K, la compaction automatique se déclenche avant que la conversation atteigne 200 000 tokens : avec le seuil par défaut, l’idle compaction touche donc surtout les sessions à 1M de contexte. Pour inclure les conversations à 200K, baissez-le :

```json
{
  "env": {
    "CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS": "150000"
  }
}
```

## Ce qui reste après une compaction

La compaction remplace l’historique par un résumé, mais tout ne disparaît pas. Le CLAUDE.md à la racine du projet et la mémoire automatique sont réinjectés depuis le disque, le plan du mode plan revient, et Claude Code relit jusqu’à cinq des fichiers qu’il a lus ou modifiés, les plus récemment modifiés d’abord. Les commandes et sous-agents en arrière-plan continuent de tourner. Ce qui part, c’est le détail : sorties exactes des outils, longs raisonnements, les allers-retours qui ont mené à une décision. Notre [guide de la fenêtre de contexte de Claude Code](/fr/blog/claude-code-context-window/ "Fenêtre de contexte de Claude Code") va plus loin.

La règle est simple. Si la tâche était terminée, l’idle compaction vous fait économiser et vous ne la remarquerez guère. Si vous vous êtes arrêté au milieu d’un travail délicat et voulez que Claude se souvienne de chaque étape, coupez-la pour ce projet ou revenez avant l’heure.

## Ce que ça change avec plusieurs agents

L’idle compaction a été pensée pour une personne qui quitte une session. Avec plusieurs agents en parallèle, le tableau change :

- **Chaque session est jugée seule.** Des sessions dans des dossiers différents construisent des préfixes de cache différents : des agents dans des worktrees git séparés ne partagent jamais de cache. Chacun qui dépasse le seuil et reste inactif environ une heure est compacté de son côté.
- **Un agent qui attend est un agent inactif.** Celui qui a fini son tour et attend votre relecture ou votre réponse à une question compte comme inactif. Quand vous arrivez au quatrième panneau après déjeuner, il travaille peut-être déjà à partir d’un résumé. Pour « c’est bon, on livre », aucun souci ; pour « reviens à l’approche que tu as écartée tout à l’heure », c’est moins idéal.
- **Les sous-agents et coéquipiers ne sont pas visés.** Ils sont par défaut dans le groupe de cache de cinq minutes. L’idle compaction concerne vos conversations principales.
- **Les exécutions headless ne sont pas concernées.** Les exécutions `-p` et les sessions Agent SDK sortent des conditions : les pipelines de nuit qui s’appuient dessus se comportent comme avant. Pour le travail interactif de nuit, voyez [lancer Claude Code la nuit en toute sécurité](/fr/blog/run-claude-code-overnight/ "Claude Code la nuit").
- **L’ordinateur doit rester éveillé.** S’il se met en veille, l’heure passe sans compaction et vous payez de nouveau une relecture sans cache.

Une configuration pratique : laisser l’idle compaction active par défaut, la couper dans le ou les dépôts où un agent vous attend souvent en pleine tâche, et répondre dans l’heure aux agents qui posent des questions.

## Où se place AgentVera

Nous développons AgentVera, une app de bureau pour macOS, Windows et Linux qui fait tourner Claude Code, Codex et 16 autres agents de code côte à côte, chacun dans un vrai terminal avec votre propre installation et votre compte. Plusieurs fonctions rejoignent l’idle compaction :

- **[Économie de tokens](/fr/features/token-savings/ "Économie de tokens")** : la compaction automatique est active par défaut pour chaque agent avec un seuil de 150K tokens, via la commande de compaction de chaque CLI, et chaque panneau affiche la taille du contexte en direct. Un message envoyé à un agent inactif depuis plus d’une heure compacte d’abord une grande conversation, y compris pour les agents sans idle compaction propre.
- **Notifications :** vous êtes prévenu quand un agent termine ou attend une saisie, donc moins d’agents patientent au-delà de l’heure.
- **Budgets de tokens et limites d’usage :** un plafond par agent et, dans la barre d’état, l’usage sur 5 heures et sur la semaine de chaque compte Claude et Codex.

Le forfait gratuit comprend jusqu’à 18 agents, MCP, Git, Docker, SSH et la revue de code. Pour une comparaison plus large, voyez [Claude Code et Codex en parallèle : meilleures apps](/fr/blog/best-tools-parallel-ai-coding-agents/ "Claude Code et Codex en parallèle").

## En résumé

L’idle compaction est un petit réglage par défaut au but clair : résumer une longue conversation tant que le cache est chaud, pour que votre retour ne coûte pas une relecture complète sans cache. Elle exige une session interactive, le cache d’une heure et un contexte assez grand. Vous pouvez baisser le seuil avec `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` ou la couper avec `"idleCompaction": false` ou `/config`. Quand plusieurs agents vous attendent en même temps, décidez projet par projet si un résumé suffit, et répondez d’abord à ceux qui ont besoin de tout le contexte.

Sources : [changelog de Claude Code](https://code.claude.com/docs/en/changelog "Claude Code changelog"), [idleCompaction dans la référence des paramètres](https://code.claude.com/docs/en/settings-reference#idlecompaction "idleCompaction"), [How Claude Code uses prompt caching](https://code.claude.com/docs/en/prompt-caching "Prompt caching") et [Explore the context window](https://code.claude.com/docs/en/context-window "Context window").

## Questions fréquentes

**Qu’est-ce que l’idle compaction dans Claude Code ?** Une longue conversation que vous avez laissée de côté est résumée peu avant l’expiration de son cache de prompts d’une heure. Votre message suivant envoie ce résumé au lieu de tout l’historique, qui serait sinon retraité sans cache.

**Comment désactiver l’idle compaction ?** Mettez "idleCompaction": false dans un fichier de paramètres ou changez la ligne Idle compaction dans /config (Claude Code v2.1.302 ou plus récent). DISABLE_AUTO_COMPACT=1 la désactive aussi, en même temps que la compaction automatique.

**Pourquoi ma conversation a-t-elle été compactée sans que je lance /compact ?** Si le terminal affiche une ligne commençant par « Compacted while idle, before the prompt cache expired », c’est l’idle compaction. Dans VS Code et l’app de bureau, l’avis mentionne « a summary written while you were away ».

**Fonctionne-t-elle avec une clé d’API ou en mode -p ?** Il faut une session interactive (terminal, panneau de chat de VS Code ou onglet Code de l’app de bureau) avec le cache d’une heure. Avec une clé d’API, la conversation principale utilise par défaut le cache de cinq minutes sauf si vous réglez promptCacheTtl sur 1h, et les exécutions -p ne sont pas concernées.

**Est-ce que ça touche plusieurs agents lancés en parallèle ?** Chaque session est évaluée séparément. Les agents dans des dossiers ou des worktrees différents ont des caches distincts : chacun qui dépasse le seuil et reste inactif environ une heure est compacté indépendamment.

---

**À propos d’AgentVera.** AgentVera est une app de bureau pour macOS, Windows et Linux, développée par Solviera Teknoloji. Elle exécute 18 agents de code IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) côte à côte, par projet, dans de vrais terminaux avec les installations et connexions CLI de l’utilisateur. L’offre gratuite inclut des agents illimités. Télécharger: https://agentvera.dev/fr/download/ · Tarifs: https://agentvera.dev/fr/pricing/