SpyBara
Go Premium

context-window.md 2026-11-11 22:59 UTC to 2026-11-12 21:00 UTC

No changes for this document in this history range.

2026
Wed 11 22:59

Erkunden Sie das Kontextfenster

Eine interaktive Simulation, wie sich das Kontextfenster von Claude Code während einer Sitzung füllt. Sehen Sie, was automatisch geladen wird, welche Kosten jeder Dateilesevorgang hat, und wann Regeln und Hooks ausgelöst werden.

Das Kontextfenster von Claude Code enthält alles, was Claude über Ihre Sitzung weiß: Ihre Anweisungen, die Dateien, die es liest, seine eigenen Antworten und Inhalte, die nie in Ihrem Terminal erscheinen. Die folgende Zeitleiste zeigt eine vollständige Sitzung vom Start bis zur Komprimierung: was geladen wird, bevor Sie etwas eingeben, was jeder Dateilesevorgang, jede Regel und jeder Hook hinzufügt, während Claude arbeitet, und wie ein Subagent große Lesevorgänge aus Ihrem Kontext heraushält. Siehe die schriftliche Aufschlüsselung für denselben Inhalt als Liste.

Was die Zeitleiste zeigt

Die Sitzung durchläuft einen realistischen Ablauf mit repräsentativen Token-Zählungen:

  • Bevor Sie etwas eingeben: CLAUDE.md, Auto-Memory, MCP-Tool-Namen und Skill-Beschreibungen werden alle in den Kontext geladen. AGENTS.md-Dateien können anstelle von CLAUDE.md geladen werden. Ihr eigenes Setup kann hier mehr hinzufügen, wie ein Ausgabestil oder Text aus --append-system-prompt.
  • Während Claude arbeitet: Jeder Dateilesevorgang fügt zum Kontext hinzu, pfadgebundene Regeln werden automatisch zusammen mit übereinstimmenden Dateien geladen, und ein PostToolUse Hook wird nach jeder Bearbeitung ausgelöst.
  • Die Folgeeingabeaufforderung: Ein Subagent verarbeitet die Recherche in seinem eigenen separaten Kontextfenster, sodass die großen Dateilesevorgang außerhalb des Ihren bleiben. Nur die Zusammenfassung und ein kleiner Metadaten-Trailer kommen zurück.
  • Am Ende der Anleitung: Sie führen /compact aus, das die Konversation durch eine strukturierte Zusammenfassung ersetzt. Der meiste Startinhalt wird automatisch neu geladen; die folgende Tabelle zeigt, was mit jedem Mechanismus geschieht.

Was die Komprimierung übersteht

Wenn eine lange Sitzung komprimiert wird, fasst Claude Code die Konversationshistorie zusammen, um in das Kontextfenster zu passen.

Mechanismus Nach der Komprimierung
System-Prompt und Ausgabestil Beide gelten weiterhin
Projekt-Root CLAUDE.md und ungebundene Regeln Neu eingefügt von der Festplatte
Auto-Memory Neu eingefügt von der Festplatte
Skill-Beschreibungen Aus Ihren aktuellen Skills neu erstellt und neu eingefügt. Erfordert Claude Code v2.1.304 oder höher
Git-Status-Snapshot Wenn die Sitzung mit einem Snapshot gestartet wurde, liest Claude Code einen neuen aus Ihrem Repository
Der Plan, den Claude im Plan-Modus geschrieben hat Neu eingefügt von der Festplatte
Regeln mit paths: Frontmatter Claude Code lädt sie bei Bedarf neu
Verschachtelte CLAUDE.md in Unterverzeichnissen Claude Code lädt sie bei Bedarf neu
Dateien, die Claude gelesen oder bearbeitet hat Claude Code liest bis zu fünf neu, die zuletzt geänderten zuerst
Aufgerufene Skill-Texte Neu eingefügt, begrenzt auf 5.000 Token pro Skill und 25.000 Token insgesamt; älteste werden zuerst gelöscht
Hintergrundbefehle und Hintergrund-Subagenten Weiterhin ausgeführt. Claude Code erinnert Claude daran, welche noch ausgeführt werden, damit es keine Duplikate startet
Kontext, den Hooks früher hinzugefügt haben Mit dem Rest der Konversation zusammengefasst
SessionStart Hooks, die die compact Quelle erfüllen Claude Code führt sie aus und fügt ihre Ausgabe zum komprimierten Kontext hinzu

Unmittelbar nach der Komprimierung liest Claude Code bis zu fünf der Dateien neu, die Claude in der Sitzung gelesen oder bearbeitet hat, und wählt die zuletzt geänderten aus. Eine Datei über 5.000 Token kommt als Pfadreferenz ohne ihren Inhalt zurück, angezeigt als Referenced file statt Read.

