Vai al contenuto principale
Claude Code può ricordare le tue preferenze tra 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
Politica 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, politiche di sicurezza, requisiti di conformitàTutti gli utenti dell’organizzazione
Memoria del progetto./CLAUDE.md o ./.claude/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 di 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 al lancio. 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 utilizzando la sintassi @path/to/import. L’esempio seguente importa 3 file:
Vedi @README per una 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 team di fornire istruzioni individuali che non sono archiviate nel repository. In precedenza CLAUDE.local.md serviva a uno scopo simile, ma ora è deprecato a favore delle importazioni poiché funzionano meglio su più worktree git.
# Preferenze individuali
- @~/.claude/my-project-instructions.md
Per evitare potenziali collisioni, le importazioni non vengono valutate all’interno di intervalli di codice markdown e blocchi di codice.
Questo intervallo di codice non verrà trattato come un'importazione: `@anthropic-ai/claude-code`
I file importati possono importare ricorsivamente file aggiuntivi, con una profondità massima di 5 hop. Puoi vedere quali file di memoria vengono caricati eseguendo il comando /memory.

Come Claude cerca le memorie

Claude Code legge le memorie ricorsivamente: iniziando nella cwd, Claude Code ricorre verso l’alto fino a (ma non includendo) la directory radice / e legge tutti i file CLAUDE.md o CLAUDE.local.md che trova. Questo è particolarmente conveniente quando si lavora in repository di grandi dimensioni dove si esegue Claude Code in foo/bar/, e si hanno 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 al lancio, vengono inclusi solo quando Claude legge file in quei sottoalberi.

Aggiungi rapidamente memorie con il collegamento #

Il modo più veloce per aggiungere una memoria è iniziare il tuo input con il carattere #:
# Usa sempre nomi di variabili descrittivi
Ti verrà chiesto di selezionare quale file di memoria archiviare 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

Supponiamo che tu voglia configurare un file CLAUDE.md per archiviare informazioni importanti del progetto, convenzioni e comandi utilizzati di frequente. La memoria del progetto può essere archiviata in ./CLAUDE.md o ./.claude/CLAUDE.md. Avvia un CLAUDE.md per la tua base di codice con il seguente comando:
> /init 
Suggerimenti:
  • Includi comandi utilizzati di frequente (build, test, lint) per evitare ricerche ripetute
  • Documenta le preferenze di stile del codice e le convenzioni di denominazione
  • Aggiungi importanti modelli architettonici specifici del tuo progetto
  • Le memorie CLAUDE.md possono essere utilizzate sia per le 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.

Best practice della memoria

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