CLAUDE.md und Memory-Dateien von Claude Code, erklärt

Claude Code nutzt Markdown-Dateien für seine Anweisungen und sein Gedächtnis. Anweisungen gibst du ihm in CLAUDE.md. Seine eigenen Notizen legt es in Memory-Dateien ab. Und wenn du darum bittest, schreibt es Pläne, Spezifikationen und Berichte als .md-Dateien in dein Projekt. Diese Seite zeigt, wo jede Datei liegt und wie du sie bequem liest.

Die Dateien, die Claude Code liest

DateiWoWofür
Benutzeranweisungen~/.claude/CLAUDE.mddeine Vorlieben, in jedem Projekt
Projektanweisungen./CLAUDE.md oder ./.claude/CLAUDE.mdDie Regeln des Teams, über Git geteilt
Lokale Anweisungen./CLAUDE.local.mddeine eigenen Notizen für ein Projekt; füge die Datei zu .gitignore hinzu
Regeln.claude/rules/*.md (ein Projekt) oder ~/.claude/rules/ (alle Projekte)Ein Thema pro Datei; kann auf bestimmte Pfade beschränkt werden

So werden sie geladen. Claude Code liest CLAUDE.md und CLAUDE.local.md in dem Ordner, in dem du es startest, und in jedem Ordner darüber. Sie werden kombiniert, nicht ersetzt: vom obersten Ordner abwärts, sodass die Datei in dem Ordner, in dem du gestartet hast, zuletzt gelesen wird. Eine CLAUDE.md in einem Unterordner wird geladen, wenn Claude beginnt, mit Dateien dort zu arbeiten.

Importe. Eine Zeile wie @docs/style.md holt eine andere Datei in deine CLAUDE.md.

Halte es kurz. Die Dokumentation empfiehlt weniger als 200 Zeilen pro CLAUDE.md. Verschiebe Regeln zu einzelnen Themen nach .claude/rules/.

AGENTS.md

Wenn ein Projekt eine AGENTS.md hat (die Datei, die Codex und andere Agenten lesen) und keine CLAUDE.md oder CLAUDE.local.md, liest Claude Code stattdessen die AGENTS.md. Wenn beide existieren, liest es standardmäßig nur CLAUDE.md. Um eine Datei für beide zu verwenden, importiere sie: Schreibe @AGENTS.md in deine CLAUDE.md. Mehr zu AGENTS.md: Seite zu Codex.

Auto Memory: die Notizen, die Claude selbst schreibt

Auto Memory ist standardmäßig eingeschaltet. Bei der Arbeit speichert Claude Code Notizen über dich, dein Feedback, das Projekt und darüber, wo man was findet. Sie liegen in:

~/.claude/projects/<project>/memory/

MEMORY.md dort ist das Inhaltsverzeichnis; die ersten 200 Zeilen (oder 25 KB) werden zu Beginn jeder Sitzung geladen. Mit dem Befehl /memory kannst du Auto Memory ein- oder ausschalten.

Das sind einfache Markdown-Dateien, die du lesen und bearbeiten kannst. Schaue ab und zu hinein: Eine falsche Notiz wirkt sich auf jede neue Sitzung aus, bis du sie korrigierst oder löschst.

Diese Dateien auf dem Mac lesen

Auf dem Mac, mit PilcrowMD (kostenlos, Beta):

PilcrowMD für Mac (Beta) · Mehr zum Lesen von Agentendateien

Häufige Fragen

Claude ignoriert meine CLAUDE.md. Warum? Führe /context in einer Sitzung aus und prüfe, ob sie unter „Memory files“ aufgeführt ist. Lange oder widersprüchliche Dateien werden weniger zuverlässig befolgt.

Sollte CLAUDE.local.md in Git? Nein, sie ist für deine eigenen Notizen. Füge sie zu .gitignore hinzu.

Kann ich diese Dateien auf meinem Smartphone lesen? Wenn der Projektordner mit Google Drive synchronisiert wird, füge ihn in PilcrowMD für Android unter „Meine Ordner“ hinzu. Öffne eine Notiz, um ihren neuesten Stand zu sehen; auf Android gibt es kein Live-Neuladen.

Auch für Mac: PilcrowMD für Mac (Beta)