CLAUDE.md (Claude Code): Speicherort und Verwendung durch Tools

CLAUDE.md ist die Memory-Datei, die Claude Code beim Start aus deinem Home-Verzeichnis, dem Projekt und jedem übergeordneten Verzeichnis lädt. Pfadbezogene Regeln in .claude/rules/ enthalten zusätzliche Hinweise, die nur beim Lesen passender Dateien geladen werden.

Speicherort

• Projekt: ./CLAUDE.md oder ./.claude/CLAUDE.md; wird committet und mit dem Team geteilt.
• Lokal: ./CLAUDE.local.md für persönliche Notizen, die nicht in Git eingecheckt werden.
• Benutzer: ~/.claude/CLAUDE.md; gilt für jedes Projekt.
• Regeln: ./.claude/rules/**/*.md und ~/.claude/rules/**/*.md; optional mit paths-Frontmatter auf bestimmte Pfade beschränkt.
• Verwaltete Richtlinie: /Library/Application Support/ClaudeCode/CLAUDE.md unter macOS, C:\Program Files\ClaudeCode\CLAUDE.md unter Windows oder der Schlüssel claudeMd in managed-settings.json.

Format

Markdown. Dateien in .claude/rules/ können mit YAML-Frontmatter beginnen, dessen Schlüssel paths Globs enthält. Binden Sie weitere Dateien mit @path/to/file ein, bis zu einer Tiefe von 4 Ebenen. Eine feste Größenbegrenzung ist nicht dokumentiert, Anthropic empfiehlt jedoch, unter 200 Zeilen pro Datei zu bleiben.

Frontmatter-Schlüssel: paths

@AGENTS.md

# Claude Code notes

- Run `pnpm test` after every change under src/.
- Use the `gh` CLI for issues and pull requests.
- Ask before adding a dependency.

## API

- Error format is described in @docs/api-errors.md.
- One handler file per route in src/api/.

Priorität und Zusammenführung

Nichts wird überschrieben: Alle gefundenen Dateien werden aneinandergehängt. Zuerst wird die verwaltete Richtlinie geladen, danach die Dateien vom Dateisystem-Stammverzeichnis abwärts bis zum Startverzeichnis. Dateien in tiefer liegenden Verzeichnissen werden also zuletzt eingelesen. Innerhalb eines Verzeichnisses folgt CLAUDE.local.md auf CLAUDE.md. Dateien in Unterverzeichnissen werden bei Bedarf geladen, wenn Claude dort Dateien liest. Die verwaltete Richtlinie lässt sich nicht mit claudeMdExcludes ausschließen.

Tools, die die Datei lesen

Tipps

• Wenn Sie eine CLAUDE.md verwenden, beginnen Sie sie mit @AGENTS.md. Andernfalls ignoriert Claude Code AGENTS.md in der Standardeinstellung.
• Verschieben Sie bereichsspezifische Hinweise nach .claude/rules/ und ergänzen Sie ein paths-Frontmatter, damit sie nur für die betreffenden Dateien geladen werden.
• Imports strukturieren die Datei, verbrauchen aber weiterhin Kontext, da auch der importierte Text geladen wird.
• Führen Sie /doctor aus, um CLAUDE.md, CLAUDE.local.md, AGENTS.md, Regeln und Skills in einem Durchgang zu prüfen.

Weitere Instruktionsdateien