Automatischer Speicher in Claude Code

Problem: Ihre CLAUDE.md ist mit Projektregeln versehen, aber Claude fragt immer wieder die gleichen Dinge über Build-Befehle, Testkonventionen und seltsame Debugging-Macken. Die Anweisungen decken ab, was Claude tun soll. Sie übersehen, was Claude bereits über Ihr Projektarchiv gelernt hat.

Schneller Erfolg: Prüfen Sie, ob der automatische Speicher bereits läuft. Führen Sie in einer beliebigen Claude-Code-Sitzung /memory aus. Es öffnet sich ein Selektor, der Ihre CLAUDE.md-Dateien und einen Schalter für den automatischen Speicher anzeigt. Die Umschaltfunktion ist standardmäßig aktiviert, was bedeutet, dass Claude im Stillen Projektnotizen für Sie gemacht hat.

# Find your project's auto memory directory
ls ~/.claude/projects/

Sind die Verzeichnisse aufgelistet? Claude hält Notizen bereit. Lesen Sie weiter, um zu erfahren, was in diese Verzeichnisse gehört, wie man mit ihnen arbeitet und wie sie mit Ihrem CLAUDE.md-System zusammenarbeiten. Wenn sich Ihre Speicherdateien nach vielen Sitzungen aufgebläht anfühlen, werfen Sie einen Blick auf Auto Dream, die Konsolidierungsfunktion, die alles, was Auto Memory schreibt, aufräumt und reorganisiert.

Was Auto Memory eigentlich ist

Auto-Memory ist ein dauerhafter Ordner, in dem Claude während der Arbeit Gelerntes, Muster und Erkenntnisse protokolliert. Hier ist die wichtigste Aufteilung: CLAUDE.md sind Ihre Anweisungen an Claude. MEMORY.md sind die Notizen, die Claude sich selbst über Ihr Projekt macht.

CLAUDE.md ist der Ort, an dem Sie Dinge schreiben wie "benutze pnpm, nicht npm" oder "schreibe Tests vor dem Code." Auto memory ist der Ort, an dem Claude seine eigenen Beobachtungen notiert: "build command is pnpm build, tests live in __tests__/, API uses Express with middleware in src/middleware/."

Verwechseln Sie dies nicht mit dem Sitzungsspeicher, der Zusammenfassungen auf Konversationsebene für den sitzungsübergreifenden Abruf speichert. Der automatische Speicher arbeitet eine Ebene tiefer. Es speichert dauerhaftes Projektwissen, das unabhängig von der Konversation, in der es erstellt wurde, erhalten bleibt.

Drei Speichersysteme, Seite an Seite

Claude Code verfügt jetzt über drei verschiedene Speichersysteme. Wenn Sie wissen, auf welches Sie zugreifen müssen, vermeiden Sie, dass Sie die gleiche Arbeit zweimal machen oder das falsche Werkzeug wählen.

Im besten Fall werden alle drei Optionen zusammen verwendet. CLAUDE.md legt die Regeln fest. Der automatische Speicher zeichnet auf, was Claude auf dem Weg lernt. Der Sitzungsspeicher hält den Faden zwischen den Sitzungen fest.

Wo die Dateien leben

Jedes Projekt erhält seinen eigenen Speicherordner, der im Stammverzeichnis des Git-Repos verankert ist:

~/.claude/projects/<project>/memory/
├── MEMORY.md          # Main index, loaded every session
├── debugging.md       # Detailed debugging patterns
├── api-conventions.md # API design decisions
└── ...                # Any topic files Claude creates

Ein paar wissenswerte Details zur Lagerung:

• Das Stammverzeichnis des Git-Repos definiert den Projektpfad. Alle Unterverzeichnisse innerhalb desselben Repos teilen sich einen Speicherordner. Führen Sie Claude von src/api/ aus und Sie treffen auf den gleichen Speicher wie beim Ausführen von der Repo-Root.
• Git-Arbeitsbäume erhalten jeweils einen eigenen Ordner Das ist beabsichtigt. Verschiedene Worktrees enthalten normalerweise verschiedene Zweige in verschiedenen Zuständen.
• Außerhalb eines Git-Repo spielt das Arbeitsverzeichnis die Rolle des Stammverzeichnisses des Repo.

