CLAUDE.md (Claude Code): dove si trova e come lo leggono gli strumenti

CLAUDE.md è il file di memoria che Claude Code carica all'avvio dalla directory home, dal progetto e da ogni directory superiore. Le regole specifiche per percorso in .claude/rules/ forniscono indicazioni aggiuntive, caricate solo quando vengono letti file corrispondenti.

Dove si trova

• Progetto: ./CLAUDE.md o ./.claude/CLAUDE.md, versionato e condiviso con il team.
• Locale: ./CLAUDE.local.md, per note personali da non includere in git.
• Utente: ~/.claude/CLAUDE.md, applicato a ogni progetto.
• Regole: ./.claude/rules/**/*.md e ~/.claude/rules/**/*.md, con ambito facoltativo definito tramite frontmatter paths.
• Policy gestita: /Library/Application Support/ClaudeCode/CLAUDE.md su macOS, C:\Program Files\ClaudeCode\CLAUDE.md su Windows oppure la chiave claudeMd in managed-settings.json.

Formato

Markdown. I file in .claude/rules/ possono iniziare con un frontmatter YAML in cui la chiave paths elenca i glob. Includi altri file con @path/to/file, fino a 4 livelli di profondità; non è documentato alcun limite rigido alle dimensioni, ma Anthropic consiglia di non superare 200 righe per file.

Chiavi del frontmatter: 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à e unione

Nessun file prevale sugli altri: tutti i file individuati vengono concatenati. La policy gestita viene caricata per prima, poi i file dal filesystem, dalla radice fino alla directory di avvio; di conseguenza, i file più vicini vengono letti per ultimi. Nella stessa directory, CLAUDE.local.md viene letto dopo CLAUDE.md. I file nelle sottodirectory vengono caricati su richiesta, quando Claude vi legge dei file; la policy gestita non può essere esclusa con claudeMdExcludes.

Strumenti che lo leggono

Suggerimenti

• Se usi CLAUDE.md, inserisci @AGENTS.md all'inizio; altrimenti Claude Code ignora AGENTS.md con l'impostazione predefinita.
• Sposta le indicazioni specifiche per area in .claude/rules/ e usa il frontmatter paths per caricarle solo per i file interessati.
• Le importazioni organizzano il file, ma consumano comunque contesto, perché viene caricato anche il testo importato.
• Esegui /doctor per controllare CLAUDE.md, CLAUDE.local.md, AGENTS.md, le regole e le skill in un'unica operazione.

Altri file di istruzioni