Kontextverwaltung

Das Kontextfenster von Claude Code verstehen und verwalten sowie Befehle wie /compact und /clear effektiv nutzen

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Zuletzt überprüft: 2026-11-12 · 📄 Gemäß offizieller Dokumentation (Dokumentation von Claude Code zu Kontextfenster und Modellkonfiguration, Anthropic-Modellübersicht; diesmal wurden das Kontextfenster und die Modellliste geprüft)

Jede Claude-Code-Sitzung läuft innerhalb eines Kontextfensters. Wenn Sie verstehen, wie der Kontext funktioniert, können Sie Claude effizienter einsetzen und Fehler vermeiden, die durch einen Kontextüberlauf entstehen.

Das Kontextfenster verstehen¶

Stand 2026-11-12 gilt laut der Claude-Code-Dokumentation und der Anthropic-Modellübersicht: Fable 5.2 (veröffentlicht am 9. November 2026), Fable 5.1, Fable 5, Sonnet 5 und neuer, Haiku 5.5 sowie Opus 4.7 und neuer laufen standardmäßig mit einem Kontextfenster von 1.000.000 Tokens (1M), ein Suffix [1m] ist nicht nötig. Opus 4.6 und Sonnet 4.6 erreichen 1M nur über ihre [1m]-Variante, sonst sind es 200K. Auf QCode gehören claude-fable-5-2 und das weiterhin verfügbare claude-fable-5-1 zusammen mit den häufig genutzten Modellen claude-opus-5-5, claude-sonnet-5-5 und claude-haiku-5-5 zur ersten Gruppe. Um Sitzungen auf einem 200K-Fenster zu halten, setzen Sie die Umgebungsvariable CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

Der Kontext umfasst:

• den gesamten Gesprächsverlauf (Ihre Nachrichten + die Antworten von Claude)
• Dateiinhalte, die mit @ referenziert wurden
• Ein- und Ausgaben von Tool-Aufrufen
• System-Prompts und den Inhalt von CLAUDE.md

Im Verlauf des Gesprächs wächst der Kontext stetig. Nähert sich der Kontext seiner Grenze, kann sich die Antwortgeschwindigkeit von Claude verlangsamen, und es wird schließlich eine automatische Komprimierung ausgelöst oder ein Fehler tritt auf.

Kontext komprimieren: /compact¶

Der Befehl /compact verdichtet den bisherigen Gesprächsverlauf zu einer kurzen Zusammenfassung. So wird Kontextplatz frei, während wichtige Informationen erhalten bleiben.

/compact

Sie können außerdem eigene Anweisungen hinzufügen, um den Schwerpunkt der Komprimierung zu steuern:

/compact Keep all code examples and the completed task list

Automatische Komprimierung: Solange Sie kein eigenes Fenster festlegen, komprimiert Claude Code automatisch, wenn sich das Gespräch der Kontextgrenze des Modells nähert; bei Modellen mit nativem 1M-Fenster liegt der Standard bei etwa 967K Tokens (laut offizieller Dokumentation). Um früher zu komprimieren, legen Sie das Fenster mit einem Befehl wie /autocompact 500k fest (auto stellt den Standard wieder her; erfordert Claude Code v2.1.221 oder neuer). Sie können /compact auch vorausschauend ausführen, sobald der Kontext 70–80 % erreicht, um nicht bis zum letzten Moment zu warten.

Verlauf löschen: /clear¶

Der Befehl /clear löscht den gesamten Gesprächsverlauf und startet eine neue Sitzung:

/clear

Hinweis: /clear entfernt den gesamten Kontext, einschließlich der Projektinformationen, die Claude bereits kennengelernt hat. Verwenden Sie den Befehl, wenn Sie zu einer völlig anderen, neuen Aufgabe wechseln.

Kontextstatus prüfen: /context¶

Mit dem Befehl /context können Sie die aktuelle Kontextnutzung anzeigen:

/context

@-Dateireferenzen¶

Mit dem Symbol @ fügen Sie Dateiinhalte zum Kontext hinzu:

@src/main.ts Explain what this file does
@package.json Check dependency versions
@README.md

Bewährte Vorgehensweisen:

