Claude Code Kontextfenster: Wann komprimiert, gelöscht oder aufgeteilt wird

Das Kontextfenster von Claude Code ist der Arbeitsspeicher Ihrer aktuellen Sitzung. Es speichert Ihre Konversation, jede gelesene Datei, MCP-Tool-Definitionen, benutzerdefinierte Agent-Konfigurationen, Speicherdateien und den vollständigen Verlauf der Tool-Aufrufe, wie die Claude Code Kontextfenster-Dokumentation beschreibt. Wenn es voll wird, haben Sie drei Hebel: /compact, /clear oder eine neue Sitzung mit strukturierter Übergabe starten. Welche Sie wählen, ändert die Qualität von allem, was folgt.

Wählen Sie zwischen Komprimieren, Löschen oder Neuer Sitzung

Drei Befehle, drei verschiedene Ergebnisse. Den Unterschied zu verstehen ist das Wichtigste.

`/compact ` ersetzt den Konversationsverlauf durch eine komprimierte Zusammenfassung und setzt die Sitzung fort. Der Kontext wird kleiner, die Sitzung wird fortgesetzt, und Claude behält ein gewisses historisches Bewusstsein. Sie können steuern, was es behält: /compact focus on the auth bug fix teilt dem Modell mit, worauf es ankommt, statt es raten zu lassen. Die offizielle Kontextfenster-Referenz bestätigt, dass Sie Anweisungen direkt an den Komprimierungspass übergeben können.

`/clear ` ist ein Hard Reset. Die gesamte Konversation wird gelöscht. Kein Verlauf, kein In-Memory-Dateikontext, kein Übergangsstoff. Wie Damian Galarza's Kontextfenster-Analyse beschreibt, bedeutet die Verwendung von /clear ohne vorherige Speicherung Ihres Plans, dass Sie bei Null anfangen. Das ist manchmal in Ordnung, manchmal beabsichtigt.

Das Starten einer neuen Sitzung mit einem Übergabedokument gibt Ihnen einen sauberen Anfang plus Kontinuität. Mehr zur Strukturierung dieser Übergabe weiter unten.

Der grobe Entscheidungsbaum:

1. Gleiche Aufgabe, mehr Platz nötig: /compact mit Fokusanweisung verwenden.
2. Wechsel zu unabhängiger Arbeit: /clear verwenden.
3. Aufgabe zu groß für eine Sitzung oder Qualität bereits nachlassend: Übergabedokument erstellen und neu beginnen.

Eine Sache zum Markieren: /autocompact wird automatisch ausgeführt, wenn Sie sich dem Limit nähern. Sie können festlegen, wie voll das Fenster werden soll, bevor es auslöst, beispielsweise /autocompact 500k, aber der automatische Pass trifft seine eigenen Entscheidungen über das Behalten. Das ist in Ordnung für kurze Sitzungen. Für alles Architektonische sollten Sie /compact manuell ausführen, bevor der automatische Pass die Kontrolle übernimmt.

Sehen Sie, was Kontext verbraucht

Bevor Sie Kontext verwalten, müssen Sie ihn sehen. Führen Sie /context aus und Sie erhalten eine Aufschlüsselung: Gesamtkontextgröße, die Kategorien mit dem höchsten Token-Verbrauch und einen visuellen Balken, der die Aufteilung zeigt. Claude Code 101 aus der offiziellen Akademie erläutert diese Ausgabe. Die Hauptkategorien sind Konversationsverlauf, in die Sitzung geladene Dateiinhalte, Tool-Aufrutverlauf und beliebige Speicher- oder Agent-Konfigurationsdateien.

Die meisten Entwickler sind überrascht vom Tool-Call-Verlauf. Lange Hin-und-Her-Debug-Sitzungen sammeln sich schnell an. Ein Dutzend Dateileser, jeweils mit vollständiger Ausgabe, verstärken sich schnell. Das ist normalerweise das erste, das man angeht.

Was durch einen kompakten Durchgang erhalten bleibt

Nach der offiziellen Dokumentation werden Startup-Inhalte nach einem Compact automatisch neu geladen. Was man beachten muss, sind Nuancen im Gespräch selbst: spezifische architektonische Entscheidungen, Gründe für einen Refactor, warum man einen bestimmten Ansatz abgelehnt hat. Diese bleiben bei einem fokussierten Compact erhalten. Sie überstehen oft nicht den automatischen Durchgang, der nicht weiß, worauf es dir ankommt.

Repository-Lesevorgänge und Tool-Ausgaben eingrenzen

Wie man Dateien in die Sitzung einliest, ist genauso wichtig wie wann man kompakt macht. Ganze Verzeichnisse oder große Dateien einzulesen, wenn man nur eine oder zwei Funktionen braucht, ist einer der schnellsten Wege, um Kontext zu verschwenden.

Ein paar Gewohnheiten, die helfen:

