Kontextmanagement in Claude Code: der stille Hebel für gute Ergebnisse

Du hast Claude eine klare Aufgabe gegeben, und am Anfang lief alles rund. Nach zwei Stunden in derselben Sitzung schleichen sich Fehler ein, Claude vergisst eine frühere Anweisung, der rote Faden reißt. Das liegt selten am Modell. Es liegt am Kontext — und den steuerst du.

Kontext ist alles, was Claude über deine Aufgabe weiß: deine Anweisungen, die offenen Dateien, der bisherige Verlauf. Je besser dieses Wissen, desto besser das Ergebnis. Aber mehr ist nicht gleich besser. Wer das versteht, holt aus Claude Code spürbar mehr heraus als jemand, der einfach immer weiterschreibt.

Das Kontextfenster: der Arbeitsspeicher des Modells

Stell dir das Kontextfenster als Arbeitsspeicher vor. Alles, woran Claude gerade denkt, liegt darin: deine Anweisungen, der Chatverlauf, die gelesenen Dateien. Was nicht hineinpasst, fällt heraus. Gemessen wird der Inhalt in Token — kleine Textbausteine, grob ein Token pro dreiviertel Wort.

Moderne Modelle haben sehr große Fenster. Rund eine Million Token sind heute möglich, das entspricht etwa 750.000 Wörtern oder mehreren dicken Romanen. Die Fenster werden mit jeder Modellgeneration größer. Das klingt nach einem gelösten Problem — und genau hier liegt der Denkfehler.

Context Rot: warum ein großes Fenster nicht alles rettet

Ein größeres Fenster löst das eigentliche Problem nicht. Auch in einem riesigen Speicher sinkt die Trefferquote, je mehr belangloser Stoff darin liegt. Fachleute nennen das Context Rot.

Das Bild dazu kennst du: die Nadel im Heuhaufen. Je mehr Heu, desto schwerer die Nadel. Übertragen heißt das: Je mehr nebensächliche Information im Fenster liegt — alte Chatschnipsel, überlange Anweisungsdateien, zehn geöffnete Dokumente — desto eher verliert Claude den Faden. Die wichtige Anweisung steht zwar noch im Speicher, geht aber im Rauschen unter.

In der Praxis merkst du das ganz konkret. Ab einem Punkt wird Claude in einer langen Sitzung schwächer. Es wiederholt sich, ignoriert eine frühere Vorgabe, dreht sich im Kreis. Das ist kein Defekt. Es ist das Signal, eine neue Sitzung zu starten. Ein frischer Speicher ist oft die beste Reparatur — und kostet dich nichts außer einem kurzen Neustart.

Verbrauch sehen und steuern

Wie voll dein Fenster ist und wer den Platz belegt, kannst du nachsehen — und an den richtigen Stellen gegensteuern. Die folgenden vier Werkzeuge und Faustregeln gehören zusammen.

/context: sieh nach, was dein Speicher verbraucht

Du musst nicht raten, wie voll dein Fenster ist. Der Befehl /context zeigt es dir auf einen Blick. Er listet auf, wofür dein Kontextfenster gerade draufgeht — und das überrascht die meisten beim ersten Mal.

Schon vor deiner ersten Eingabe sind oft Zehntausende Token belegt. Die verteilen sich auf mehrere Posten:

• System-Prompt: die Grundanweisung, die Claude steuert. Fest verbaut.
• Eingebaute Werkzeuge: Datei-Operationen, Suche, Websuche. Jedes Werkzeug bringt seine Beschreibung mit.
• Memory-Dateien: deine globale und deine projektbezogene CLAUDE.md, dazu eventuelle Rules-Dateien. Alles, was du an festen Regeln hinterlegt hast.
• Skills: die kurzen Beschreibungen aller bereitgehaltenen Abläufe.

Der Punkt ist: Ein Teil davon ist gesetzt, ein Teil liegt in deiner Hand. /context trennt für dich beides. Du siehst sofort, ob deine eigenen Dateien das Fenster aufblähen — und das ist der Hebel, an dem du drehen kannst.

Was du steuerst und was nicht

Den System-Prompt und die eingebauten Werkzeuge änderst du nicht. Sie sind Teil des Programms. Damit musst du leben, und das ist auch in Ordnung — der Anteil ist kalkulierbar.

Deine Memory-Dateien dagegen gehören dir. Hier entscheidest du, wie viel Platz sie wegnehmen. Eine Faustregel hilft: rund 200 Zeilen pro Datei als Obergrenze. Was darüber hinausgeht, prüfst du kritisch. Braucht Claude diese Regel wirklich in jeder Sitzung? Oder steht sie nur da, weil sie dir einmal wichtig schien?

Jede Zeile in einer Memory-Datei liest Claude bei jedem Start mit. Eine überladene Datei kostet doppelt: Sie frisst Platz, und sie verwässert die Regeln, auf die es ankommt. Schlank schlägt vollständig.

Subagents: Rohmaterial draußen halten

Manche Aufgaben verlangen, dass viel Material gesichtet wird — eine Recherche, eine Analyse über Dutzende Dateien, das Durchsuchen eines großen Berichts. Wenn das alles in deine Hauptsitzung fließt, ist das Fenster schnell voll mit Rohmaterial, das du gar nicht im Detail brauchst.

