Die Dateien, die Claude Code liest
| Datei | Wo | Wofür |
|---|---|---|
| Benutzeranweisungen | ~/.claude/CLAUDE.md | deine Vorlieben, in jedem Projekt |
| Projektanweisungen | ./CLAUDE.md oder ./.claude/CLAUDE.md | Die Regeln des Teams, über Git geteilt |
| Lokale Anweisungen | ./CLAUDE.local.md | deine 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):
- Füge deinen Projektordner hinzu unter Meine Ordner. Dateien, die Claude Code schreibt, etwa Pläne, Spezifikationen und Berichte, erscheinen mit N (neu) oder U (aktualisiert) markiert. Eine geöffnete Notiz wird neu geladen, wenn Claude Code oder eine andere App sie ändert.
- Änderungen hervorheben zeigt, was sich in einer Datei geändert hat, die du schon gelesen hast: blau für hinzugefügt, orange für entfernt oder bearbeitet. Praktisch für eine
MEMORY.mdoder einen Plan, den Claude laufend aktualisiert. - Nebeneinander vergleichen zeigt zwei Versionen. Bei eingeschaltetem Dateiverlauf kannst du mit Ablage › Verlauf anzeigen … zu einer früheren Version zurückgehen.
~/.claudeist ein versteckter Ordner. Drücke im Öffnen-Dialog ⌘⇧. (Befehl-Umschalt-Punkt), um versteckte Ordner anzuzeigen.- Keine Internetverbindung; deine Notizen bleiben auf deinem Mac.
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)