Komprimierung im Leerlauf in Claude Code: Bedingungen, Schwelle und Abschalten
Abschalten: "idleCompaction": false in settings.json eintragen (der Schlüssel braucht 2.1.290 oder neuer) oder die Zeile Idle compaction in /config nutzen. Die Komprimierung im Leerlauf kam mit Claude Code 2.1.299 (veröffentlicht 2026-10-14) als Standardverhalten: Ein Gespräch, dessen Kontext die Token-Schwelle erreicht hat (standardmäßig 200.000) und das rund 54 Minuten untätig bleibt, während der Rechner an ist, wird komprimiert, kurz bevor sein Prompt-Cache abläuft; wenn Sie zurückkommen, zeigt die Unterhaltung `Compacted while idle, before the prompt cache expired`, und Ihre nächste Nachricht sendet eine Zusammenfassung statt der ganzen Unterhaltung. Stand 2026-10-19 ist auf npm 2.1.303 aktuell (veröffentlicht 2026-10-18).
Aktualisiert 2026-10-19
Ein Key für Claude, GPT und führende chinesische Modelle, Bezahlung pro Token, in wenigen Minuten startklar.
- Bezahlung pro Token — aktuelle Preise unter /models
- Zahlung per Karte (Visa / Mastercard / AMEX), Apple Pay, Google Pay oder Krypto
- Selbstbedienung: aufladen und sofort aktivieren
Auslösebedingungen, Schwelle und Abschaltwege
Standardverhalten seit 2.1.299
Die Doku schreibt: Für Unterhaltungen, die die Bedingungen erfüllen, ist die Komprimierung im Leerlauf eingeschaltet. Der Schalter ist `idleCompaction` in settings.json, Standardwert true, Geltungsbereich Any file.
Wie lange die Sitzung leer sein muss
Die Leerlauf-Prüfung: Etwa 54 Minuten sind seit der letzten Anfrage vergangen und der Rechner ist in diesem Moment an; außerdem muss der Kontext die Token-Schwelle erreicht haben, standardmäßig 200.000, änderbar über die Umgebungsvariable `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS`, und Werte unter 100000 werden auf 100000 angehoben.
Die Voraussetzungen aus der Doku
Die Voraussetzungen: eine interaktive Sitzung im Terminal, das Gespräch läuft auf der einstündigen Prompt-Cache-Laufzeit, der Client kann Feature Flags abrufen, der Kontext hat die Schwelle erreicht, und der Rechner ist nach langer Untätigkeit an.
Die Wege aus der Doku
Setzen Sie "idleCompaction": false in settings.json (2.1.290 oder neuer); auf einer älteren Version setzen Sie autoCompactEnabled: false; die Umgebungsvariable `DISABLE_AUTO_COMPACT=1` schaltet die Komprimierung im Leerlauf zusammen mit der Auto-Komprimierung ab, das manuelle /compact bleibt verfügbar. Seit 2.1.302 gibt es die Zeile Idle compaction auch in /config.
Was die Komprimierung im Leerlauf wirklich tut
Sie macht aus einem Gespräch, von dem Sie sich entfernt haben, eine Zusammenfassung, und das alte Cache-Präfix wird nicht mehr weiterverwendet. Die Doku schreibt: Die Komprimierung im Leerlauf erfolgt kurz vor dem Ablauf des Prompt-Caches, und Ihre nächste Nachricht sendet dann eine Zusammenfassung statt der ganzen Unterhaltung. An anderer Stelle derselben Dokumentation steht: die Komprimierung baut ein neues Cache-Präfix auf, während /rewind auf ein bereits gecachtes Präfix zurückschneidet. Cache-Writes und Cache-Reads werden getrennt abgerechnet, jedes zu seinem eigenen Satz; die Unterschiede der Cache-Write-Sätze je Laufzeit stehen auf der Seite /prompt-caching-cost-2026.
Offizielle Changelog und Doku am 2026-10-19
Geprüft am 2026-10-19 gegen die Claude Code Changelog, die Einstellungsreferenz und die Seite der Umgebungsvariablen: 2.1.299 (veröffentlicht 2026-10-14) brachte die Komprimierung im Leerlauf im Terminal und `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` zum Verschieben der Schwelle; 2.1.302 (veröffentlicht 2026-10-16) fügte die Zeile Idle compaction in /config hinzu, und der Hinweis nach einer Komprimierung sagt jetzt, wie man sie abschaltet; auf npm ist 2.1.303 aktuell (veröffentlicht 2026-10-18).
Die Releases und die Daten
Claude Code 2.1.299 erscheint, und die Changelog verzeichnet die Komprimierung im Leerlauf im Terminal: ab dieser Version wird ein Gespräch, das die Bedingungen erfüllt, automatisch komprimiert.
Claude Code 2.1.302 erscheint, und die Changelog verzeichnet die Zeile Idle compaction in /config; der Hinweis nach einer Komprimierung sagt, wie man sie abschaltet.
Stand 2026-10-19 ist auf npm 2.1.303 aktuell (veröffentlicht 2026-10-18), und der Schalter sowie die Auslösebedingungen in der Einstellungsreferenz haben sich nicht geändert.
Was die Doku schreibt und was sie offenlässt
Bestätigt (wörtlich auf den offiziellen Seiten)
① Für Unterhaltungen, die die Bedingungen erfüllen, ist die Komprimierung im Leerlauf eingeschaltet; ② Etwa 54 Minuten sind seit der letzten Anfrage vergangen und der Rechner ist in diesem Moment an; ③ der Kontext hat die Token-Schwelle erreicht, standardmäßig 200.000; ④ Werte unter 100000 werden auf 100000 angehoben; ⑤ eine frühere Version ignoriert den Schlüssel, und die Doku nennt stattdessen autoCompactEnabled; ⑥ in der Unterhaltung erscheint ein Hinweis, dass die Komprimierung vor dem Cache-Ablauf erfolgte; ⑦ die Komprimierung baut ein neues Cache-Präfix auf, während /rewind auf ein bereits gecachtes zurückschneidet; ⑧ der Prompt-Cache kennt eine fünfminütige und eine einstündige Laufzeit, und Cache-Writes kosten mit der Stunde mehr
Was die Doku offenlässt
Die Doku sagt nicht, wie sich die Komprimierung im Leerlauf auf die konkreten Cache-Kosten auswirkt, ob sich die Leerlauf-Prüfung mit den Versionen ändert und was zuerst passiert, wenn die Komprimierung im Leerlauf und die Auto-Komprimierung beide greifen: Die Einstellungsreferenz nennt für beide den Schalter und die Bedingungen, aber keine Reihenfolge.
Standard belassen oder abschalten
Standard belassen
Standardmäßig gilt: Ein Gespräch, das die Bedingungen erfüllt, wird komprimiert, im Gespräch erscheint ein Hinweis, dass die Komprimierung vor dem Cache-Ablauf erfolgte, und die nächste Nachricht sendet eine Zusammenfassung. Die Schwelle lässt sich mit `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` verschieben. Die Bedingungen hängen selbst von der Cache-Laufzeit ab: In der offiziellen TTL-Tabelle steht in der Spalte „Nutzungsguthaben, API key oder Cloud-Anbieter“ für das Hauptgespräch fünf Minuten, damit greift die Bedingung mit der Stunde nicht (für einen einstündigen Cache des Hauptgesprächs setzen Sie promptCacheTtl selbst auf 1h).
Abschalten
Die vier Wege stehen oben: der Schalter in settings.json, autoCompactEnabled für eine ältere Version, die Umgebungsvariable, die auch die Auto-Komprimierung abschaltet, und die Schalterzeile in /config. Ist die Komprimierung aus, bleibt das Gespräch stehen, bis Sie selbst /compact ausführen oder der Kontext an die Grenze kommt.
Reihenfolge der Prüfung
① Zuerst die Version: der Schlüssel "idleCompaction" wird erst ab 2.1.290 gelesen. ② Prüfen Sie, ob es wirklich das ist: der Hinweis in der Unterhaltung, dass die Komprimierung vor dem Cache-Ablauf erfolgte, ist das Kennzeichen der Leerlauf-Komprimierung, ein manuelles /compact ist etwas anderes. ③ Bedingungen abgleichen: interaktive Sitzung im Terminal, einstündige Cache-Laufzeit, Kontext an der Schwelle und ein wacher Rechner nach langer Untätigkeit — alle müssen zutreffen. ④ Abschalten: der Schalter idleCompaction in settings.json oder die Zeile Idle compaction in /config. ⑤ Schwelle anpassen: `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` nimmt nur eine positive ganze Zahl, Werte unter 100000 werden auf 100000 angehoben.
Claude Code mit einem QCode-Schlüssel anbinden
Wie es auf der QCode-Seite zu den Umgebungsvariablen steht: ANTHROPIC_BASE_URL bis zum Präfix /api eintragen (https://api.qcode.cc/api), den Schlüssel in ANTHROPIC_AUTH_TOKEN legen (er beginnt mit cr_, Claude Code sendet ihn als Bearer-Token), und Werkzeuge, die nur ANTHROPIC_API_KEY kennen, akzeptieren denselben Schlüssel. QCode.cc ist prepaid: erst Guthaben aufladen, dann Tarif oder Paket kaufen, die Kaufsumme wird vom Guthaben abgezogen; 5 gleichzeitige Anfragen, dieselben Modelle wie die Privatpläne; abgerechnet wird pro Token, die Preise je Modell stehen auf /models. Kein Monatsplan nötig? Nutzungspakete starten bei $4 — ein einmalig gekaufter Betrag, den Sie in 7–90 Tagen verbrauchen.
Häufig gestellte Fragen
Welche Version hat die Komprimierung im Leerlauf gebracht?
2.1.299. Das offizielle Changelog verzeichnet für diese Version die Komprimierung im Leerlauf im Terminal und dazu `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` zum Verschieben der Schwelle. Auf npm zeigt der dist-Tag stable noch auf 2.1.292, eine Installation über den Stable-Kanal hat dieses Verhalten also möglicherweise noch nicht; aktuell ist 2.1.303 (veröffentlicht 2026-10-18).
Warum fehlt nach der Rückkehr ein Teil des Kontexts?
Meist ist es die Komprimierung im Leerlauf: Die Doku schreibt, dass Ihre nächste Nachricht eine Zusammenfassung statt der ganzen Unterhaltung sendet. Die Voraussetzungen sind eine interaktive Sitzung im Terminal, der Kontext an der Schwelle und ein wacher Rechner nach langer Untätigkeit. Auch ein manuelles /compact ersetzt das Gespräch durch eine Zusammenfassung.
Wie schalte ich sie ab?
Setzen Sie "idleCompaction": false in settings.json, um sie abzuschalten; auf einer älteren Version setzen Sie autoCompactEnabled: false. Die Umgebungsvariable `DISABLE_AUTO_COMPACT=1` schaltet die Komprimierung im Leerlauf zusammen mit der Auto-Komprimierung an der Grenze ab, das manuelle /compact bleibt verfügbar.
Beeinflusst das die Abrechnung?
Es beeinflusst, wie der Cache geschrieben und gelesen wird: Die Doku schreibt, dass die Komprimierung ein neues Cache-Präfix aufbaut, während /rewind auf ein bereits gecachtes Präfix zurückschneidet; der Prompt-Cache wird getrennt als cache_creation_input_tokens und cache_read_input_tokens abgerechnet, ersterer nach dem Cache-Write-Preis, letzterer nach dem Cache-Lesepreis. Die Cache-Preise je Modell stehen auf der Seite /prompt-caching-cost-2026.
Warum löst die Komprimierung im Leerlauf bei der Anmeldung per API key nicht aus?
In der offiziellen TTL-Tabelle stehen für das Hauptgespräch in der Spalte „Nutzungsguthaben, API key oder Cloud-Anbieter“ fünf Minuten; eine Bedingung der Komprimierung im Leerlauf ist dagegen, dass das Gespräch auf der einstündigen Prompt-Cache-Laufzeit läuft – bei einer Anmeldung per API key ist diese Bedingung also meist nicht erfüllt. Für einen einstündigen Cache des Hauptgesprächs verlangt die Doku, dass Sie promptCacheTtl selbst auf 1h setzen (nötig ab 2.1.242).
Was hat die offizielle Seite zuletzt geändert?
In /config gibt es jetzt eine Zeile Idle compaction, damit lässt sich die Komprimierung im Leerlauf jederzeit abschalten und wieder einschalten, und die Changelog schreibt, dass der Hinweis nach einer Komprimierung jetzt sagt, wie man sie abschaltet. Der Rest des Mechanismus bleibt: Schwelle, Leerlauf-Prüfung und Cache-Laufzeit sind weiterhin die dokumentierten Bedingungen.
Quellen
Offizielle Quellen: die Claude Code Changelog (raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md, abgerufen und geprüft 2026-10-19), die offizielle Einstellungsreferenz, die Seite der Umgebungsvariablen und die Seite zum Prompt Caching (code.claude.com/docs/en, abgerufen und geprüft 2026-10-19) sowie die Veröffentlichungsdaten von @anthropic-ai/claude-code auf npm (registry.npmjs.org, abgerufen und geprüft 2026-10-19: 2.1.299 am 2026-10-14). Auf der QCode-Seite: die Seiten „Umgebungsvariablen“ und „Endpunkte und API-Formate“ auf docs.qcode.cc (abgerufen und geprüft 2026-10-19) sowie die Seite zu den Nutzungspaketen auf qcode.cc in fünf Sprachen (abgerufen und geprüft 2026-10-19).
Claude Code mit einem Nutzungspaket fahren
Kein Monatsplan nötig? Nutzungspakete starten bei $4 — ein einmalig gekaufter Betrag, den Sie in 7–90 Tagen verbrauchen.
Weiterführende Lektüre
Nutzungspakete
Einmaliges Kontingent für 7–90 Tage ohne Abo; weitere Pakete landen auf demselben Key
Prompt-Caching-Preis-Tracker 2026
Cache-Lese- und Write-Preise, TTLs und Mindestlängen bei Claude, GPT und DeepSeek, mit zwei nachrechenbaren Beispielen (Stand 2026-10-07).
Kostenoptimierungs-Leitfaden
Claude Code Token-Einsparung und intelligente Routing-Strategien
Krypto-Zahlungsleitfaden
Neun Coins, 56 Netzwerke, keine Plattformgebühr für KI-Coding-API-Guthaben.
Diese Seite wurde am 2026-10-19 gegen die Claude Code Changelog, die offizielle Dokumentation und die Veröffentlichungsdaten auf npm geprüft; diese Mechanismen ändern sich mit der Version, spätere Versionen können sie anpassen, maßgeblich ist also die offizielle Dokumentation. Die Modelle auf QCode stehen auf /models.