Claude Code Idle Compaction: was es macht und wie man es abschaltet

Sie lassen eine lange Claude-Code-Sitzung eine Stunde liegen, kommen zurück und sehen einen Hinweis, den Sie noch nie gesehen haben: „Compacted while idle, before the prompt cache expired.“ Das ist Idle Compaction, eine Funktion, die Anthropic im Oktober 2026 eingeführt und seitdem in fast jeder Version erweitert hat. Sie ist standardmäßig aktiv, deshalb begegnen ihr viele, bevor sie davon lesen.

Dieser Artikel erklärt, was Idle Compaction tut, wann sie läuft, wie man sie anpasst oder abschaltet und was sie ändert, wenn mehrere Agenten nebeneinander arbeiten.

Was sich geändert hat und wann

Die Daten sind die npm-Veröffentlichungsdaten der jeweiligen Version, die Beschreibungen stammen aus dem Claude-Code-Changelog.

Wer Idle Compaction nutzt, sollte wegen dieser Korrektur auf 2.1.318 oder neuer aktualisieren.

Warum Claude Code komprimiert, während Sie weg sind

Jede Nachricht schickt die ganze Unterhaltung erneut. Günstig bleibt das nur dank Prompt-Caching: Die API verwendet wieder, was sie schon verarbeitet hat. Der Cache läuft aber nach einer Zeit ohne Aktivität ab. Kommen Sie danach zurück, verarbeitet Ihre nächste Nachricht den kompletten Verlauf als ungecachte Eingabe, bei 200K+ Tokens langsam und teuer.

Am günstigsten ist eine Komprimierung, solange der Cache noch warm ist, denn die Zusammenfassungsanfrage liest den Verlauf aus dem Cache. Genau dieses Fenster nutzt Idle Compaction: Kurz bevor der einstündige Cache abläuft, schreibt Claude Code die Zusammenfassung. Wenn Sie zurückkommen, startet Ihre nächste Nachricht von der kurzen Zusammenfassung, statt die ganze Unterhaltung neu aufzubauen. Die Dokumentation zum Prompt-Caching erklärt die Abwägung im Detail.

Wann Idle Compaction läuft

Laut Einstellungsreferenz müssen alle diese Bedingungen erfüllt sein:

• Sitzung: eine interaktive Terminal-Sitzung, das Chat-Panel der VS-Code-Erweiterung oder der Code-Tab der Desktop-App, wenn die Sitzung auf Ihrem Rechner oder über SSH läuft.
• Auto-Compact (autoCompactEnabled) ist an.
• Prompt-Cache: Die Unterhaltung läuft mit einstündiger TTL.
• Größe: Der Kontext hat die Schwelle erreicht, standardmäßig 200.000 Tokens.
• Ruhezeit: Seit der letzten Anfrage ist etwa eine Stunde vergangen, und der Rechner bleibt bis dahin wach.

Die Cache-Bedingung ist wichtiger, als sie aussieht. Claude Code fordert die einstündige TTL standardmäßig nur für die Hauptunterhaltung in einem Claude-Abo an, solange Sie im Rahmen Ihres Plans bleiben. Mit API-Schlüssel oder Cloud-Anbieter sind es standardmäßig fünf Minuten, Idle Compaction läuft dann nur, wenn Sie promptCacheTtl auf 1h setzen. Überschreiten Sie das Planlimit und nutzen Nutzungsguthaben, fällt die Hauptunterhaltung ebenfalls auf fünf Minuten zurück.

So schalten Sie es ab

Eine der drei Varianten genügt:

• Einstellungsdatei: "idleCompaction": false in ~/.claude/settings.json eintragen oder in die Einstellungsdatei eines Projekts, um es nur für dieses Repository abzuschalten.
• /config: die Zeile Idle compaction umstellen. Das wird in Ihren Benutzereinstellungen gespeichert und gilt sofort (ab v2.1.302).
• Umgebungsvariable: DISABLE_AUTO_COMPACT=1 schaltet Idle Compaction zusammen mit der automatischen Komprimierung ab. Manuelles /compact funktioniert weiter.

{
  "idleCompaction": false
}

Fehlt die Zeile in /config, setzt vermutlich eine andere Einstellungsquelle den Schlüssel, etwa verwaltete Einstellungen, eine Projektdatei oder --settings. Ändern Sie ihn dort.

Die Schwelle anpassen

CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS legt fest, wie groß eine Unterhaltung sein muss, bevor Idle Compaction greift. Werte unter 100.000 werden auf 100.000 angehoben.

Ein Detail lohnt sich: Bei einem Modell mit 200K-Kontextfenster läuft Auto-Compact, bevor die Unterhaltung 200.000 Tokens erreicht. Mit der Standardschwelle betrifft Idle Compaction also vor allem Sitzungen mit 1M-Kontext. Damit auch Unterhaltungen mit 200K-Fenster erfasst werden, senken Sie die Schwelle:

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

Was nach einer Komprimierung bleibt