• Referenzieren Sie nur Dateien, die für die aktuelle Aufgabe relevant sind, um unnötigen Kontext zu vermeiden
• Große Dateien verbrauchen schnell Kontextplatz – referenzieren Sie vorrangig die wichtigsten Dateien
• Nutzen Sie CLAUDE.md, um Projekthintergründe bereitzustellen, anstatt sie in jedem Gespräch erneut einzufügen

Pipe-Eingabe¶

Übergeben Sie Befehlsausgaben oder Dateiinhalte per Pipe an Claude:

# Pipe file contents in
cat error.log | claude "Analyze this error"

# Pipe command output in
git diff | claude "Generate a commit message"

# Multi-line input
echo "Please analyze the following code:
$(cat src/utils.ts)" | claude

Überlauf bei langen Sitzungen verhindern¶

Symptom: E015 Internal server error¶

Nähert sich der Gesprächskontext der Kapazitätsgrenze des Modells (~95 %), gibt die Anthropic API einen 500-Fehler zurück. QCode.cc verpackt diesen als 429-Antwort:

429 {"error":{"code":"E015","message":"Internal server error"},"status":500}

Dies ist ein bekanntes Verhalten der Anthropic API (nicht spezifisch für QCode.cc). QCode.cc verpackt solche 5xx-Fehler als 429-Antworten, um den integrierten Wiederholungsmechanismus von Claude Code zu nutzen.

Lösungsschritte¶

1. Versuchen Sie /compact:

2. Bei Erfolg kann das Gespräch normal fortgesetzt werden

3. Wenn /compact selbst einen Fehler liefert (auch die Komprimierungsanfrage muss den vollständigen Kontext senden), fahren Sie mit dem nächsten Schritt fort

4. Claude Code beenden und neu starten: bash # Press Ctrl+C or type /exit # Then restart claude

Tipps zur Vorbeugung¶

• Regelmäßig komprimieren: Führen Sie /compact vorausschauend aus, sobald der Kontext 70–80 % erreicht, statt auf einen Überlauf zu warten
• Aufgaben aufteilen: Teilen Sie große Aufgaben in kleinere auf und verwenden Sie für jede eine eigene Sitzung
• CLAUDE.md statt wiederholtem Einfügen nutzen: Schreiben Sie Projekthintergründe in CLAUDE.md – Claude liest die Datei beim Start automatisch, sodass Sie sie nicht in jedem Gespräch wiederholen müssen
• Große Dateien vermeiden: Das Referenzieren einer großen Datei verbraucht viel Kontext – referenzieren Sie besser nur die wichtigsten Abschnitte
• Mit /cost überwachen: Der Befehl /cost zeigt die Token-Nutzung der aktuellen Sitzung an

Schnellreferenz der Befehle¶

Hierarchie des Context Engineering¶

„Context Engineering“ bedeutet, dass Sie bewusst organisieren, was Claude bei jeder Anfrage liest – hochwertige, stabile Informationen stehen vorn, Rauschen wird ferngehalten. Der Kontext von Claude Code folgt einer klaren Prioritätshierarchie (höchste zu niedrigste):

1. Enterprise / Managed Policy — Regeln, die von Ihrer Organisation vorgegeben werden. Höchste Priorität; Einzelpersonen können sie nicht überstimmen.
2. Projektgedächtnis CLAUDE.md / AGENTS.md — Anweisungen im Repo-Root, die Code-Konventionen, Build-Befehle und Projekthintergrund beschreiben.
3. Pfadbezogene Regeln — verschachtelte CLAUDE.md-Dateien oder .claude/rules in Unterverzeichnissen, die nur auf Arbeiten unter diesem Pfad angewendet werden.
4. Aktueller Gesprächsverlauf — das Hin und Her in der laufenden Session. Niedrigste Priorität und der Teil, der am ehesten anwächst.

Das Verständnis dieser Hierarchie hilft Ihnen, Anweisungen an die richtige Stelle zu setzen: allgemeine Konventionen kommen ins projektweite CLAUDE.md, verzeichnisspezifische Regeln in pfadbezogene Regeln – anstatt sie in jedem Gespräch erneut zu formulieren.

Praxistipps¶

