Claude Code

Claude Code vergisst den Kontext: Was hilft wirklich

Du warst eine Stunde an einem Fehler. Den Cache hast du ausgeschlossen, die echte Ursache gefunden, einen Umweg abgesprochen. Dann kürzt Claude Code das Gespräch, und schon schlägt es den Weg vor, den du vor einer Stunde verworfen hast.

Claude Code vergisst den Kontext nicht aus Versehen. Beim Kürzen wird der Verlauf zu einer Zusammenfassung, und Einzelheiten überleben nur, wenn die Zusammenfassung sie enthält. Diese Seite zeigt, was laut Doku bleibt und wie du den Rest behältst.

Warum vergisst Claude Code den Kontext, auch ohne /compact?

Zwei Dinge sind getrennt, und sie werden oft vermischt. Erstens: Jede neue Sitzung beginnt mit einem leeren Kontextfenster. Die Doku sagt es so: „Each Claude Code session begins with a fresh context window.“ Zweitens: Wird das Fenster in einer langen Sitzung voll, oder rufst du /compact auf, fasst Claude Code das Gespräch zusammen.

In beiden Fällen bleibt, was von der Festplatte neu geladen wird. Alles andere hängt an der Zusammenfassung. Wenn sie falsch rät, kommt der verworfene Weg zurück. Menschen beschreiben das im Fehlerverfolger von Claude Code, zum Beispiel in anthropics/claude-code #17428 (auf Englisch).

Was bleibt nach /compact, was nicht?

Die Doku von Claude Code listet jede Art von Inhalt auf. Gekürzt auf das, was beim Programmieren zählt:

WasNach dem Kürzen
CLAUDE.md im Projektstamm und Regeln ohne PfadangabeWird von der Festplatte neu geladen
Auto Memory (Notizen, die Claude selbst schreibt)Wird von der Festplatte neu geladen
Der Plan aus dem Plan-ModusWird von der Festplatte neu geladen
Regeln mit paths im Kopf, verschachtelte CLAUDE.mdWerden bei Bedarf neu geladen
Dateien, die Claude gelesen oder geändert hatLiest bis zu fünf neu, die zuletzt geänderten zuerst
Kontext, den ein Hook früher im Gespräch ergänzt hatWird mit dem Rest des Gesprächs zusammengefasst
SessionStart-Hooks, die zur Quelle compact passenLaufen erneut, ihre Ausgabe kommt in den gekürzten Kontext

Übersetzt und gekürzt aus What survives compaction in der Claude-Code-Doku, Stand 5. November 2026.

Nur zusammengefasst wird alles, was ausschließlich im Gespräch existierte. Beim Programmieren ist das oft der Teil, für den du am meisten gearbeitet hast:

  • die Ursache, die du nach einer Stunde Logs gefunden hast,
  • die Wege, die du ausprobiert und verworfen hast,
  • eine abgesprochene Umgehung und der Grund dafür,
  • Kontext, den ein Hook früher im Gespräch ergänzt hat. Die Doku führt ihn als „mit dem Rest des Gesprächs zusammengefasst“.

Wie behält Claude Code den Kontext? Vier Wege

  1. Mit Schwerpunkt kürzen. Rufe /compact selbst auf und gib Anweisungen mit, bevor die automatische Kürzung zuschlägt, zum Beispiel /compact focus on the auth bug fix. Die Zusammenfassung behält, was du nennst.
  2. In die CLAUDE.md schreiben. Die CLAUDE.md im Projektstamm wird nach dem Kürzen neu gelesen. Die Doku rät, dort Anweisungen zu ergänzen, die nur im Gespräch standen, und jede Datei unter 200 Zeilen zu halten: Längeres kostet Kontext und wird schlechter befolgt.
  3. Per SessionStart-Hook zurückholen. Ein Hook mit dem Matcher compact läuft direkt nach dem Kürzen, und seine Ausgabe landet im neuen Kontext:
    .claude/settings.json
    {
      "hooks": {
        "SessionStart": [
          {
            "matcher": "compact",
            "hooks": [
              { "type": "command", "command": "cat .claude/after-compact.md" }
            ]
          }
        ]
      }
    }
  4. Auto Memory mitschreiben lassen. Claude legt beim Arbeiten Notizen für sich an, und sie werden nach dem Kürzen neu geladen. Vom Index kommen die ersten 200 Zeilen oder 25 KB, und die Notizen bleiben auf einem Rechner.

