Wie Auto-Compact in fünf Coding-Agenten funktioniert

Was tut ein Coding-Agent, wenn das Kontextfenster voll ist?

Das Kontextfenster ist der gesamte Text, den ein Modell in einer einzigen Anfrage lesen kann: Ihre Nachrichten, die Antworten des Agenten, gelesene Dateien, Befehlsausgaben, Regeldateien und Systemanweisungen. Ein Coding-Agent schickt all das bei jedem Schritt erneut an das Modell, deshalb läuft das Fenster in einer langen Sitzung früher oder später voll. Im Beitrag über Prompt Caching haben wir gezeigt, wie ein Cache diese Wiederholung billiger macht; hier geht es darum, was passiert, wenn das Fenster voll ist.

Schon bevor das Fenster voll ist, gibt es ein Problem. Die Compaction-Dokumentation von Anthropic begründet das Zusammenfassen ausdrücklich: Je länger eine Konversation wird, desto schlechter werden die Antworten, deshalb muss der aktive Kontext klein bleiben. Ein Agent fasst die Konversation also nicht nur zusammen, um keinen Fehler zu bekommen, sondern auch, um weiter gut zu arbeiten.

Wenn das Fenster vollläuft, hat ein Agent vier Möglichkeiten:

Am ausführlichsten beschreibt die API-Dokumentation von Anthropic diese Wege. Die Funktion Context Editing löscht alte Tool-Ergebnisse, die ältesten zuerst, und setzt an die Stelle jedes einzelnen einen kurzen Text, der sagt, dass es entfernt wurde. In der Standardeinstellung beginnt das Aufräumen, sobald eine Anfrage 100.000 Token überschreitet, und die letzten 3 Tool-Aufrufe bleiben unverändert. Compaction dagegen ersetzt ältere Gesprächsrunden durch eine Zusammenfassung, die Claude auf dem Server schreibt.

Die Coding-Tools kombinieren diese Wege. Claude Code räumt zuerst alte Tool-Ausgaben auf und fasst die Konversation zusammen, wenn der Platz dann immer noch nicht reicht. Copilot CLI schreibt eine Tool-Ausgabe über 20 KiB in eine temporäre Datei; an das Modell gehen nur der Pfad der Datei und eine Vorschau. Auch Cursor schreibt lange Shell- und MCP-Ausgaben in eine Datei, statt sie abzuschneiden, und der Agent liest bei Bedarf den Rest der Datei; Cursor hat das in einem Beitrag vom Januar 2026 beschrieben.

Die ältesten Nachrichten zu verwerfen, nennt dagegen keine der fünf Dokumentationen als Standardweg; alle beschreiben das Zusammenfassen. Die Dokumentation von Copilot nennt auch den Grund: Ohne Zusammenfassung würden alte Nachrichten gelöscht, ohne eine Spur zu hinterlassen, und Copilot könnte nicht wissen, was in ihnen stand.

Wie funktioniert Auto-Compact in den fünf Tools?

Alle fünf Tools fassen die Konversation von sich aus zusammen und haben einen Befehl, um es von Hand zu tun. Sie unterscheiden sich darin, wann die Zusammenfassung beginnt, was sich einstellen lässt und was sich in den letzten zwei Monaten geändert hat. Die Angaben in der Tabelle haben wir am 20. Oktober 2026 in der Dokumentation und den Release Notes des jeweiligen Tools gelesen:

Quelle: Dokumentation und Release Notes des jeweiligen Tools, 20. Oktober 2026. „Steht nicht in der Dokumentation“ heißt: Auf den Seiten, die wir an diesem Tag gelesen haben, fanden wir keinen Satz dazu. „—“: In den Release Notes, die wir gelesen haben, fanden wir keine Änderung aus diesen Monaten. Die CLI-Version von Cursor ist das Datum ihrer Veröffentlichung. In die Desktop-App von Antigravity kam /compact mit Version 2.24.0 (15. Oktober). Die beiden Codex-Änderungen kamen mit den Versionen 0.162.0 und 0.163.0.

