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 einen großen Codebase-Bereich recherchieren musst, delegiere an einen Subagenten. Der Dateiinhalt bleibt im Kontext des Subagenten, nicht in deinem. Du bekommst nur das Ergebnis. Die offizielle Dokumentation zum Kontextfenster weist das ausdrücklich auf: „Delegiere große Lesevorgänge: Sende Recherchen an einen Subagenten, damit die Dateiinhalte in seinem Kontextfenster bleiben, 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 Kontext zu kämpfen als Code zu schreiben, lohnt es sich möglicherweise, mit jemandem zu sprechen, der das hauptberuflich tut. Das Claude Code Development Team von Seahawk 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 wieder anfängst, füge es als anfänglichen Kontext ein. Der MindStudio-Leitfaden zum `/compact`-Befehl beschreibt dies als den Unterschied zwischen kontrollierter Kompression und chaotischer Kompression: Wenn du `/compact` manuell ausführst, wählst du, was erhalten bleibt; wenn der automatische Durchgang ausgelöst wird, entscheidet das Modell, und es behält oft banale Ausgabe über architektonisches Denken bei.

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 Post von Damian Galarza vermerkt, dass Claude Sonnet 4.5 ein Kontextfenster von etwa 200.000 Token hat als Referenzpunkt. Andere Claude-Modelle haben ihre eigenen Limits; schau in der offiziellen Modell-Dokumentation nach aktuellen Zahlen, statt dich auf Community-Zahlen zu verlassen, die veraltet sein könnten.

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 den maschinenlokal automatischen Speicher gemäß der offiziellen Speicherdokumentation. Sie teilen sich keinen Sitzungskontext. Jede Worktree-Sitzung hat ihr eigenes Context-Window.

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.