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.
Determinare il tipo di memoria
Claude Code offre tre posizioni di memoria, ognuna con uno scopo diverso:
Tipo di Memoria | Posizione | Scopo | Esempi di Casi d’Uso |
---|---|---|---|
Memoria del progetto | ./CLAUDE.md | Istruzioni condivise dal team per il progetto | Architettura del progetto, standard di codifica, flussi di lavoro comuni |
Memoria utente | ~/.claude/CLAUDE.md | Preferenze personali per tutti i progetti | Preferenze di stile del codice, scorciatoie di strumenti personali |
Memoria del progetto (locale) | ./CLAUDE.local.md | Preferenze 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:
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.
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 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 #
:
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:
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.