Was aufgeschrieben wird

Während Claude an Ihrem Projekt arbeitet, legt es Notizen unter einigen Kategorien ab:

Projektmuster: Build-Befehle, Testkonventionen, Wahl des Codestils. Führen Sie Ihre Testsuite einmal aus, und Claude zeichnet den Befehl sowie alle benötigten Spezialflags auf.

Einblicke in die Fehlersuche: Korrekturen für knifflige Bugs und häufige Fehlerursachen. Verbringen Sie Zeit mit der Suche nach einem CORS-Problem oder einem Webpack-Konfigurationsknoten? Claude schreibt die Lösung auf.

Hinweise zur Architektur: Schlüsseldateien, Zusammenhänge zwischen Modulen, wichtige Abstraktionen. Claude kartiert das Territorium einmal, damit er Ihr Layout nicht bei jeder Sitzung neu entdecken muss.

Ihre Vorlieben: wie Sie kommunizieren, Ihre Arbeitsgewohnheiten, die Wahl Ihrer Werkzeuge. Claude merkt sich die Muster, auf die Sie sich stützen.

die Datei MEMORY.md funktioniert wie ein kurzer Index. Wenn sich die Notizen häufen, verschiebt Claude die Details in thematische Dateien wie debugging.md oder patterns.md. Das hält die Hauptdatei unter 200 Zeilen, da nur die ersten 200 Zeilen beim Starten geladen werden.

Wie man es benutzt

Einfach laufen lassen

Der einfachste Weg: Lassen Sie es einfach laufen. Der automatische Speicher ist standardmäßig aktiviert. Claude liest und schreibt Speicherdateien im Hintergrund, während Sie arbeiten. Sie werden es während der Sitzung bemerken, wenn Claude Dateien im Speicherordner berührt.

Etwas Bestimmtes speichern

Sagen Sie Claude ganz genau, was er speichern soll:

"remember that we use pnpm, not npm"
"save to memory that the API tests require a local Redis instance"
"note that the staging environment uses port 3001"

Claude legt diese sofort in der richtigen Speicherdatei ab.

Durchsuchen und bearbeiten

Führen Sie während einer Sitzung /memory aus, um den Speicherdatei-Selektor zu öffnen. Dieser listet alle Speicherdateien auf (CLAUDE.md, auto memory, local config) und lässt Sie jede davon in Ihrem Systemeditor öffnen.

Sie können sie auch von der Shell aus lesen:

# List all memory files for a project
ls ~/.claude/projects/<project>/memory/
 
# Read the main memory index
cat ~/.claude/projects/<project>/memory/MEMORY.md
 
# Read a specific topic file
cat ~/.claude/projects/<project>/memory/debugging.md

Dies sind einfache Markdown-Dateien. Sie können sie jederzeit bearbeiten. Löschen Sie Einträge, die veraltet sind. Reorganisieren Sie sie, wenn das Projekt wächst.

Konfiguration und Kontrolle

Der automatische Speicher ist standardmäßig aktiviert. Hier finden Sie alle Regler, an denen Sie drehen können:

Pro-Sitzung-Umschaltung

Führen Sie /memory aus und drehen Sie den Schalter für den automatischen Speicher um. Das ist der schnellste Weg, um sie für Ihren aktuellen Arbeitsablauf ein- oder auszuschalten.

Für jedes Projekt ausschalten

Geben Sie dies in Ihren Benutzereinstellungen ein:

// ~/.claude/settings.json
{ "autoMemoryEnabled": false }

Kill It For One Projekt

Geben Sie dies in den Projekteinstellungen ein:

// .claude/settings.json
{ "autoMemoryEnabled": false }

Umgebungsvariable außer Kraft setzen

cLAUDE_CODE_DISABLE_AUTO_MEMORY" übertrifft jede andere Einstellung. Sie ist die richtige Wahl für CI-Pipelines, Automatisierung und verwaltete Bereitstellungen:

export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1  # Force off
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=0  # Force on

Dies setzt sowohl den /memory Toggle als auch die settings.json außer Kraft, so dass es wie ein harter Kill Switch funktioniert.

Wann nach was greifen

Drei Speichersysteme, ein Entscheidungsrahmen:

