Gestisci la memoria di Claude
Impara come gestire la memoria di Claude Code attraverso le sessioni con diverse posizioni di memoria e migliori pratiche.
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 Memoria | Posizione | Scopo | Esempi di Casi d’Uso | Condiviso Con |
---|---|---|---|---|
Policy aziendale | macOS: /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/DevOps | Standard di codifica aziendale, policy di sicurezza, requisiti di conformità | Tutti gli utenti nell’organizzazione |
Memoria del progetto | ./CLAUDE.md | Istruzioni condivise dal team per il progetto | Architettura del progetto, standard di codifica, flussi di lavoro comuni | Membri del team tramite controllo del codice sorgente |
Memoria utente | ~/.claude/CLAUDE.md | Preferenze personali per tutti i progetti | Preferenze di stile del codice, scorciatoie per strumenti personali | Solo tu (tutti i progetti) |
Memoria del progetto (locale) | ./CLAUDE.local.md | Preferenze personali specifiche del progetto | (Deprecato, vedi sotto) I tuoi URL sandbox, dati di test preferiti | Solo 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:
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.
Per evitare potenziali collisioni, le importazioni non vengono valutate all’interno di span di codice markdown e blocchi di codice.
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 #
:
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:
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:
- 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
- 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.