Eine Komprimierung ersetzt den Nachrichtenverlauf durch eine Zusammenfassung, aber nicht alles geht verloren. Die CLAUDE.md im Projektstamm und Auto Memory werden von der Festplatte neu eingespielt, der Plan aus dem Plan-Modus kommt zurück, und Claude Code liest bis zu fünf der gelesenen oder bearbeiteten Dateien neu ein, die zuletzt geänderten zuerst. Hintergrundbefehle und Hintergrund-Subagenten laufen weiter. Verloren gehen Details: exakte Tool-Ausgaben, lange Überlegungen, das Hin und Her vor einer Entscheidung. Mehr dazu in unserem Leitfaden zum Claude-Code-Kontextfenster.

Die Faustregel ist einfach. Ist eine Aufgabe erledigt, spart Idle Compaction Geld und Sie merken kaum etwas. Haben Sie mitten in etwas Heiklem aufgehört und soll Claude jeden Schritt kennen, schalten Sie sie für dieses Projekt ab oder kommen innerhalb der Stunde zurück.

Was das für mehrere Agenten bedeutet

Idle Compaction wurde für eine Person gebaut, die eine Sitzung verlässt. Mit mehreren parallelen Agenten sieht es anders aus:

• Jede Sitzung zählt für sich. Sitzungen in verschiedenen Verzeichnissen bauen unterschiedliche Cache-Präfixe auf, Agenten in getrennten Git-Worktrees teilen also nie einen Cache. Jeder, der die Schwelle überschreitet und etwa eine Stunde ruht, wird unabhängig komprimiert.
• Wartende Agenten sind ruhende Agenten. Ein Agent, der seinen Zug beendet hat und auf Ihr Review oder Ihre Antwort wartet, gilt als idle. Wenn Sie nach der Mittagspause beim vierten Fenster ankommen, arbeitet er womöglich schon mit einer Zusammenfassung. Für „passt, ausliefern“ ist das kein Problem, für „geh zurück zu dem Ansatz, den du vorhin verworfen hast“ schon eher.
• Subagenten und Teammates sind nicht gemeint. Sie fallen standardmäßig in die Fünf-Minuten-Cache-Gruppe. Idle Compaction betrifft Ihre Hauptunterhaltungen.
• Headless-Läufe sind nicht erfasst. -p-Läufe und Agent-SDK-Sitzungen liegen außerhalb der Bedingungen, darauf aufgebaute Nacht-Pipelines verhalten sich wie bisher. Für interaktive Nachtarbeit siehe Claude Code sicher über Nacht laufen lassen.
• Der Laptop muss wach bleiben. Schläft der Rechner, vergeht die Stunde ohne Komprimierung, und Sie zahlen wieder für ein ungecachtes Neueinlesen.

Ein praktisches Setup: Idle Compaction standardmäßig anlassen, in den ein, zwei Repositories abschalten, in denen ein Agent oft mitten in der Aufgabe auf Sie wartet, und Agenten mit Rückfragen möglichst innerhalb der Stunde antworten.

Wo AgentVera ins Spiel kommt

Wir entwickeln AgentVera, eine Desktop-App für macOS, Windows und Linux, die Claude Code, Codex und 16 weitere Coding-Agenten nebeneinander ausführt, jeden in einem echten Terminal mit Ihrer eigenen Installation und Anmeldung. Einige Teile passen zu Idle Compaction:

• Token-Einsparung: Auto-Compact ist für jeden Agenten standardmäßig bei 150K Tokens aktiv und nutzt den Komprimierungsbefehl der jeweiligen CLI. Jedes Fenster zeigt die aktuelle Kontextgröße. Eine Nachricht an einen Agenten, der über eine Stunde geruht hat, komprimiert zuerst eine große Unterhaltung, auch bei Agenten ohne eigene Idle Compaction.
• Benachrichtigungen: Sie erfahren, wenn ein Agent fertig ist oder eine Eingabe braucht, sodass weniger Agenten über die Stunde hinaus warten.
• Token-Budgets und Nutzungslimits: ein Limit pro Agent und in der Statusleiste die 5-Stunden- und Wochennutzung jedes Claude- und Codex-Kontos.

Der kostenlose Plan umfasst bis zu 18 Agenten, MCP, Git, Docker, SSH und Code-Review. Einen breiteren Vergleich finden Sie unter Claude Code und Codex parallel: die besten Apps.

Fazit

Idle Compaction ist eine kleine Voreinstellung mit klarem Zweck: eine lange Unterhaltung zusammenfassen, solange der Cache warm ist, damit Ihre Rückkehr kein volles ungecachtes Neueinlesen kostet. Sie braucht eine interaktive Sitzung, den einstündigen Cache und einen ausreichend großen Kontext. Mit CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS senken Sie die Schwelle, mit "idleCompaction": false oder /config schalten Sie sie ab. Warten mehrere Agenten gleichzeitig auf Sie, entscheiden Sie pro Projekt, ob eine Zusammenfassung reicht, und beantworten Sie zuerst die, die den vollen Kontext brauchen.

Quellen: Claude-Code-Changelog, idleCompaction in der Einstellungsreferenz, How Claude Code uses prompt caching und Explore the context window.