CLAUDE.md (Claude Code): waar het staat en hoe tools het lezen

CLAUDE.md is het geheugenbestand dat Claude Code bij het starten laadt uit je thuismap, het project en elke bovenliggende map. Regels in .claude/rules/ kunnen aan specifieke paden worden gekoppeld en worden alleen geladen wanneer overeenkomende bestanden worden gelezen.

Locatie

• Project: ./CLAUDE.md of ./.claude/CLAUDE.md, opgenomen in Git en gedeeld met het team.
• Lokaal: ./CLAUDE.local.md, voor persoonlijke notities die buiten Git blijven.
• Gebruiker: ~/.claude/CLAUDE.md, van toepassing op elk project.
• Regels: ./.claude/rules/**/*.md en ~/.claude/rules/**/*.md, eventueel beperkt tot specifieke paden via frontmatter.
• Beheerd beleid: /Library/Application Support/ClaudeCode/CLAUDE.md op macOS, C:\Program Files\ClaudeCode\CLAUDE.md op Windows, of de sleutel claudeMd in managed-settings.json.

Indeling

Markdown. Bestanden in .claude/rules/ kunnen beginnen met YAML-frontmatter waarvan de sleutel paths globs bevat. Voeg andere bestanden toe met @path/to/file, tot maximaal 4 niveaus diep. Er is geen harde limiet voor de bestandsgrootte gedocumenteerd, maar Anthropic adviseert om onder de 200 regels per bestand te blijven.

Frontmatter-sleutels: 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/.

Prioriteit en samenvoegen

Er wordt niets overschreven: elk gevonden bestand wordt samengevoegd. Beheerd beleid wordt als eerste geladen, gevolgd door bestanden vanaf de hoofdmap van het bestandssysteem tot aan de startmap. Bestanden dichter bij de startmap worden dus als laatste gelezen. Binnen een map wordt CLAUDE.local.md na CLAUDE.md gelezen. Bestanden in submappen worden op verzoek geladen wanneer Claude daar bestanden leest. Beheerd beleid kan niet worden uitgesloten met claudeMdExcludes.

Tools die het bestand lezen

Tips

• Als je een CLAUDE.md gebruikt, begin die dan met @AGENTS.md; anders negeert Claude Code AGENTS.md met de standaardinstelling.
• Verplaats richtlijnen voor specifieke onderdelen naar .claude/rules/ en gebruik paths-frontmatter, zodat ze alleen voor die bestanden worden geladen.
• Imports houden het bestand overzichtelijk, maar kosten nog steeds context: de geïmporteerde tekst wordt ook geladen.
• Voer /doctor uit om CLAUDE.md, CLAUDE.local.md, AGENTS.md, rules en skills in één keer te controleren.

Andere instructiebestanden