Hier helfen Subagents. Ein Subagent arbeitet in seinem eigenen Kontextfenster, getrennt von deinem. Er wühlt sich durch das Material und gibt nur das verdichtete Ergebnis zurück — die Erkenntnis, nicht den Aktenberg. Dein Haupt-Kontext bleibt schlank.

Ein Beispiel aus dem Alltag: Du willst wissen, welche von 40 Verträgen eine bestimmte Klausel enthalten. Lässt du Claude alle 40 in der Hauptsitzung lesen, ist das Fenster danach verstopft. Schickst du einen Subagent los, kommt eine kurze Liste zurück — und du arbeitest mit freiem Kopf weiter. Für Analyse und Recherche ist das die sauberste Lösung.

/compact: aufräumen, aber mit Bedacht

Läuft eine Sitzung doch lang, kann Claude den bisherigen Verlauf zusammenfassen, um Platz zu schaffen. Das passiert auf zwei Wegen: per Befehl /compact, wenn du es auslöst, oder automatisch, wenn das Fenster zu voll wird. Aus dem langen Verlauf wird eine kompakte Zusammenfassung, der Rest des Speichers ist wieder frei.

Das hat einen Preis. Beim Zusammenfassen gehen Details verloren — eine Zahl, eine Entscheidung, ein Zwischenstand, der dir später fehlt. Verlass dich nicht darauf, dass Claude das Richtige behält.

Sichere das Wesentliche vorher. Halte den Stand in einer eigenen Fortschrittsdatei fest, am besten automatisch über einen Hook, der genau vor dem Zusammenfassen anspringt. So überlebt das Wichtige die Verdichtung, auch wenn der Wortlaut des Verlaufs verschwindet.

Eine Karte, kein Handbuch

Der größte Fehler bei Anweisungsdateien ist gut gemeint: Man will gründlich sein und schreibt ein halbes Handbuch. Das Ergebnis kippt ins Gegenteil. Ein 100-seitiges Dokument verwirrt Claude mehr, als es hilft — es ist genau der Heuhaufen, in dem die Nadel verschwindet.

Gib dem Agenten stattdessen eine Karte. Eine knappe Übersicht, wo was liegt und welche Regeln gelten. Wo finde ich die Vorlagen? Wie ist das Projekt aufgebaut? Was darf nie passieren? Kurz, gegliedert, auf das Nötige beschränkt. Die Details holt sich Claude bei Bedarf — eine gute Karte zeigt nur, wo sie liegen.

Ein zu großes CLAUDE.md ist kein Zeichen von Sorgfalt, sondern ein Risiko. Weniger Text, klar strukturiert, schlägt jeden vollgeschriebenen Wälzer.

Über Sitzungen hinweg: die Brücke bauen

Eines musst du wissen: Claude startet jede Sitzung ohne Erinnerung an die vorige. Was gestern besprochen wurde, ist heute weg. Das fühlt sich anfangs unpraktisch an, schützt dich aber genau vor dem Context Rot, das eine endlos laufende Sitzung schwächt.

Die Brücke über diese Lücke baust du selbst, und sie ist einfach. Ein schlichtes Fortschrittsdokument plus deine Git-Historie reicht aus. Im Fortschrittsdokument steht, wo das Projekt steht und was als Nächstes ansteht. Die Git-Historie zeigt, was bereits geändert wurde. Zusammen geben sie der neuen Sitzung in Sekunden den Stand zurück.

Ein praktischer Kniff dazu: Teile große Aufgaben in kleine, abgeschlossene Einheiten. Jede Einheit passt in eine Sitzung und liefert ein fertiges Ergebnis. Solche Aufgabenlisten speicherst du besser als JSON-Datei statt in reinem Text. Der Grund ist erfahrungsgesetzt — das Modell überschreibt eine strukturierte JSON-Datei seltener versehentlich als eine lockere Liste in Markdown.

So behältst du den Kontext im Griff

Kontextmanagement klingt technisch, läuft aber auf wenige Gewohnheiten hinaus. Wer sie sich aneignet, arbeitet ruhiger und bekommt verlässlichere Ergebnisse.

1. Prüfe mit /context, was dein Fenster vor der Arbeit schon belegt.
2. Halte deine Memory-Dateien schlank — als Karte gedacht, nicht als Handbuch.
3. Lagere Recherche und Analyse an Subagents aus, statt das Hauptfenster zu fluten.
4. Erkenne das Schwächeln einer langen Sitzung und starte neu, statt durchzuhalten.
5. Sichere den Stand in einer Fortschrittsdatei, bevor du zusammenfasst oder die Sitzung wechselst.

Der Unterschied zwischen einem frustrierenden und einem produktiven Tag mit Claude Code liegt selten in der Aufgabe selbst. Er liegt darin, ob das richtige Wissen im Speicher steht und der Rest draußen bleibt. Wenn du herausfinden willst, wie sich diese Arbeitsweise in deinem Unternehmen verankern lässt, klären wir das am schnellsten im direkten Gespräch.