• Bitte Claude, nur die spezifische Datei und den Zeilenbereich zu lesen, den du brauchst, nicht das ganze Modul.
• Wenn du eine große Codebase-Fläche recherchieren musst, delegiere an einen Sub-Agenten. Der Dateiinhalt bleibt im Kontext des Sub-Agenten, nicht in deinem. Du bekommst nur das Ergebnis. Die offizielle Kontextfenster-Dokumentation nennt das explizit: „Delegiere große Lesevorgänge: sende Recherchen an einen Sub-Agenten, damit der Dateiinhalt in seinem Kontextfenster bleibt, nicht in deinem."
• Vermeide es, Dateien erneut zu lesen, die du bereits besprochen hast, es sei denn, etwas hat sich geändert. Claude hat diesen Inhalt bereits im Gespräch.
• Sei spezifisch mit grep- und Such-Tool-Aufrufen. Breite Suchen geben breite Ausgaben zurück.

Für alle, die Multi-Agent-Workflows auf Claude Code aufbauen, deckt der Claude Code subagents guide ab, wie man diese Delegationen strukturiert. Und wenn du auf SDK-Ebene arbeitest, geht der Claude Agent SDK guide tiefer auf Kontextgrenzen zwischen Agenten ein.

Wenn du mehr Zeit damit verbringst, gegen Context zu kämpfen, als Code zu schreiben, könnte es wert sein, mit jemandem zu sprechen, der dies hauptberuflich tut. Mein Claude Code Entwicklungsservice kann helfen, die richtige Projektstruktur von Anfang an aufzubauen.

Entscheidungen beim Kompakt erhalten

Das ist der Schritt, den die meisten Entwickler überspringen. Kurz bevor du kompakt machst oder löscht, bitte Claude um eine Zusammenfassung:

„Bevor wir kompakt machen, gib mir eine Aufzählung der wichtigsten Entscheidungen, die wir getroffen haben, alles, das wir ausdrücklich abgelehnt haben und warum, und den aktuellen Stand der Arbeit."

Kopiere das in deine CLAUDE.md oder eine Notiz. Wenn du fortfährst, füge es als anfänglichen Kontext ein. MindStudios Anleitung zum `/compact` Befehl beschreibt das als Unterschied zwischen kontrollierter und chaotischer Komprimierung: Wenn du /compact manuell ausführst, wählst du aus, was erhalten bleibt; wenn der automatische Durchlauf aktiv wird, entscheidet das Modell, und es behält oft routinemäßige Ausgaben über architektonischem Denken.

Der andere Hebel ist CLAUDE.md selbst. Architektonische Entscheidungen, nicht offensichtliche Komponentenbeziehungen, Dinge, die Claude in diesem Codebase niemals tun sollte: diese gehören dort dauerhaft hin, nicht nur ins Gespräch. Jede neue Sitzung lädt CLAUDE.md automatisch, daher ist es der eine Ort, an dem Kontext wirklich über Sitzungen hinweg bestehen bleibt.

Wann man nicht kompakt macht

• Mitten beim Debugging, wenn spezifische Fehlermeldungen und Stack Traces noch relevant sind.
• Während eines Refactors, bei dem dateiebenenliche Details aktiv verwendet werden.
• Direkt vor Integrationarbeiten, die Kontext aus der Komponente benötigen, die du gerade erstellt hast.

Claudefast's Context-Management-Leitfaden fasst das gut zusammen: Kompaktheit an natürlichen Übergangspunkten zwischen Arbeitsphasen, nicht mitten in einer Phase.

Große Aufgaben aufteilen ohne den Übergabeprozess zu verlieren

Manche Aufgaben sind wirklich zu groß für eine Session. Das ist kein Fehler, das ist einfach die Realität bei großen Codebasen. Die Lösung ist ein strukturiertes Übergabedokument, das vor dem Ende der Session erstellt wird, nicht danach, wenn die Qualität bereits gesunken ist.

Ein nützliches Übergabedokument deckt Folgendes ab:

1. Was abgeschlossen wurde (mit Commit-Referenzen oder Dateipfaden).
2. Was in Arbeit ist und in welchem Zustand.
3. Entscheidungen und deren Begründung (besonders alles nicht Offensichtliche).
4. Was als Nächstes kommt, mit genügend Details, damit eine neue Session es aufgreifen kann, ohne alles erneut zu lesen.
5. Offene Fragen oder Blockers.

Ein Praktiker auf LinkedIn beschrieb das als Kern eines Session-Übergabesystems: Bei einem festgelegten Context-Nutzungslevel erstellt die Session ein Übergabedokument mit dem Geleisteten, Commit-Referenzen und aktuellem Zustand. Die neue Session öffnet mit diesem Dokument als erste Nachricht. Der LinkedIn-Post von JD Fiscus über compact vs clear beschreibt eine TASK > COMMIT > CLEAR > RECAP > RESCAN-Schleife, um Aufgaben fokussiert zu halten, was gut für iterative Feature-Arbeiten funktioniert.

