CLAUDE.md e il singolo file che determina come Claude capisce il tuo progetto. Uno ben scritto significa meno correzioni, codice migliore e agenti che sanno davvero su cosa stanno lavorando.
Questa guida ti accompagna attraverso ogni sezione di un file CLAUDE.md, dalle dichiarazioni dello stack tecnologico ai suggerimenti specifici per agente. Seguila e costruisci il tuo passo passo.
CLAUDE.md e un file markdown che posizioni alla radice del tuo progetto. Quando Claude Code avvia una sessione, legge prima questo file. Tutto al suo interno diventa parte del contesto di Claude: il tuo stack tecnologico, la struttura dei file, le convenzioni del team e qualsiasi istruzione specifica che vuoi che ogni agente segua.
Pensalo come un documento di briefing. Senza, Claude deve indovinare come e organizzato il tuo progetto. Con uno buono, Claude sa gia dove si trovano le cose, quali pattern seguire e cosa evitare. La differenza nella qualita dell'output e significativa.
“Un investimento di 10 minuti in CLAUDE.md risparmia ore di correzione del codice generato dall'AI che non corrisponde ai pattern del tuo progetto.”
Osservato su centinaia di progetti Claude Code
La struttura e la specificita del tuo CLAUDE.md impattano direttamente su quanto bene Claude performa nel tuo codebase.
Un CLAUDE.md ben strutturato copre queste sei aree. Ognuna da a Claude informazioni concrete su cui agire immediatamente.
Elenca framework, librerie e le loro versioni esplicitamente. Includi il tuo package manager, versione Node e qualsiasi requisito di runtime. Claude usa queste informazioni per generare codice compatibile senza indovinare.
Descrivi le directory chiave e cosa contiene ognuna. Componenti, store, servizi, route API, tipi. Un breve diagramma ad albero con descrizioni di una riga per cartella funziona bene.
Documenta i pattern di naming (camelCase per i file, PascalCase per i componenti), l'approccio alla gestione errori, l'ordinamento delle import e qualsiasi regola specifica del progetto. Questo mantiene l'output di Claude consistente con il codice esistente.
Includi i comandi dev, build, test e lint. Quando Claude ha bisogno di verificare che qualcosa funzioni o suggerire uno script, usera i comandi esatti che il tuo progetto si aspetta.
Se usi piu agenti (QA, frontend, backend, DevOps), aggiungi una sezione che descrive su cosa dovrebbe concentrarsi ogni ruolo. Particolarmente utile con la configurazione multi-agente di AgentsRoom.
Di' a Claude cosa NON fare. Non modificare i file di configurazione, non cambiare il sistema di autenticazione, non ristrutturare il layer database. Confini espliciti impediscono agli agenti di fare modifiche indesiderate.
Non hai bisogno di scrivere tutto in una volta. Inizia con le basi e espandi man mano che scopri cosa Claude ha bisogno di sapere.
Apri il package.json e elenca ogni framework, libreria e strumento che il tuo progetto usa. Nota le versioni. Controlla i requisiti di runtime (versione Node, versione Python, database). Questo diventa la sezione stack tecnologico.
package.json + versioni runtime + database
Esegui un rapido tree della directory src. Identifica le cartelle di primo livello e scrivi una descrizione di una riga per ognuna. Concentrati su dove si trovano componenti, store, servizi, tipi e route API.
albero src/ con annotazioni sullo scopo
Guarda il codice esistente e nota i pattern: come nomini i file, come gestisci gli errori, come strutturi le import, se usi export default o named. Scrivi queste come regole brevi.
Naming, import, gestione errori, export
Se lavori con agenti specializzati, aggiungi aree di focus per ogni ruolo. L'agente frontend dovrebbe conoscere la tua libreria di componenti. L'agente DevOps dovrebbe conoscere la tua pipeline di deploy. L'agente QA dovrebbe conoscere il tuo framework di test.
Aree di focus per ruolo + aree da evitare
AgentsRoom e costruito attorno a CLAUDE.md come concetto di prima classe, non come ripensamento.
Modifica il tuo CLAUDE.md direttamente dentro AgentsRoom con evidenziazione della sintassi e salvataggio in tempo reale. Niente passare al tuo editor di testo o IDE.
Vedi come ogni agente interpreta il tuo CLAUDE.md in tempo reale. Guarda l'output del terminale per verificare che gli agenti seguano le tue convenzioni e rispettino le aree da evitare.
Ogni progetto in AgentsRoom ha il proprio CLAUDE.md. Passa tra i progetti e ogni agente carica automaticamente il file di contesto corretto per quel codebase.
I 14 ruoli agente di AgentsRoom si abbinano direttamente con le sezioni CLAUDE.md. Definisci aree di focus e aree da evitare per ruolo, e ogni agente raccoglie esattamente le istruzioni destinate a lui.
Scarica AgentsRoom e usa l'editor CLAUDE.md integrato per dare ai tuoi agenti il contesto di cui hanno bisogno. Istruzioni migliori, codice migliore.
App companion: monitora i tuoi agenti in movimento
Compatibile con qualsiasi piano Claude (Free, Pro, Max, Team, Enterprise)