Greifen Sie zu CLAUDE.md, wenn Sie feste Regeln wollen. Codierungsstandards, Architekturaufrufe, erforderliche Befehle, Teamkonventionen. CLAUDE.md wird beim Starten vollständig geladen und hat hohe Priorität. Wenn Sie wollen, dass ein Muster jedes Mal befolgt wird, kommt es hierher.

Greifen Sie auf den automatischen Speicher zu, wenn Sie wollen, dass Claude die Dinge nach und nach aufnimmt. Muster, die bei der eigentlichen Arbeit auftauchen, Fehlerbehebungen, ruhige Einstellungen. Sie müssen nicht alles im Voraus planen.

**Greifen Sie auf den Sitzungsspeicher zurück, wenn Sie eine kontinuierliche Konversation benötigen. Der Sitzungsspeicher hält fest, was Sie in jeder Sitzung besprochen und beschlossen haben. Es ist die "Was haben wir gestern gemacht"-Ebene.

Greifen Sie auf das Regelverzeichnis zu, wenn Ihre CLAUDE.md über eine Datei hinausgewachsen ist. Teilen Sie Ihre Anweisungen in konzentrierte Dateien unter .claude/rules/ auf, um eine sauberere Struktur zu erhalten, ohne die Priorität zu verlieren.

Die Überschneidungen sind gewollt. Der automatische Speicher nimmt die Dinge auf, die Sie vergessen haben, in CLAUDE.md einzutragen. Der Sitzungsspeicher enthält den Kontext, den Notizen auf Projektebene nicht haben. Wenn man sie übereinander legt, erhält man einen mehrschichtigen Speicher, der Regeln, Projektwissen und Gesprächsverlauf abdeckt.

Bewährte Praktiken

Halten Sie MEMORY.md unter 200 Zeilen. Nur die ersten 200 Zeilen werden beim Start geladen. Claude soll sich kurz fassen, indem er Details in Themendateien verschiebt. Wenn Sie von Hand editieren, halten Sie sich an dieselbe Obergrenze.

Überprüfen Sie Ihre Speicherdateien von Zeit zu Zeit. Wie alle Notizen werden sie veraltet. Nach einem großen Refactor oder einer Architekturänderung sollten Sie die Dateien durchsehen und löschen, was nicht mehr stimmt.

Doppeln Sie nicht zwischen CLAUDE.md und auto memory. Wenn etwas eine Regel sein muss, schreiben Sie es in CLAUDE.md. Wenn es sich um ein Muster handelt, das sich ändern könnte, überlassen Sie es dem automatischen Speicher.

Speichern Sie das kritische Zeug explizit. Wenn Sie einen bösen Bug knacken oder einen großen Architekturaufruf sperren, sagen Sie Claude, dass er sich das merken soll. Verlassen Sie sich nicht darauf, dass Claude alles von selbst findet.

Schalten Sie den automatischen Speicher in CI aus. Automatisierung braucht Claude nicht, um Notizen über Ihre Buildbox zu stapeln. Setzen Sie CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 in Ihrer CI-Konfiguration.

Verbinden Sie es mit Kontext-Engineering. Der automatische Speicher ist eine Ebene einer größeren Kontext-Engineering-Strategie. Je mehr Sie darauf achten, was Claude beim Start weiß, desto mehr gibt jede Sitzung zurück.

Nächste Schritte

• Richten Sie Ihr CLAUDE.md Speichersystem für persistente Projektanweisungen ein
• Verstehen des Sitzungsspeichers für sitzungsübergreifende Gesprächskontinuität
• Lernen Sie Strategien zur Kontextverwaltung, um innerhalb der Tokengrenzen zu arbeiten
• Erforschen Sie das Regelverzeichnis für modulare Projektanweisungen
• Lesen Sie mehr über Kontext-Engineering für AI-Speichersysteme in der Produktion

Das automatische Gedächtnis schließt die Lücke zwischen dem, was Sie Claude sagen, und dem, was Claude von selbst herausfindet. CLAUDE.md besitzt die "Mach es so"-Regeln. Das Auto-Memory besitzt das "Das ist mir bei deinem Projekt aufgefallen"-Wissen. Wenn Sie beide zusammen verwenden, müssen Sie sich weniger erklären und können mehr liefern.