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.

Determina il tipo di memoria

Claude Code offre quattro posizioni di memoria in una struttura gerarchica, ognuna con uno scopo diverso:

Tipo di MemoriaPosizioneScopoEsempi di Casi d’UsoCondiviso Con
Policy aziendalemacOS: /Library/Application Support/ClaudeCode/CLAUDE.md
Linux: /etc/claude-code/CLAUDE.md
Windows: C:\ProgramData\ClaudeCode\CLAUDE.md
Istruzioni a livello organizzativo gestite da IT/DevOpsStandard di codifica aziendale, policy di sicurezza, requisiti di conformitàTutti gli utenti nell’organizzazione
Memoria del progetto./CLAUDE.mdIstruzioni condivise dal team per il progettoArchitettura del progetto, standard di codifica, flussi di lavoro comuniMembri del team tramite controllo del codice sorgente
Memoria utente~/.claude/CLAUDE.mdPreferenze personali per tutti i progettiPreferenze di stile del codice, scorciatoie per strumenti personaliSolo tu (tutti i progetti)
Memoria del progetto (locale)./CLAUDE.local.mdPreferenze personali specifiche del progetto(Deprecato, vedi sotto) I tuoi URL sandbox, dati di test preferitiSolo tu (progetto corrente)

Tutti i file di memoria vengono caricati automaticamente nel contesto di Claude Code quando viene avviato. I file più in alto nella gerarchia hanno la precedenza e vengono caricati per primi, fornendo una base su cui si costruiscono memorie più specifiche.

Importazioni CLAUDE.md

I file CLAUDE.md possono importare file aggiuntivi usando 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 vengono inserite 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 vengono caricati eseguendo il comando /memory.

Come Claude cerca le memorie

Claude Code legge le memorie ricorsivamente: partendo dalla cwd, Claude Code risale ricorsivamente fino alla (ma non inclusa) directory root / e legge tutti i 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 organizzazioni più estese.

Configura la memoria del progetto

Supponi di voler 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 usate sia per istruzioni condivise con il tuo team che per le tue preferenze individuali.

Gestione della memoria a livello organizzativo

Le organizzazioni aziendali possono distribuire file CLAUDE.md gestiti centralmente che si applicano a tutti gli utenti.

Per configurare la gestione della memoria a livello organizzativo:

  1. Crea il file di memoria aziendale nella posizione appropriata per il tuo sistema operativo:
  • macOS: /Library/Application Support/ClaudeCode/CLAUDE.md
  • Linux/WSL: /etc/claude-code/CLAUDE.md
  • Windows: C:\ProgramData\ClaudeCode\CLAUDE.md
  1. Distribuisci tramite il tuo sistema di gestione della configurazione (MDM, Group Policy, Ansible, ecc.) per garantire una distribuzione coerente su tutte le macchine degli sviluppatori.

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 memorie correlate sotto intestazioni markdown descrittive.
  • Rivedi periodicamente: Aggiorna le memorie man mano che il tuo progetto evolve per assicurarti che Claude stia sempre usando le informazioni e il contesto più aggiornati.