Claude Code può ricordare le tue preferenze attraverso le sessioni, come le linee guida di stile e i comandi comuni nel tuo flusso di lavoro.

Determinare il tipo di memoria

Claude Code offre tre posizioni di memoria, ognuna con uno scopo diverso:

Tipo di MemoriaPosizioneScopoEsempi di Casi d’Uso
Memoria del progetto./CLAUDE.mdIstruzioni condivise dal team per il progettoArchitettura del progetto, standard di codifica, flussi di lavoro comuni
Memoria utente~/.claude/CLAUDE.mdPreferenze personali per tutti i progettiPreferenze di stile del codice, scorciatoie di strumenti personali
Memoria del progetto (locale)./CLAUDE.local.mdPreferenze personali specifiche del progetto(Deprecato, vedi sotto) I tuoi URL sandbox, dati di test preferiti

Tutti i file di memoria vengono caricati automaticamente nel contesto di Claude Code quando viene avviato.

Importazioni CLAUDE.md

I file CLAUDE.md possono importare file aggiuntivi utilizzando la sintassi @path/to/import. Il seguente esempio importa 3 file:

Vedi @README per la panoramica del progetto e @package.json per i comandi npm disponibili per questo progetto.

# Istruzioni Aggiuntive
- flusso di lavoro git @docs/git-instructions.md

Sono consentiti sia percorsi relativi che assoluti. In particolare, importare file nella directory home dell’utente è un modo conveniente per i membri del tuo team di fornire istruzioni individuali che non sono registrate nel repository. Precedentemente CLAUDE.local.md serviva a uno scopo simile, ma ora è deprecato a favore delle importazioni poiché funzionano meglio attraverso più worktree git.

# Preferenze Individuali
- @~/.claude/my-project-instructions.md

Per evitare potenziali collisioni, le importazioni non vengono valutate all’interno di span di codice markdown e blocchi di codice.

Questo span di codice non sarà trattato come un'importazione: `@anthropic-ai/claude-code`

I file importati possono importare ricorsivamente file aggiuntivi, con una profondità massima di 5 salti. Puoi vedere quali file di memoria sono caricati eseguendo il comando /memory.

Come Claude cerca le memorie

Claude Code legge le memorie ricorsivamente: partendo dalla cwd, Claude Code ricorre fino a / e legge qualsiasi file CLAUDE.md o CLAUDE.local.md che trova. Questo è particolarmente conveniente quando si lavora in repository grandi dove esegui Claude Code in foo/bar/, e hai memorie sia in foo/CLAUDE.md che in foo/bar/CLAUDE.md.

Claude scoprirà anche CLAUDE.md annidati in sottoalberi sotto la tua directory di lavoro corrente. Invece di caricarli all’avvio, vengono inclusi solo quando Claude legge file in quei sottoalberi.

Aggiungi rapidamente memorie con la scorciatoia #

Il modo più veloce per aggiungere una memoria è iniziare il tuo input con il carattere #:

# Usa sempre nomi di variabili descrittivi

Ti verrà richiesto di selezionare in quale file di memoria memorizzare questo.

Modifica direttamente le memorie con /memory

Usa il comando slash /memory durante una sessione per aprire qualsiasi file di memoria nel tuo editor di sistema per aggiunte o organizzazione più estese.

Configura la memoria del progetto

Supponiamo che tu voglia configurare un file CLAUDE.md per memorizzare informazioni importanti del progetto, convenzioni e comandi usati frequentemente.

Avvia un CLAUDE.md per la tua base di codice con il seguente comando:

> /init 

Suggerimenti:

  • Includi comandi usati frequentemente (build, test, lint) per evitare ricerche ripetute
  • Documenta le preferenze di stile del codice e le convenzioni di denominazione
  • Aggiungi pattern architetturali importanti specifici per il tuo progetto
  • Le memorie CLAUDE.md possono essere utilizzate sia per istruzioni condivise con il tuo team che per le tue preferenze individuali.

Migliori pratiche per la memoria

  • Sii specifico: “Usa indentazione a 2 spazi” è meglio di “Formatta il codice correttamente”.
  • Usa la struttura per organizzare: Formatta ogni memoria individuale come un punto elenco e raggruppa le memorie correlate sotto intestazioni markdown descrittive.
  • Rivedi periodicamente: Aggiorna le memorie man mano che il tuo progetto evolve per assicurarti che Claude stia sempre utilizzando le informazioni e il contesto più aggiornati.