I file che Claude Code legge
| File | Dove | A cosa serve |
|---|---|---|
| Istruzioni utente | ~/.claude/CLAUDE.md | Le tue preferenze, in ogni progetto |
| Istruzioni del progetto | ./CLAUDE.md o ./.claude/CLAUDE.md | Le regole del team, condivise tramite Git |
| Istruzioni locali | ./CLAUDE.local.md | I tuoi appunti per un solo progetto; aggiungilo a .gitignore |
| Regole | .claude/rules/*.md (un progetto) o ~/.claude/rules/ (tutti i progetti) | Un argomento per file; può essere limitato a certi percorsi |
Come vengono caricati. Claude Code legge CLAUDE.md e CLAUDE.local.md nella cartella in cui lo avvii e in ogni cartella sopra di essa. Vengono combinati, non sostituiti: dalla cartella più in alto in giù, quindi il file nella cartella in cui hai avviato viene letto per ultimo. Un CLAUDE.md in una sottocartella viene caricato quando Claude inizia a lavorare con i file lì.
Importazioni. Una riga come @docs/style.md porta un altro file dentro il tuo CLAUDE.md.
Mantienilo breve. La documentazione suggerisce meno di 200 righe per ogni CLAUDE.md. Sposta le regole per argomento in .claude/rules/.
AGENTS.md
Se un progetto ha un AGENTS.md (il file che leggono Codex e altri agenti) e nessun CLAUDE.md o CLAUDE.local.md, Claude Code legge invece AGENTS.md. Se esistono entrambi, per impostazione predefinita legge solo CLAUDE.md. Per usare un solo file per entrambi, importalo: metti @AGENTS.md nel tuo CLAUDE.md. Altro su AGENTS.md: pagina su Codex.
Memoria automatica: gli appunti che Claude scrive da solo
La memoria automatica è attiva per impostazione predefinita. Mentre lavora, Claude Code salva appunti su di te, sui tuoi riscontri, sul progetto e su dove trovare le cose. Si trovano in:
~/.claude/projects/<project>/memory/
MEMORY.md lì dentro è l'indice; le prime 200 righe (o 25 KB) vengono caricate all'inizio di ogni sessione. Puoi attivare o disattivare la memoria automatica con il comando /memory.
Sono normali file Markdown che puoi leggere e modificare. Controllali di tanto in tanto: un appunto sbagliato influisce su ogni nuova sessione finché non lo correggi o lo elimini.
Leggere questi file su Mac
Su Mac, PilcrowMD (gratuita, beta):
- Aggiungi la cartella del tuo progetto in Le mie cartelle. I file che Claude Code scrive, come pianificazioni, specifiche e report, compaiono contrassegnati con N (nuovo) o U (aggiornato). Una nota aperta si ricarica quando Claude Code o un'altra app la modifica.
- Evidenzia modifiche mostra cosa è cambiato in un file che hai già letto: blu per ciò che è aggiunto, arancione per ciò che è rimosso o modificato. Comodo per un
MEMORY.mdo per una pianificazione che Claude continua ad aggiornare. - Confronta affiancate mostra due versioni. Con la cronologia dei file attivata, File › Mostra cronologia… ti permette di tornare a una versione precedente.
~/.claudeè una cartella nascosta. Nel pannello Apri, premi ⌘⇧. (Comando-Maiusc-punto) per mostrare le cartelle nascoste.- Nessuna connessione a internet; i tuoi appunti restano sul tuo Mac.
PilcrowMD per Mac (beta) · Altro sulla lettura dei file degli agenti
Domande frequenti
Claude ignora il mio CLAUDE.md. Perché? Esegui /context in una sessione e controlla che sia elencato sotto i file di memoria (Memory files). I file lunghi o contraddittori vengono seguiti con meno affidabilità.
CLAUDE.local.md deve finire in Git? No, è per i tuoi appunti personali. Aggiungilo a .gitignore.
Posso leggere questi file sul telefono? Se la cartella del progetto si sincronizza con Google Drive, aggiungila in Le mie cartelle in PilcrowMD per Android. Apri una nota per vederne l'ultima versione; su Android non c'è il ricaricamento in tempo reale.
Anche su Mac: PilcrowMD per Mac (beta)