Claude Code: Kontext, /compact, /clear und Subagents
Warum lange Sitzungen in Claude Code schlechter werden und wie Du mit /context, /compact, /clear und Subagents Kontext und Nutzungslimit im Griff hältst.
Von Nathan Base
Am Vormittag hat Claude Code noch präzise gearbeitet, am Nachmittag hält es sich nicht mehr an eine Absprache von heute früh, nach einer automatischen Komprimierung fehlen Details, und das Nutzungslimit ist schneller erreicht als gedacht. Alle drei Beobachtungen haben dieselbe Ursache: den Kontext der Sitzung. Hier erfährst Du, was im Kontextfenster von Claude Code steckt, wie Du seinen Füllstand abliest, wann /compact und wann /clear richtig ist und wofür Subagents taugen.
Grundlage ist die offizielle Doku zu Kontextfenster, Kosten und Subagents, Stand 17. November 2026 mit Claude Code 2.1. Der Artikel ergänzt die Spar-Tipps zum Modell aus Claude Fable 5: Features, Mythos 5 und Token-Spar-Tipps um die Arbeitsweise, die für jedes Modell gilt.
Was im Kontextfenster steckt
Das Kontextfenster ist alles, was Claude in einer Sitzung „weiß”. Schon bevor Du etwas tippst, liegen dort der Systemprompt, Deine CLAUDE.md-Dateien, das automatische Gedächtnis, die Namen der MCP-Werkzeuge und die Beschreibungen Deiner Skills. Danach wächst es mit jeder Nachricht, jeder gelesenen Datei, jeder Testausgabe und jeder Antwort von Claude.
Entscheidend für alles Weitere ist ein Detail: Claude Code schickt bei jeder Anfrage die komplette bisherige Sitzung mit, und bei jedem Werkzeugaufruf folgt eine weitere Anfrage. Der Prompt-Cache macht das günstiger, solange er warm ist. Er hält laut Doku im Abo etwa eine Stunde, mit API-Schlüssel nur fünf Minuten. Eine Frage mit einer Zeile zieht in einer Sitzung, die seit dem Morgen läuft, deshalb Nutzung für den ganzen bisherigen Verlauf, wenn auch zum günstigeren Cache-Tarif.
Das Fenster selbst ist inzwischen groß. Die Fable-Modelle, Sonnet ab Version 5, Haiku 5.5 und Opus ab 4.7 arbeiten standardmäßig mit einer Million Tokens. Die Doku sagt deshalb ausdrücklich, dass Dir der Platz nur noch selten ausgeht. Das eigentliche Problem langer Sitzungen sind heute die Kosten pro Anfrage und die Konzentration: Drei alte Aufgaben im Verlauf lenken bei der vierten ab und werden bei jedem Schritt erneut mitgelesen.
Die Kontext-Anzeige lesen
Bevor Du etwas änderst, schau nach, was die Sitzung belegt. Tippe dazu in Claude Code:
/context allDu siehst ein farbiges Raster, das den Füllstand nach Kategorien zeigt, darunter die Einzelposten: welche CLAUDE.md und welche Gedächtnisdateien geladen sind, wie viel MCP-Werkzeuge und Skills belegen und wie viel auf den Gesprächsverlauf entfällt. Am Ende stehen Vorschläge, etwa zu einer aufgeblähten Gedächtnisdatei.
Für den Verbrauch ist ein anderer Befehl zuständig:
/usageMit einem Pro-, Max-, Ultra-, Team- oder Enterprise-Abo zeigt er Deine Limit-Balken und eine Aufschlüsselung, welcher Anteil Deiner jüngsten Nutzung auf Skills, Subagents, Plugins und einzelne MCP-Server entfiel. Darunter stehen Empfehlungen mit Prozentangabe, zum Beispiel eine zu große CLAUDE.md oder „Compact before you step away”. /cost und /stats sind nur andere Namen für denselben Befehl.
Willst Du den Füllstand dauerhaft sehen, trägst Du eine Statuszeile in ~/.claude/settings.json ein:
{
"statusLine": {
"type": "command",
"command": "jq -r '\"\\(.model.display_name) | Kontext: \\(.context_window.used_percentage // 0) %\"'"
}
}Claude Code übergibt der Statuszeile die Sitzungsdaten als JSON, und jq macht daraus eine Zeile wie Opus 5.5 | Kontext: 23 %. Den Befehl haben wir mit jq 1.7.1 an einer Beispiel-Eingabe im Format der Doku geprüft. Aktuelle macOS-Versionen bringen jq bereits mit, unter Debian und Ubuntu installierst Du es mit sudo apt install jq. Der Wert misst nur die Eingabe-Tokens gegen das ganze Fenster und kann ganz am Anfang einer Sitzung noch leer sein, dann steht dort 0 %.
Was beim Komprimieren passiert
Wird das Fenster voll, fasst Claude Code den Verlauf automatisch zusammen. Bei Modellen mit einer Million Tokens passiert das laut Doku bei rund 967.000 Tokens. Mit /compact löst Du denselben Vorgang selbst aus. Die Zusammenfassung behält Deine Anfragen und wichtige Codeausschnitte, aber detaillierte Anweisungen vom Anfang der Sitzung können verloren gehen. Genau das ist der Moment, in dem Claude „vergisst”, was Du ihm vor drei Stunden im Chat erklärt hast.
Was danach noch da ist, regelt Claude Code genau:
| Was | Nach dem Komprimieren |
|---|---|
CLAUDE.md im Projektordner, Regeln ohne paths | frisch von der Festplatte geladen |
| Automatisches Gedächtnis | frisch von der Festplatte geladen |
| Der Plan aus dem Plan-Modus | frisch von der Festplatte geladen |
| Zuletzt bearbeitete Dateien | bis zu fünf werden neu gelesen, große nur als Verweis |
| Benutzte Skills | wieder eingefügt, gekürzt auf 5.000 Tokens pro Skill |
CLAUDE.md in Unterordnern, Regeln mit paths | erst wieder, wenn Claude eine passende Datei anfasst |
| Absprachen im Chat, Ausgaben von Hooks | nur noch als Teil der Zusammenfassung |
Die Regel dahinter: Was in einer Datei steht, überlebt. Was nur im Gespräch stand, wird zusammengefasst und dabei womöglich verkürzt.
Ein Detail überrascht viele. Läuft eine Abo-Sitzung mit mehr als etwa 200.000 Tokens im Leerlauf, komprimiert Claude Code sie kurz bevor der einstündige Cache abläuft. Nach der Mittagspause arbeitest Du dann schon mit einer Zusammenfassung weiter. Den Zeitpunkt der automatischen Komprimierung verschiebst Du mit /autocompact und einer Tokenzahl, etwa /autocompact 500k, und mit /autocompact auto gilt wieder der Standard.
/clear oder /compact: so entscheidest Du
Beide Befehle schaffen Platz, aber auf entgegengesetzte Weise. /compact setzt dieselbe Sitzung mit einer Zusammenfassung fort. /clear beginnt eine neue Sitzung mit leerem Kontext, die alte bleibt gespeichert.
| Situation | Befehl |
|---|---|
| Neue Aufgabe, die mit der bisherigen nichts zu tun hat | /clear |
| Dieselbe Aufgabe geht weiter, der Verlauf ist lang geworden | /compact mit Fokus |
| Zweimal korrigiert, und das Ergebnis ist immer noch falsch | /clear und ein besserer Prompt |
| Nur der letzte Teil des Gesprächs ist Ballast | /rewind, dann „Summarize from here” |
| Kurze Zwischenfrage, die nicht in den Verlauf soll | /btw mit der Frage |
/compact lohnt sich vor allem mit einer Anweisung, was erhalten bleiben soll:
/compact behalte die Änderungen an der API, die offenen Punkte und die TestbefehleOhne Anweisung entscheidet die Zusammenfassung selbst, was wichtig ist. Bedenke dabei, dass /compact selbst eine große Anfrage ist, weil Claude dafür den ganzen Verlauf lesen muss. Nach einer langen Pause, wenn der Cache abgelaufen ist, wird das besonders teuer. /clear kostet dagegen nichts.
Gib der alten Sitzung beim Leeren einen Namen, dann findest Du sie wieder:
/clear api-ratelimitMit /resume api-ratelimit holst Du sie später zurück, aus der Shell geht das mit claude --resume api-ratelimit. Die Regel mit den zwei Korrekturen stammt aus den Best Practices von Anthropic: Eine dritte Korrektur fügt nur einen weiteren Fehlversuch hinzu, den Claude bei jedem Schritt mitliest. Ein frischer Start mit einem Prompt, der das Gelernte enthält, funktioniert fast immer besser.
Wichtiges in Dateien festhalten statt im Chat
Weil Dateien das Komprimieren überleben und Chat-Absprachen nicht, gehört alles, was länger als eine Aufgabe gelten soll, in eine Datei. Dauerhafte Projektregeln stehen in der CLAUDE.md. Was dort hinein gehört und was nicht, erklärt CLAUDE.md für Claude Code: was rein gehört, was nicht.
Für eine Aufgabe, die über mehrere Sitzungen läuft, bewährt sich eine Plan-Datei im Projekt, die Claude selbst pflegt. Bitte Claude zu Beginn, sie anzulegen und nach jedem Teilschritt zu aktualisieren. Sie kann so aussehen:
# Plan: Rate-Limit für die öffentliche API
## Ziel
Jeder API-Schlüssel darf höchstens 100 Anfragen pro Minute stellen.
## Entscheidungen
- Zähler in Redis, weil mehrere Instanzen laufen.
- Bei Überschreitung Status 429 mit Header Retry-After.
## Stand
- [x] Middleware in src/api/rate-limit.ts
- [ ] Tests für Grenzfälle: genau 100 Anfragen, Schlüsselwechsel
## Prüfen
npm test -- rate-limitDie Datei ersetzt Dir das Gedächtnis zwischen den Sitzungen. Nach einem /clear reicht ein Satz wie „Lies PLAN.md und mach beim ersten offenen Punkt weiter”, und Claude hat in wenigen hundert Tokens, wofür es sonst den ganzen alten Verlauf bräuchte. Arbeitest Du im Plan-Modus (Shift + Tab oder /plan), legt Claude Code den Plan ohnehin als Datei ab und lädt ihn nach dem Komprimieren neu.
Was beim Komprimieren unbedingt erhalten bleiben soll, kannst Du zusätzlich in einem eigenen Abschnitt der CLAUDE.md festlegen:
## Compact Instructions
Beim Komprimieren behalten: geänderte Dateien mit Pfad, die Testbefehle
und alle Entscheidungen, die noch nicht in PLAN.md stehen.Laut Doku steuerst Du mit so einem Abschnitt, was die Zusammenfassung erhält. Weil die CLAUDE.md nach jedem Komprimieren neu geladen wird, gilt er auch für alle weiteren Runden.
Subagents: wann sie Kontext sparen und wann nicht
Ein Subagent ist ein zweiter Claude mit eigenem, leerem Kontextfenster. Er erledigt eine Teilaufgabe, liest dafür so viele Dateien wie nötig und gibt am Ende nur eine Zusammenfassung zurück. Die vielen Dateiinhalte und Suchergebnisse landen also nie in Deiner Hauptsitzung.
Claude Code nutzt das von sich aus. Breite Suchen in der Codebasis gehen an den eingebauten Subagent Explore, der nur lesen darf, und die meisten Subagents laufen im Hintergrund, während Du weiterarbeitest. Ausdrücklich anstoßen kannst Du es trotzdem, am besten mit einer klaren Vorgabe, wie kurz die Antwort sein soll:
Nutze einen Subagent, um alle Stellen zu finden, an denen wir getUserById aufrufen.
Gib mir nur Pfad und Zeilennummer zurück, keine Codeauszüge.Wichtig ist die Einordnung, die Anthropic selbst gibt: Subagents sind nicht kostenlos. Jeder schickt eigene Anfragen, die auf dasselbe Nutzungslimit gehen wie Deine Hauptsitzung. Ein neuer Subagent muss sich außerdem erst den Kontext erarbeiten, den Deine Sitzung schon hat, und ist deshalb manchmal langsamer. Eine klügere Antwort bekommst Du durch die Delegation auch nicht, denn es ist dasselbe oder ein kleineres Modell. Subagents lohnen sich in genau diesen Fällen:
- lange Ausgaben wie ein kompletter Testlauf oder eine breite Suche, die sonst den Rest der Sitzung mitfahren würden,
- unabhängige Teilaufgaben, die parallel schneller fertig werden,
- ein Review durch jemanden, der Deine Begründungen nicht gesehen hat.
Für wiederkehrende Suchen lohnt ein eigener, günstiger Subagent. Leg dazu die Datei .claude/agents/sucher.md im Projekt an:
---
name: sucher
description: Durchsucht die Codebasis und meldet nur Fundstellen mit Pfad und Zeile. Für breite Suchen nutzen.
tools: Read, Grep, Glob
model: haiku
---
Suche im Projekt nach dem, was Dir aufgetragen wird. Antworte mit höchstens
15 Zeilen im Format Pfad:Zeile und einem Satz, warum die Stelle passt.
Gib keine Codeauszüge zurück.name und description sind Pflicht. Über description entscheidet Claude, wann es den Subagent einsetzt. tools beschränkt ihn aufs Lesen, und das erzwingt Claude Code selbst. model: haiku lässt ihn auf dem günstigsten Modell laufen. Claude Code beobachtet den Ordner und kennt den neuen Subagent meist nach wenigen Sekunden. Du rufst ihn mit „Lass den sucher alle Aufrufe von getUserById finden” auf oder wählst ihn nach Eingabe von @ aus der Liste. Wie viel Deiner Nutzung auf Subagents entfällt, zeigt Dir später /usage.
Eine Arbeitsweise, die sich bewährt
Aus all dem ergibt sich ein einfacher Ablauf für den Alltag:
- Starte jede neue Aufgabe in einer frischen Sitzung oder nach
/clearmit einem Namen. - Lass Claude bei größeren Aufgaben zuerst einen Plan in eine Datei schreiben.
- Schick breite Suchen und lange Testläufe an einen Subagent und verlange eine kurze Antwort.
- Wirf alle paar Schritte einen Blick auf die Statuszeile oder
/context. - Geht die Aufgabe nach einer Pause weiter, nutze
/compactmit Fokus. Ist sie erledigt, nutze/clear. - Halte alles, was bleiben soll, in
PLAN.mdoder derCLAUDE.mdfest, nicht im Chat.
Wenn es trotzdem hakt
Das Limit ist schnell erreicht. Öffne /usage und lies die Empfehlungen. Meist steckt eine lange, nie geleerte Sitzung dahinter, ein Cache, der nach einer Pause abgelaufen ist, oder ein Subagent, der viel mehr Anteil hat als gedacht. Eine Warnung zum Kontext oder zur automatischen Komprimierung ist übrigens kein Nutzungslimit, sondern nur der Hinweis, dass bald zusammengefasst wird. Die Meldung „You’ve hit your session limit” dagegen betrifft das Fünf-Stunden-Fenster Deines Abos, und daran ändert auch ein Modellwechsel nichts.
Nach dem Komprimieren fehlt eine Regel. Dann stand sie nur im Chat oder in einer Datei, die erst bei Bedarf lädt. Schreib sie in die CLAUDE.md im Projektordner oder in einen ## Compact Instructions-Abschnitt. Prüfen kannst Du das in einer neuen Sitzung mit /context all.
Die Komprimierung läuft in einer Schleife. Ist eine einzelne Datei oder Ausgabe so groß, dass sich der Kontext nach jeder Zusammenfassung sofort wieder füllt, bricht Claude Code nach einigen Versuchen mit einer Fehlermeldung ab. Lass solche Ausgaben von einem Subagent lesen oder bitte Claude, nur den relevanten Ausschnitt zu holen, etwa die letzten hundert Zeilen eines Logs.
Falls Du noch überlegst, ob Claude Code überhaupt das richtige Werkzeug für Dich ist, hilft Dir der Vergleich Claude Code oder Codex CLI: welcher Coding-Agent? bei der Entscheidung.
Weiterlesen.
-
KICLAUDE.md für Claude Code: was rein gehört, was nicht
So schreibst Du eine CLAUDE.md, an die sich Claude Code hält: was hinein gehört, was nicht, Ladeorte, Vorlage und ein echtes Beispiel.
Nathan Base -
KIClaude Fable 5: Features, Mythos 5 und Token-Spar-Tipps
Was Claude Fable 5 gegenüber Opus 4.8 besser kann, wie es sich zu Mythos 5 verhält und wie Du den hohen Tokenverbrauch in Claude Code bremst.
Nathan Base -
KIClaude Code oder Codex CLI: welcher Coding-Agent?
Claude Code und Codex CLI im Vergleich: Preise, Limits, Stärken laut Community, Sicherheitsmodi und eine klare Empfehlung, wann Du welchen Agenten nimmst.
Nathan Base -
KIClaude Code Hooks: Anleitung mit fünf Beispielen
So richtest Du Hooks in Claude Code ein: settings.json, PreToolUse und PostToolUse, Exit-Codes und fünf Beispiele von Prettier bis zur .env-Sperre.
Nathan Base -
KIOpen Design: Gratis Design-Workspace für Claude Code
Open Design gibt Claude Code einen lokalen Design-Workspace mit Live-Vorschau. Installation, Stärken und wann pures Claude Code besser ist.
Nathan Base -
KIClaude Code Skills in Codex nutzen
Claude-Code-Kontingent aufgebraucht? Mit OpenAI Codex arbeitest Du im selben Projekt weiter. So nutzt Codex Deine Skills und die CLAUDE.md.
Nathan Base