Wenn der Chat zu lang wird

Was es ist und warum es zählt

Das kennst du bestimmt: Du arbeitest seit Stunden im selben Chat mit Claude Code, und irgendwann rutscht etwas weg. Es trifft eine Entscheidung wieder, die ihr schon verworfen hattet, vergisst eine Regel, die du ihm am Anfang gegeben hast, schlägt einen Versuch vor, der schon nicht funktioniert hat.

Der Grund ist das Kontextfenster, das Arbeitsgedächtnis von Claude. Da landet alles: deine Nachrichten, die Antworten, die gelesenen Dateien, die Ausgaben der Befehle, die CLAUDE.md. Wenn es sich der Grenze nähert, schafft Claude Code von selbst Platz: Zuerst wirft es alte Befehlsergebnisse raus, dann fasst es das Gespräch zusammen. Deine Anfragen und der wichtige Code bleiben. Genaue Anweisungen vom Anfang können verschwinden.

Und dann ist da noch der Verbrauch: Bei jeder Nachricht schickt Claude Code das ganze Gespräch erneut an das Modell. Je länger der Chat, desto mehr kostet dich jede Frage, auch eine von einer Zeile.

Ich mache es so: Wenn ich ein Stück fertig habe, lasse ich Claude zusammenfassen, wo wir stehen, lasse die Entscheidungen in eine Datei im Projekt schreiben und starte mit einem sauberen Chat neu. Das Wichtige steht in der Datei, nicht im Gespräch.

1. Der Zusammenfassungs-Prompt

Wenn du ein Stück Arbeit fertig hast (einen Bildschirm, eine Verbindung, eine Korrektur) und bevor du zum nächsten gehst, schreib das hier:

Fass in fünf Punkten zusammen, wo wir stehen: was wir entschieden haben, was erledigt ist, was fehlt, welche Probleme noch offen sind, welche Dateien wir angefasst haben. Dann aktualisiere ENTSCHEIDUNGEN.md mit den neuen Entscheidungen. Kein Code in der Zusammenfassung.

Die fünf Punkte geben dir ein vollständiges Bild der Arbeit, nicht nur vom letzten Schritt. „Welche Dateien wir angefasst haben“ hilft dir, wenn später etwas kaputtgeht: Du weißt, wo du suchen musst. „Kein Code in der Zusammenfassung“, weil der Code schon in den Dateien steht: Hier willst du verstehen, wo du stehst, nicht hundert Zeilen nachlesen.

Lies diese Zusammenfassung selbst. Wenn eine Entscheidung drinsteht, an die du dich nicht erinnerst, oder ein offenes Problem, das dir entgangen war, frag jetzt, solange der Chat noch da ist.

2. Die Entscheidungsdatei

Leg im Projektordner eine Datei ENTSCHEIDUNGEN.md an. Kurz, eine Zeile pro Entscheidung, mit dem Grund. Meine sieht so aus:

# Entscheidungen
## Login
- Nur mit E-Mail, kein Social Login (weniger zu pflegen)
## Profil
- Nur ein Foto, Name für alle sichtbar
## Nicht anfassen
- Die echte Datenbank: Getestet wird nur auf der Testdatenbank
## Offene Fragen
- Benachrichtigungen ja oder nein?

Die Abschnitte sind die Teile der App, dazu zwei, die ich immer nutze. „Nicht anfassen“ ist die Liste dessen, was Claude nicht ändern darf, ohne zu fragen: die echte Datenbank, die Zahlungen, was für dich heikel ist. „Offene Fragen“ sammelt, was noch nicht entschieden ist, damit Claude nicht für dich entscheidet und du die Fragen vor dir hast, wenn es so weit ist.

Der Grund ist der Teil, der zählt. In einer Woche sieht eine Entscheidung ohne Begründung wie ein Fehler aus, und Claude „repariert“ sie womöglich. Steht der Grund daneben, weiß es, warum es so ist.

Und halte sie kurz. Gleich lassen wir sie in jeder Session laden, und alles, was drinsteht, belegt jedes Mal Gedächtnis. Keine Protokolle: eine Zeile pro Entscheidung. Wenn eine offene Frage geklärt ist, schieb sie in den passenden Abschnitt. Wenn sich eine Entscheidung ändert, schreib die Zeile um, statt eine neue hinzuzufügen.

3. Sauber neu starten

Mit fertiger Zusammenfassung und aktualisierter Datei hast du in Claude Code zwei Wege.

/clear: ein neuer Chat

/clear öffnet ein neues, leeres Gespräch. Die Projektdateien fasst es nicht an, und der vorige Chat verschwindet nicht: Wenn du ihn brauchst, öffnest du ihn mit /resume wieder. Im neuen Chat schreibst du:

Lies ENTSCHEIDUNGEN.md und mach von dort aus weiter: Das nächste Stück ist [was fehlt].

Statt der eckigen Klammern schreibst du das nächste Stück in einem Satz, etwa „die Profilseite, nur der Teil mit dem Foto“. Wenn du die Zusammenfassung von vorhin hast, steht es schon unter „was fehlt“. So startet der neue Chat nur mit dem, was er braucht.

/compact: derselbe Chat, leichter