• Anweisungen kurz und informativ halten: Je schlanker Ihr CLAUDE.md ist, desto leichter kann Claude ihnen folgen; lange, thematisch abschweifende Inhalte verwässern die Kernanweisungen.
• /compact an logischen Abschnitten: Komprimieren Sie den Verlauf nach Abschluss einer Phase – lange, unkonzentrierte Gespräche verschlechtern die Genauigkeit.
• /clear zwischen nicht zusammenhängenden Aufgaben: Löschen Sie den Verlauf beim Wechsel zu einer völlig unabhängigen Aufgabe, damit alter Kontext nicht stört.
• Per Pfad referenzieren statt einfügen: Verwenden Sie @<file path>, damit Claude Dateien bei Bedarf liest, anstatt große Blöcke in das Gespräch zu stopfen – das spart Kontext und erhöht die Genauigkeit.
• Stabile Inhalte zuerst: Unveränderliche Inhalte wie System-Prompts, CLAUDE.md und große Hintergrundblöcke sollten vorn stehen und nicht editiert werden, damit sie von Prompt Caching erfasst werden (caching-gelesene Eingaben kosten etwa 10 % der normalen Input-Kosten). Genau deshalb sparen ein knappes, stabiles CLAUDE.md und wiederverwendete Sessions Kosten.

Kurz gesagt: Schieben Sie stabile, hochwertige Inhalte an die Spitze der Hierarchie und halten Sie sie unverändert, und zügeln Sie den wechselhaften Gesprächsverlauf regelmäßig. Für mehr Details siehe CLAUDE.md-Projektgedächtnis und Kostenoptimierung.

Details zu den wichtigsten Kontextbefehlen¶

Stand 2026-10-15 laut Claude-Code-Befehlsreferenz:

Laut offizieller Memory-Dokumentation wird die CLAUDE.md im Projektstamm nach /compact erneut von der Festplatte gelesen und geht nicht verloren; Anweisungen, die nur in der Unterhaltung standen, können nach der Komprimierung verschwinden – was dauerhaft gelten soll, gehört in die CLAUDE.md.

Hinweise bei der Nutzung über QCode¶

• Claude-Modelle haben keine eigene Langkontext-Stufe und werden nach tatsächlichen Tokens abgerechnet. Bei GPT-Modellen wird die gesamte Anfrage zum Langkontext-Preis berechnet, wenn die Eingabe einer einzelnen Anfrage (einschließlich Cache-Treffern) 272K überschreitet; die Regel steht unter Abrechnung. Komprimieren Sie lange Sitzungen, bevor sie 272K erreichen – das ist günstiger.
• Jede Runde sendet den gesamten aktuellen Kontext erneut an das Modell, je länger die Sitzung, desto mehr Tokens pro Runde. Ein stabiler Anfang (CLAUDE.md, Systemprompt) kann aus dem Cache bedient werden, häufige Änderungen am frühen Inhalt machen den Cache wirkungslos.
• Mit /usage (Alias /cost) sehen Sie den Verbrauch der aktuellen Sitzung. QCode rechnet pro Token ab; die Preise je Modell stehen unter qcode.cc/models.

Häufige Fehler und Fehlersuche¶

FAQ¶

Soll ich /compact oder /clear verwenden?¶

Arbeiten Sie an derselben Sache weiter, nehmen Sie /compact, das eine Zusammenfassung behält. /clear nur beim Wechsel zu einer völlig unabhängigen Aufgabe, denn es beginnt bei null.

Geht die CLAUDE.md bei der Komprimierung verloren?¶

Nein. Die CLAUDE.md im Projektstamm wird nach der Komprimierung neu gelesen; verschachtelte CLAUDE.md-Dateien in Unterverzeichnissen und pfadbezogene Regeln werden bei Bedarf erneut geladen.

Wie löse ich die automatische Komprimierung früher aus?¶

Legen Sie das Fenster mit einem Befehl wie /autocompact 500k fest; auto stellt den auf das Modell abgestimmten Standard wieder her. Der Befehl erfordert Claude Code v2.1.221 oder neuer. Sie können auch selbst /compact ausführen, sobald die Auslastung 70 bis 80 % erreicht (eine Empfehlung, keine offizielle Zahl).

Nach dem Komprimieren fehlt etwas. Kann ich zurück?¶

Ja. Wählen Sie mit /rewind einen früheren Punkt und stellen Sie Unterhaltung, Code oder beides wieder her. Das nutzt die Checkpoints der Sitzung; siehe Workflow-Tipps.

Enterprise →