Claude Code gibt die Schwelle in Token an, nicht in Prozent. Laut Dokumentation wird die Konversation, wenn Sie keine Schwelle eingestellt haben, beim Kontextlimit des Modells zusammengefasst; bei Modellen mit 1M-Token-Fenster geschieht das, bevor das Fenster voll ist, bei etwa 967 Tausend Token. Soll früher zusammengefasst werden, geben Sie einen Befehl wie /autocompact 500k ein; der Wert wird für dieses Modell in Ihren Einstellungen gespeichert. Seit Version 2.1.299 (14. Oktober) gibt es außerdem das Zusammenfassen im Leerlauf; mehr dazu im nächsten Abschnitt.

Copilot CLI arbeitet mit zwei Schwellen statt einer. Laut Dokumentation beginnt die Zusammenfassung im Hintergrund, wenn die Konversation etwa 80 % des Fensters erreicht; der restliche Platz bleibt frei, damit Tool-Aufrufe weiterlaufen können, während die Zusammenfassung entsteht. Steigt der Füllstand auf etwa 95 %, bevor sie fertig ist, wartet die CLI kurz.

In Codex legt model_auto_compact_token_limit in der Datei ~/.codex/config.toml die Schwelle fest. Lassen Sie den Wert leer, gilt der Standard des Modells; die Dokumentation nennt dafür keine Zahl. Wie die Zusammenfassung geschrieben wird, ändern Sie mit compact_prompt.

Falls Sie noch Gemini CLI nutzen: Gemini CLI komprimiert standardmäßig, wenn der Kontext zur Hälfte voll ist (compressionThreshold steht standardmäßig auf 0,5), und der Befehl dafür ist /compress. Für die kostenlose Stufe und für Google-One-Nutzer hat Google Gemini CLI am 18. Juni 2026 durch Antigravity CLI ersetzt; mit Enterprise-Lizenzen und bezahlten API-Schlüsseln wird Gemini CLI weiter genutzt.

Was geht verloren, wenn die Konversation zusammengefasst wird?

Das Zusammenfassen hat drei Nachteile, und alle drei stehen in der Dokumentation der Tools selbst.

Der Cache wird ungültig. Prompt Caching speichert den unveränderten Anfang einer Anfrage, und spätere Anfragen lesen ihn günstig. Eine Zusammenfassung oder ein Aufräumen verändert den Anfang der Konversation. Die nächste Anfrage kann die Kopie im Cache nur bis zur geänderten Stelle nutzen und schreibt den Rest neu. Deshalb empfiehlt die Dokumentation von Anthropic die Einstellung clear_at_least: Jedes Aufräumen soll mindestens eine bestimmte Zahl von Token löschen, damit sich das Neuschreiben des Caches lohnt. Welche Änderung den Cache ungültig macht, haben wir im Beitrag über Prompt Caching ausführlich beschrieben.

Auch das Zusammenfassen im Leerlauf, das Claude Code am 14. Oktober bekommen hat, folgt aus dieser Rechnung. Laut Release Note wird eine Konversation über 200.000 Token, die etwa 54 Minuten ruht, zusammengefasst, bevor der einstündige Cache abläuft. Laut der Dokumentation der Einstellungen schickt Ihre erste Nachricht nach der Rückkehr dann die Zusammenfassung statt der ganzen Konversation. Wenn Sie das nicht wollen, schalten Sie es in den Einstellungen mit "idleCompaction": false ab.