Pfadgebundene Regeln und verschachtelte CLAUDE.md-Dateien werden in die Nachrichtenhistorie geladen, wenn Claude ihre Trigger-Datei liest, schreibt oder bearbeitet, sodass die Komprimierung sie zusammen mit allem anderen zusammenfasst. Wenn eine Regel über die Komprimierung hinweg bestehen bleiben muss, entfernen Sie das paths: Frontmatter oder verschieben Sie die Regel in die Projekt-Root CLAUDE.md.

Skill-Texte werden nach der Komprimierung neu eingefügt, aber große Skills werden auf die Pro-Skill-Grenze gekürzt, und die ältesten aufgerufenen Skills werden gelöscht, sobald das Gesamtbudget überschritten wird. Die Kürzung behält den Anfang der Datei bei, daher sollten Sie die wichtigsten Anweisungen oben in SKILL.md platzieren.

Wenn sich Ihr Kontext füllt

Claude Code komprimiert automatisch, wenn Sie sich dem Limit nähern, sodass ein volles Kontextfenster Ihre Sitzung nicht beendet. Der automatische Durchlauf funktioniert genauso wie der /compact-Schritt in der Zeitleiste. Unter Wenn sich der Kontext füllt erfahren Sie, was dabei erhalten bleibt. Informationen dazu, wann Claude Code auch eine Konversation komprimiert, die Sie inaktiv lassen, finden Sie unter Komprimierung bei Inaktivität.

Sie können auch handeln, bevor der automatische Durchlauf ausgeführt wird:

  • Mit Fokus komprimieren: Führen Sie /compact mit Anweisungen aus, etwa /compact focus on the auth bug fix, bevor Sie eine lange neue Aufgabe beginnen. Die Zusammenfassung behält bei, was Sie auswählen, statt dessen, was der automatische Durchlauf für wichtig hält.
  • Einen Teil der Konversation komprimieren: Führen Sie /rewind aus, wählen Sie eine Nachricht aus und wählen Sie Summarize from here oder Summarize up to here. Unter Zurückspulen und zusammenfassen erfahren Sie, was jede Option beibehält und wie Sie die Zusammenfassung steuern.
  • Früher komprimieren: Führen Sie /autocompact mit einer Token-Anzahl aus, etwa /autocompact 500k, um festzulegen, wie voll das Kontextfenster werden darf, bevor der automatische Durchlauf ausgeführt wird. Unter Das Fenster für die automatische Komprimierung festlegen finden Sie zulässige Werte und Möglichkeiten zum Überschreiben.
  • Zwischen Aufgaben leeren: Führen Sie /clear aus, wenn Sie zu einer nicht verwandten Arbeit wechseln. Eine alte Konversation verdrängt die Dateien, die Sie als Nächstes benötigen, und kostet bei jeder Nachricht Token.
  • Umfangreiche Lesevorgänge delegieren: Übergeben Sie Recherchen an einen Subagenten, damit die Dateiinhalte in dessen Kontextfenster bleiben und nicht in Ihrem.

Wenn Sie ein größeres Fenster statt einer kleineren Konversation benötigen: Fable-Modelle, Sonnet 5 und neuer, Haiku 5.5, Opus 4.6 und neuer sowie Sonnet 4.6 unterstützen ein Kontextfenster von 1 Million Token. Unter Erweiterter Kontext finden Sie die Verfügbarkeit je nach Plan und erfahren, wie Sie eine [1m]-Modellvariante auswählen. Die Komprimierung funktioniert beim größeren Limit genauso.

Der Zeitpunkt, an dem die automatische Komprimierung ausgeführt wird, hängt von Ihrem Modell und Ihrer Konfiguration ab. Unter Standard-Schwellenwerte für die automatische Komprimierung finden Sie die Grenzen pro Modell, und unter Das Fenster für ein Gateway oder eine benutzerdefinierte Modell-ID korrigieren erfahren Sie, was zu tun ist, wenn Claude Code für Ihre Modell-ID ein falsches Fenster annimmt, etwa bei einem Alias eines LLM-Gateways.

Überprüfen Sie Ihre eigene Sitzung

Die Visualisierung verwendet repräsentative Zahlen. Um Ihre tatsächliche Kontextnutzung zu einem beliebigen Zeitpunkt zu sehen, führen Sie /context aus, um eine Live-Aufschlüsselung nach Kategorie mit Optimierungsvorschlägen zu erhalten, einschließlich welche CLAUDE.md- und automatische Speicherdateien geladen wurden. Führen Sie /memory aus, um diese Dateien zu öffnen und zu bearbeiten.

Verwandte Ressourcen

Für eine tiefere Abdeckung der in der Zeitleiste gezeigten Funktionen siehe diese Seiten: