CLAUDE.md e file di memoria di Claude Code, spiegati

Claude Code usa file Markdown per le sue istruzioni e la sua memoria. Gli dai le istruzioni in CLAUDE.md. Tiene i propri appunti nei file di memoria. E quando glielo chiedi, scrive pianificazioni, specifiche e report come file .md nel tuo progetto. Questa pagina mostra dove si trova ciascun file e come leggerli comodamente.

I file che Claude Code legge

FileDoveA cosa serve
Istruzioni utente~/.claude/CLAUDE.mdLe tue preferenze, in ogni progetto
Istruzioni del progetto./CLAUDE.md o ./.claude/CLAUDE.mdLe regole del team, condivise tramite Git
Istruzioni locali./CLAUDE.local.mdI 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):

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)