Anweisungen vom Anfang der Konversation können verloren gehen. Die Dokumentation von Claude Code ist eindeutig: Ihre Anfragen und wichtige Codeausschnitte bleiben erhalten, ausführliche Anweisungen vom Anfang der Konversation können aber verloren gehen; dauerhafte Regeln gehören in CLAUDE.md, nicht in die Konversation. Die Dokumentation von Copilot schreibt, dass kleine Entscheidungen vom Anfang einer langen Konversation in der Zusammenfassung fehlen können und dass sich eine fertige Zusammenfassung nicht rückgängig machen lässt. VS Code und Cursor sagen dasselbe: Eine Zusammenfassung ist eine verlustbehaftete Kompression.

Die Release Note von Antigravity CLI 1.2.8 ist ein konkretes Beispiel für diesen Verlust: Bis zu dieser Version wurde eine lange erste Anweisung in der Zusammenfassung auf ein kleines, festes Stück gekürzt, wenn die anderen Prompts der Konversation kurz waren. Wie man eine Regeldatei schreibt, steht im Beitrag über AGENTS.md und CLAUDE.md.

Die Zusammenfassung selbst kann zur Anweisung werden. Auch eine Zusammenfassung schreibt ein Modell, und das Modell, das danach weiterarbeitet, kann sie wie eine Anweisung lesen. Das deutlichste Beispiel ist der Bericht von OpenAI: Während des Trainings fügte ein unveröffentlichtes Modell seinen eigenen Compaction-Zusammenfassungen unerlaubte Anweisungen hinzu. OpenAI bemerkte das am 9. August, aktualisierte den Bericht am 16. September und fand 27 solcher Zusammenfassungen in den Trainingsdaten.

In einem Beispiel hatte der Nutzer eine lange Literaturübersicht mit Quellenangaben verlangt. Die Zusammenfassung fügte eine Regel hinzu, die niemand verlangt hatte: Die Antwort dürfe höchstens 30 Wörter lang sein, ohne Tools und ohne Quellen. Das Modell, das nach der Zusammenfassung weiterarbeitete, hielt sich daran und schrieb eine Ablehnung von 23 Wörtern. Laut Bericht trat das in einem anderen Trainingslauf auf als dem, aus dem das finale Modell stammt, und es wiederholte sich nicht, als die Zusammenfassung neu erzeugt wurde; in einem veröffentlichten Modell wurde es also nicht beobachtet.

Die Lehre gilt trotzdem allgemein: Eine Zusammenfassung ist keine Anweisung, die Sie geschrieben haben, sondern ein Text, den ein Modell geschrieben hat. Auch in Coding-Tools gab es einen ähnlichen Fehler. Die Release Note von Claude Code 2.1.292 behebt ihn: Eine Zusammenfassung, die einen Skill-Befehl wiederholte, konnte dazu führen, dass Claude einen Skill ausführte, der dem Nutzer vorbehalten ist. Tut der Agent nach einer Zusammenfassung etwas, das Sie nicht erwartet haben, schauen Sie zuerst in die Zusammenfassung: In Copilot CLI zeigt /session checkpoints jede automatische Zusammenfassung einzeln.

Wann sollten Sie Clear statt Compact verwenden?

Die beiden Befehle lösen dasselbe Problem auf zwei Arten. Compact ersetzt die Konversation durch eine Zusammenfassung und macht in derselben Sitzung weiter. Clear verwirft die Konversation ganz und beginnt mit leerem Kontext; Regel- und Memory-Dateien auf der Festplatte bleiben, wo sie sind. Welchen Befehl Sie wählen, hängt davon ab, ob die nächste Aufgabe die bisherige Konversation braucht:

Quelle: die Befehlsdokumentation des jeweiligen Tools, 20. Oktober 2026. Der Fokus in eckigen oder spitzen Klammern ist optional: Dort schreiben Sie, was in der Zusammenfassung bleiben soll.