Der konkrete Workflow:

1. Schließe eine logische Arbeitseinheit ab und führe einen Commit durch.
2. Bitte Claude, eine Übergabezusammenfassung zu den fünf oben genannten Punkten zu erstellen.
3. Kopiere die Zusammenfassung in eine Datei in deinem Repo oder in CLAUDE.md.
4. Führe /clear aus oder starte eine neue Session.
5. Öffne die neue Session mit dem Übergabedokument als Kontext.

So fängst du nie bei Null an und schleppst nie eine vollgestellte Session-Historie in Arbeiten, die einen klaren Kopf brauchen.

Modellspezifische Limits und Troubleshooting

Die Kontextfenstergrößen variieren je nach Modell. Der Damian Galarza Post vermerkt, dass Claude Sonnet 4.5 ein Kontextfenster von etwa 200.000 Token hat als Referenzpunkt. Andere Claude-Modelle haben ihre eigenen Limits; überprüfe die offizielle Modell-Dokumentation für aktuelle Zahlen, anstatt dich auf Community-Nummern zu verlassen, die möglicherweise veraltet sind.

Worauf du achten solltest:

• Wiederholung. Claude stellt Fragen, die du bereits beantwortet hast, oder widerspricht einer früheren Entscheidung. Das ist ein Zeichen dafür, dass der relevante Kontext verdrängt oder schlecht zusammengefasst wurde.
• Ignorierte Anweisungen. Wenn Claude Projektkonventionen nicht mehr befolgt, die es früher korrekt umgesetzt hat, könnte der CLAUDE.md-Inhalt verdrängt worden sein. Führe /context aus, um das zu überprüfen.
• Langsame, teure Antworten. Ein großer Kontext kostet bei jeder Nachricht Token. Wenn die Kosten steigen, zeigt dir /context warum.

Eine Sache ist bemerkenswert: Behauptungen über universelle Komprimierungsschwellwerte (ein bestimmter Füllungsgrad, bei dem die Qualität immer sinkt) werden durch die offizielle Dokumentation nicht gestützt. Der richtige Zeitpunkt zum Komprimieren ist aufgabenabhängig. Die grobe Faustregel von mehreren Praktikern ist, bei einer natürlichen Phasengrenze zu handeln, bevor du eine Verschlechterung siehst, nicht danach. Aber deine Ergebnisse variieren je nach Aufgabentyp, Modell und wie viel deines Kontextes dichter Code ist versus Konversation.

FAQ

Kostet `/compact` Token?

Ja. Der Komprimierungsdurchgang selbst ist ein Modellaufruf und verbraucht Token. Das manuelle Ausführen an einer Phasengrenze kostet normalerweise weniger als das automatische Ausführen bei hoher Auslastung, weil die erzeugte Zusammenfassung sauberer ist und du weniger Token für die folgenden Nachrichten ausgibst.

Wirkt sich `/clear` auf meine `CLAUDE.md` aus?

Nein. CLAUDE.md ist eine Datei auf der Festplatte. /clear entfernt nur die Konversation und den Speicher der aktuellen Sitzung. Deine CLAUDE.md wird automatisch neu geladen, wenn Claude Code dein Projektverzeichnis das nächste Mal liest.

Kann ich nur einen Teil der Konversation komprimieren?

Ja. Führe /rewind aus, wähle eine Nachricht und wähle „Summarize from here" oder „Summarize up to here". Die offizielle Context-Window-Dokumentation beschreibt, was jede Option behält. Das ist nützlich, wenn ein bestimmter Debug-Thread den Kontext überlastet, aber die frühere Konversation noch relevant ist.

Teilen sich Worktrees im gleichen Repository den Kontext?

Sie teilen sich lokale Autospeicherung je Maschine, gemäß der offizielle Memory-Dokumentation. Sie teilen keinen Session-Kontext. Jede Worktree-Sitzung hat ihr eigenes Kontextfenster.

Was passiert mit MCP-Tool-Definitionen nach einer Komprimierung?

Die offizielle Dokumentation gibt an, dass Startup-Inhalte, einschließlich MCP-Tool-Definitionen, nach einem Komprimierungsdurchgang automatisch neu geladen werden. Du solltest Tools nicht manuell neu registrieren müssen, aber es lohnt sich, /context nach einer Komprimierung in einer komplexen Sitzung auszuführen, um zu bestätigen, dass die Aufteilung korrekt aussieht.

Der schärfste Vorbehalt in alledem: Wenn du merkst, dass die Qualität sinkt, enthält deine Komprimierungszusammenfassung wahrscheinlich verworrene Ausgaben neben den guten. Komprimiere am Ende einer sauberen Phase, nicht am Anfang einer chaotischen.