Warum reichen Anweisungen nicht für Erfahrung?

Die vier Wege sind gut für Anweisungen: eine Regel, eine Konvention, der Plan für heute. Schlechter passen sie zu Erfahrung, also den vielen einzelnen Dingen, die ihr lernt: warum das Ausrollen bei voller Platte scheitert, welcher Schalter den Bau bricht, welche Migration zuerst laufen muss.

Erfahrung wächst jede Woche. In der CLAUDE.md liegt sie bald über 200 Zeilen, und das meiste davon betrifft den Satz nicht, den du gerade tippst. Besser ist, für jede Eingabe die passenden Notizen nachzuschlagen. Das kann ein UserPromptSubmit-Hook (Anleitung auf Englisch). Er läuft auch bei der ersten Eingabe nach dem Kürzen, die Notiz ist also genau dann wieder da, wenn du sie brauchst. Was eine brauchbare Notiz enthält, steht in Lessons learned for coding agents (Englisch).

Was ergänzt cachly?

cachly hält diese Erfahrung außerhalb des Gesprächs fest, sodass kein Kürzen sie wegfassen kann:

  • Endet ein Zug mit einem Fix, speichert der Stop-Hook von cachly ihn als Lektion: Ursache, was nicht ging, der Befehl, der lief. Den Stop-Hook gibt es im Plugin für Claude Code.
  • Vor jeder Eingabe ergänzt der Hook bis zu drei passende Lektionen. Die erste Eingabe nach /compact bekommt sie wie jede andere.
  • Lektionen liegen in deiner Instanz, nicht auf einem Rechner. Sie gelten in Claude Code, Cursor, Copilot und anderen Editoren und für dein ganzes Team.
Claude Code
/plugin marketplace add cachly-dev/cachly-mcp
/plugin install cachly-brain@cachly

Schalte danach einmal das Auto-Update ein: /plugin → Marketplaces → cachly → Enable auto-update. Claude Code lässt es für Marktplätze außerhalb von Anthropic aus, und die Hooks werden nur mit dem Plugin aktualisiert.

Der Speicher liegt bei Hetzner in Nürnberg. Was deinen Rechner verlässt und wohin es geht (Englisch).

Häufige Fragen

Vergisst Claude Code nach /compact meine CLAUDE.md?

Nein. Die CLAUDE.md im Projektstamm wird nach dem Kürzen neu von der Festplatte geladen. Verloren geht, was nur im Gespräch stand: die gefundene Ursache, verworfene Wege und abgesprochene Umgehungen. Das fasst Claude Code zusammen, und die Zusammenfassung ist nur so gut wie ihre Auswahl.

Wie lang darf die CLAUDE.md sein?

Die Doku von Claude Code rät zu unter 200 Zeilen pro Datei. Längere Dateien kosten Kontext, und Claude befolgt sie schlechter. Was darüber hinausgeht, gehört in Regeln mit Pfadangabe, in Skills oder in einen Hook.

Merkt sich Claude Code etwas von einer Sitzung zur nächsten?

Nur, was beim Start geladen wird: deine CLAUDE.md-Dateien und die Notizen von Auto Memory. Das Gespräch selbst beginnt jedes Mal leer. Auto Memory liegt auf einem Rechner und gilt für ein Repository. Ein Fix samt Ursache steht dort oft nicht drin.

Brauche ich cachly, damit Claude Code den Kontext behält?

Nein. Die vier Wege oben funktionieren ohne cachly und reichen für Regeln und Absprachen. cachly lohnt sich, wenn Erfahrung wächst, also viele einzelne Fixes mit Ursache und Irrwegen, die auf mehreren Rechnern, in mehreren Editoren und im Team gelten sollen.

Wo speichert cachly meine Lektionen?

Jede Instanz hat ihren eigenen Speicher bei Hetzner in Nürnberg. Die Schnittstelle api.cachly.dev läuft hinter Cloudflare, einer US-Firma, die Anfragen durchreicht. Was genau den Rechner verlässt, steht auf der Seite zum EU-Server (auf Englisch).

Quellen

Alle drei Quellen sind englisch. Zitate sind von uns übersetzt.

Weiterlesen: KI wiederholt denselben Fehler · Cursor merkt sich nichts · Diese Seite auf Englisch