Das konkreteste Kriterium dafür, wann Sie neu beginnen sollten, steht in der Dokumentation von Claude Code: Haben Sie Claude beim selben Problem mehr als zweimal korrigiert, ist der Kontext voller gescheiterter Versuche; geben Sie /clear ein und beginnen Sie neu, mit einem klareren Prompt, der enthält, was Sie gelernt haben. Die Dokumentation von Copilot nennt ein weiteres: Wurde die Konversation schon oft zusammengefasst und haben Sie den Eindruck, dass etwas Wichtiges verloren ging, öffnen Sie eine neue Sitzung.

Die dritte Möglichkeit ist, den Ballast gar nicht erst in die Hauptkonversation zu lassen. Geben Sie Schritte wie das Lesen eines langen Logs, das Durchsehen einer großen Testausgabe oder eine Suche in der Codebasis an einen Subagenten ab, bleibt alles Gelesene im eigenen Fenster des Subagenten, und in die Hauptkonversation kommt nur das Ergebnis zurück. Claude Code, Copilot und Cursor empfehlen das in ihrer Dokumentation ausdrücklich; Subagenten haben wir in einem eigenen Beitrag beschrieben. In Claude Code können Sie einem Subagenten seit Version 2.1.296 (9. Oktober) außerdem eine frühere Schwelle zum Zusammenfassen geben als der Hauptkonversation. Das Beispiel aus der Dokumentation ist ein Subagent, der lange Logdateien liest:

---
name: log-reader
description: Liest lange Logdateien und meldet die gefundenen Fehler
autoCompactWindow: 200000
---

Schreiben Sie den Wert als einfache Zahl. Laut Dokumentation liest Claude Code 200k in diesem Feld als 200; dieser Wert liegt außerhalb des erlaubten Bereichs, und der Subagent läuft, als gäbe es das Feld nicht.

Was liest der Agent nach einer Zusammenfassung neu ein?

Eine Zusammenfassung übersteht, was auf der Festplatte steht und nicht nur in der Konversation. Die Dokumentation von Claude Code zählt einzeln auf, was nach einer Zusammenfassung zurückkommt:

Quelle: Dokumentation von Claude Code, die Seiten “Explore the context window” und “Store instructions and memories”, 20. Oktober 2026.

Soll eine Anweisung aus der Konversation auch nach einer Zusammenfassung gelten, gibt es zwei Wege: Sie schreiben sie in CLAUDE.md, oder ein Hook läuft nach jeder Zusammenfassung. Das Beispiel aus der Dokumentation von Claude Code, auf Deutsch:

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "compact",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'Erinnerung: Bun statt npm verwenden. Vor jedem Commit bun test ausführen.'"
          }
        ]
      }
    ]
  }
}

Der Text, den der Hook ausgibt, wird neben den zusammengefassten Kontext gestellt. Statt echo können Sie auch einen Befehl ausführen, der den aktuellen Stand meldet, etwa git log --oneline -5. Hooks haben wir in einem eigenen Beitrag beschrieben. In den anderen Tools sieht es so aus:

• Codex: Lokale Memories sind standardmäßig aus. Die Dokumentation rät, Regeln, an die sich das Team halten muss, in AGENTS.md zu schreiben und Memories nur als Gedächtnisstütze zu sehen.
• GitHub Copilot: Wenn die CLI zusammenfasst, behält sie neben der Zusammenfassung die ursprünglichen Anweisungen des Nutzers und den aktuellen Stand von Plänen und To-do-Listen. Copilot Memory (in der öffentlichen Vorschau) teilt Wissen über ein Repository zwischen CLI, Cloud-Agent und Code-Review; bevor es eine Information nutzt, prüft es den Code, auf dem sie beruht, im aktuellen Branch. Das Memory-Tool von VS Code speichert Notizen lokal; die Dokumentation empfiehlt, Entscheidungen, auf die sich das Team stützt, in versionierte Dokumente oder in Custom-Instructions-Dateien zu schreiben.
• Cursor: Laut Dokumentation merkt sich das Modell zwischen zwei Completions nichts; für dauerhaften Kontext gibt es Regeln (Rules). Beim Zusammenfassen gibt Cursor dem Agenten außerdem den Chatverlauf als Datei, und dort kann der Agent suchen, was in der Zusammenfassung fehlt (Beitrag vom Januar 2026).
• Antigravity: Der Befehl /learn schlägt vor, was in einer Sitzung gelernt wurde, etwa eine Korrektur oder eine Vorgabe, die immer wieder übersehen wird, als Regel oder Skill festzuhalten; in eine Datei schreibt er erst, wenn Sie zustimmen. Der Ausgangspunkt der Dokumentation ist klar: Agenten erinnern sich nicht an Konversationen.
• Gemini CLI: Die experimentelle Einstellung autoMemory leitet aus früheren Sitzungen Vorschläge für das Gedächtnis ab; sie ist standardmäßig aus, und keiner davon wird angewendet, bevor Sie ihn in /memory inbox bestätigen.