/compact fasst das Gespräch zusammen und schafft Platz, ohne es zu schließen. Du kannst ihm Anweisungen für die Zusammenfassung geben, direkt hinter den Befehl geschrieben. Ich sage ihm, was bleiben soll und was weg kann:

/compact behalte die Entscheidungen, was erledigt ist und was fehlt; lass die gescheiterten Versuche weg

Die automatische Zusammenfassung, die Claude Code von selbst macht, wenn das Gedächtnis fast voll ist, funktioniert genauso. Der Unterschied ist, wer auswählt: Dort entscheidet Claude Code, was wichtig ist, mit Anweisungen entscheidest du.

Welcher von beiden

Ich nehme /clear, wenn ich ein Stück fertig habe oder zu einer Arbeit wechsle, die nichts damit zu tun hat: Es startet von der Datei aus, ich weiß, was drinsteht, und es kostet nichts. /compact nehme ich, wenn ich mitten in einem Stück bin und den Faden des Gesprächs noch brauche. Denk daran, dass /compact nicht kostenlos ist: Zum Zusammenfassen muss es den ganzen Chat neu lesen, bei einem riesigen Chat ist das also eine große Anfrage.

/context: wie voll es ist

Wenn du sehen willst, wie voll das Gedächtnis ist, zeigt es dir /context: ein farbiges Raster mit allem, was Platz belegt, von der CLAUDE.md bis zu den gelesenen Dateien. Ich schaue es mir an, wenn Claude anfängt, Dinge zu verlieren, bevor ich entscheide, ob ich neu starte.

4. Bei jedem Start lesen lassen

Die CLAUDE.md ist die Anweisungsdatei des Projekts, die Claude Code am Anfang jeder Session lädt. Wenn du keine hast, leg sie im Hauptordner des Projekts an oder lass sie mit /init vorbereiten. Dann füg diese Zeile hinzu:

@ENTSCHEIDUNGEN.md

Mit dem @ davor wird die Datei zusammen mit der CLAUDE.md geladen, auch nach einem /clear. Und nach einer Verdichtung liest Claude Code die Haupt-CLAUDE.md des Projekts neu von der Festplatte, also kommen die Entscheidungen auch dann zurück. Der Pfad geht vom Ordner der CLAUDE.md aus: Wenn die beiden Dateien nebeneinander liegen, reicht der Name.

Darunter fügst du hinzu:

Wenn wir eine wichtige Entscheidung treffen, schreib sie in ENTSCHEIDUNGEN.md.

So wächst die Datei, während du arbeitest, nicht nur, wenn du daran denkst. Der Zusammenfassungs-Prompt am Ende eines Stücks bleibt die Kontrolle: Da siehst du, ob etwas fehlt. Und das „Lies ENTSCHEIDUNGEN.md“ nach einem /clear ist dann fast überflüssig, aber ich schreibe es trotzdem: Es sagt Claude, wo es weitergeht.

Gut zu wissen: Mit dem @ kommt ENTSCHEIDUNGEN.md in jede Session, auch wenn sie nicht gebraucht wird. Deshalb muss sie kurz bleiben. Dasselbe gilt für die CLAUDE.md: Die Dokumentation empfiehlt, sie unter 200 Zeilen zu halten.

Extra: Anweisungen für die automatische Zusammenfassung

Wenn auch die automatische Zusammenfassung das Richtige behalten soll, kannst du in die CLAUDE.md einen Abschnitt mit Anweisungen für die Verdichtung schreiben. Claude Code berücksichtigt ihn beim Zusammenfassen:

# Compact instructions
Wenn du das Gespräch zusammenfasst, behalte die Entscheidungen, was erledigt ist und was fehlt; lass die gescheiterten Versuche weg.

Die Regel: kurze Chats, lange Dateien. Den Chat wirfst du weg, die Datei bleibt.

Häufige Fehler

• Warten, bis der Chat von selbst voll ist: Die automatische Zusammenfassung wählt selbst aus, was bleibt. Mach am Ende eines Stücks die Zusammenfassung selbst und starte neu.
• /clear machen, ohne ENTSCHEIDUNGEN.md aktualisiert zu haben: Was ihr entschieden habt, steht nur im alten Chat. Erst der Zusammenfassungs-Prompt, dann /clear.
• Entscheidungen ohne Grund aufschreiben: Nach einer Woche sehen sie wie Fehler aus, und Claude „korrigiert“ sie womöglich. Schreib den Grund in Klammern dazu.
• ENTSCHEIDUNGEN.md wie ein Tagebuch wachsen lassen: Mit dem @ kommt sie in jede Session und belegt Gedächtnis. Eine Zeile pro Entscheidung, und wenn sich eine ändert, schreib diese Zeile um.
• /compact nutzen, um die Aufgabe zu wechseln: Du schleppst eine Zusammenfassung mit, die du nicht brauchst, und zahlst fürs Neulesen. Wenn du das Thema wechselst: /clear.

Checkliste

• ENTSCHEIDUNGEN.md liegt im Projektordner
• Jede Entscheidung hat ihren Grund
• Die CLAUDE.md enthält die Zeile @ENTSCHEIDUNGEN.md
• Am Ende eines Stücks nutze ich den Zusammenfassungs-Prompt
• Vor /clear ist die Datei aktuell
• /clear, wenn ich die Aufgabe wechsle, /compact nur mitten in einem Stück

Häufige Fragen