Passa al contenuto principale

CLAUDE.md e file di memoria

Principiante

Se fai una sola cosa per migliorare Claude Code, fai questa. CLAUDE.md è un file di testo semplice che Claude legge all'inizio di ogni sessione: il briefing permanente del tuo progetto.

What you'll learn
  • Perché CLAUDE.md è l'impostazione di Claude Code con il maggior impatto
  • Come la gerarchia della memoria si fonde dal globale allo specifico per progetto
  • Come generare un file di partenza con /init e snellirlo
  • Cosa va in CLAUDE.md e cosa tenerne fuori
  • Come gli @import ti permettono di riferire documenti senza duplicarli

Perché è l'impostazione con il maggior impatto​

Senza di esso, devi rispiegare il tuo progetto a ogni sessione ("usiamo pnpm, i test sono in __tests__, non toccare /generated…"). Con esso, Claude lo sa già. Buone istruzioni qui migliorano ogni interazione futura in un colpo solo.

La gerarchia della memoria​

Claude Code legge la memoria da diversi punti e li fonde, all'incirca dal più globale al più specifico:

  • Memoria utente — le tue preferenze personali su ogni progetto.
  • Memoria di progetto (./CLAUDE.md, sotto commit) — come funziona questo repo. Condivisa con il tuo team.
  • Annidata — metti un CLAUDE.md in una sottocartella per regole che valgono solo lì.
Conosci i tuoi livelli di memoria
Premi Invio o Spazio per girare la carta. Usa le frecce sinistra e destra per spostarti tra le carte.Termine mostrato.
1 / 4

Genera un punto di partenza​

Guided walkthrough1 of 3
  1. Claude ispeziona il codice e redige un CLAUDE.md per te in automatico.

Genera una bozza di CLAUDE.md

/init

Recupera uno starter già pronto da Template CLAUDE.md.

Cosa metterci dentro​

  • Cos'è il progetto, in due frasi.
  • Lo stack tecnologico e come eseguire / testare / fare il lint.
  • Convenzioni che Claude non può dedurre (nomenclatura, struttura, stile dei commit).
  • Protezioni: "esegui i test prima di dichiarare concluso", "non modificare mai /vendor", "non committare mai segreti".

Cosa NON metterci dentro​

Watch out
  • Claude segue CLAUDE.md alla lettera: istruzioni obsolete, vaghe o velleitarie fanno attivamente danni.
  • Descrivi come il progetto funziona realmente oggi; breve e veritiero batte lungo e ambizioso.
  • Evita documenti incollati giganteschi (usa invece gli @import), i segreti e le regole che in realtà non segui.
  • Rivedilo periodicamente in modo che resti accurato man mano che il progetto evolve.

Import​

Includi i documenti esistenti invece di duplicarli: ad esempio, riferisci la tua guida di stile con un import @path/to/file così da avere un'unica fonte autorevole. Vedi la documentazione ufficiale sulla memoria per la sintassi esatta.

Pro tip
  • Un'unica fonte autorevole: riferisci un file con gli @import invece di incollarne il contenuto in CLAUDE.md.
  • Se un documento esiste già, collegalo: non copiarlo. Le copie si disallineano col tempo.

Mettiti alla prova​

Mettiti alla prova

0/3
  1. Quale file legge Claude Code all'inizio di ogni sessione come briefing permanente del tuo progetto?
  2. Cosa fa l'esecuzione di /init in un progetto?
  3. Qual è il modo consigliato per includere un documento esistente di grandi dimensioni come una guida di stile?
Key takeaways
  • CLAUDE.md è l'impostazione con il maggior impatto: migliora ogni sessione futura in un colpo solo.
  • La memoria si fonde dal globale allo specifico: policy enterprise, poi i file CLAUDE.md utente, di progetto e annidati.
  • Inizia con /init, poi snellisci la bozza fino a ciò che è davvero vero.
  • Includi il riepilogo del progetto, i comandi run/test/lint, le convenzioni e le protezioni.
  • Tienilo breve e veritiero: usa gli @import per i documenti grandi e non committare mai segreti.

Avanti​