CLAUDE.md

CLAUDE.md è un file markdown di istruzioni persistenti che Claude legge all'INIZIO di ogni sessione. Posizioni verificate, in ordine di caricamento dal più generale al più specifico: policy gestita (/Library/Application Support/ClaudeCode/CLAUDE.md su macOS, /etc/claude-code/CLAUDE.md su Linux e WSL, C:\Program Files\ClaudeCode\CLAUDE.md su Windows); istruzioni utente (~/.claude/CLAUDE.md); istruzioni di progetto (./CLAUDE.md o ./.claude/CLAUDE.md); istruzioni locali (./CLAUDE.local.md, che dovrebbe essere ignorato da git). Tutti i file scoperti vengono CONCATENATI nel contesto anziché sovrascriversi a vicenda, risalendo l'albero delle directory dalla directory di lavoro. I file possono importarne altri con la sintassi @path/to/import, relativa al file che importa, con una profondità massima di quattro salti. Tuttavia, le importazioni non salvano il contesto, poiché anche i file importati vengono caricati al lancio. Obiettivo sotto le 200 righe: file più lunghi consumano più contesto e riducono l'aderenza.

Fatto meccanico chiave: il contenuto di CLAUDE.md viene fornito come messaggio utente DOPO il prompt di sistema, non come parte di esso. Claude lo legge e cerca di seguirlo, ma non vi è alcuna garanzia di conformità rigorosa. È contesto, non configurazione imposta. Per bloccare un'azione indipendentemente da ciò che Claude decide, usa invece un hook PreToolUse. Esegui /init per generare un CLAUDE.md iniziale. CLAUDE.md nella root del progetto sopravvive alla compattazione: dopo /compact, Claude lo rilegge dal disco e lo reinserisce. Questo meccanismo è correlato a come i file agents-md forniscono istruzioni persistenti per gli agenti. A differenza di un file di configurazione rigoroso, CLAUDE.md funziona più come un insieme di linee guida all'interno della context-window, influenzando il comportamento ma non imponendolo rigidamente. Consideralo una forma di auto-memory che persiste tra le sessioni.