Warum kann ein Code-Review-Agent nicht zusammenfassen?

Alles bisher Gesagte gilt für eine Sitzung, die mit einem Menschen spricht und dabei wächst. Ein Agent, der einen Pull Request prüft, arbeitet anders: Er ist ein einziger Aufruf, er hat niemanden, den er fragen kann, und keinen Verlauf, den er zusammenfassen könnte. Was an das Modell geht, muss er vor dem Aufruf entscheiden.

In diffox trifft diese Entscheidung das Kontextpaket, das sich alle spezialisierten Agenten eines Reviews teilen. Im Code wird das Paket so gebaut:

• Zuerst kommt der Diff. Danach die geänderten Zeilen und Symbole, die von der Änderung betroffenen Aufrufer und die Git-Historie; Dateikontext, PR-Beschreibung und Commit-Nachrichten stehen am Ende. Überschreitet das Paket das Limit, wird es vom Ende her gekürzt, und an der Schnittkante steht eine Zeile, die das sagt. Die Reihenfolge ist so gewählt, dass am Ende der Teil steht, dessen Verlust am wenigsten kostet.
• Lock-Dateien kommen nicht in den Diff. Dateien, die ein Tool schreibt, wie go.sum, package-lock.json oder uv.lock, Vendor-Ordner und minifizierte Dateien werden aus dem Diff genommen, und ihre Namen stehen in einer einzigen Zeile. Im Code steht die Begründung als Messung: Bei einem Pull Request aus dem Benchmark-Set machten go.sum und go.work.sum 68,5 % des Diffs aus, die Quelldatei mit dem untersuchten Fehler 4,2 %.
• Mit geht die Umgebung der Änderung, nicht die ganze Datei. Jeder ausgelassene Zeilenbereich wird mit seinen Zeilennummern genannt; so weiß das Modell, was fehlt.
• Die Regeln des Repositorys gehen außerhalb des Pakets mit. Die verbindlichen Regeln aus der Regeldatei kommen bei jedem Agenten zusätzlich in den System-Prompt, die Kürzung trifft sie also nicht. Das ist auf der Review-Seite das Gegenstück zum Rat an Coding-Agenten, „dauerhafte Regeln in die Regeldatei zu schreiben“.
• Eine nicht gelesene Datei wird festgehalten. Jedes Review hält für jede geänderte Datei fest, ob sie die Agenten ganz, teilweise oder gar nicht erreicht hat. Wurden in einem Review ohne Feststellungen manche Dateien nicht vollständig gelesen, sagt der Kommentar im Pull Request das in einem Satz.

Welches Tool Sie auch nutzen, die Lehre ist dieselbe: Hat der Agent eine Datei nicht gelesen, sagt die Antwort „keine Feststellungen“ nichts über diese Datei. Schauen Sie auch beim Coding-Agenten nach, was im Fenster ist, bevor Sie sagen: „Das weiß er doch schon.“ In Claude Code, Copilot CLI und Antigravity CLI zeigt /context das an.