~/.claude nella tua home directory. Esegui il commit dei file di progetto su git per condividerli con il tuo team; i file in ~/.claude sono configurazioni personali che si applicano a tutti i tuoi progetti.
Su Windows, ~/.claude si risolve in %USERPROFILE%\.claude. Se imposti CLAUDE_CONFIG_DIR, ogni percorso ~/.claude in questa pagina si trova invece in quella directory.
La maggior parte degli utenti modifica solo CLAUDE.md e settings.json. Il resto della directory è facoltativo: aggiungi skills, rules o subagents secondo le tue necessità.
Esplora la directory
Fai clic sui file nell’albero per vedere cosa fa ciascuno, quando si carica e un esempio.Cosa non è mostrato
L’explorer copre i file che crei e modifichi. Alcuni file correlati si trovano altrove:| File | Posizione | Scopo |
|---|---|---|
managed-settings.json | A livello di sistema, varia in base al sistema operativo | Impostazioni applicate dall’azienda che non puoi ignorare. Vedi impostazioni gestite dal server. |
CLAUDE.local.md | Radice del progetto | Le tue preferenze private per questo progetto, caricate insieme a CLAUDE.md. Crealo manualmente e aggiungilo a .gitignore. |
| Plugin installati | ~/.claude/plugins | Marketplace clonati, versioni plugin installate e dati per plugin, gestiti dai comandi claude plugin. Le versioni orfane vengono eliminate 7 giorni dopo un aggiornamento o disinstallazione del plugin. Vedi plugin caching. |
~/.claude contiene anche dati che Claude Code scrive mentre lavori: trascrizioni, cronologia dei prompt, snapshot dei file, cache e log. Vedi dati dell’applicazione di seguito.
Scegli il file giusto
Diversi tipi di personalizzazione si trovano in file diversi. Usa questa tabella per trovare dove appartiene una modifica.| Vuoi | Modifica | Ambito | Riferimento |
|---|---|---|---|
| Dare a Claude il contesto del progetto e le convenzioni | CLAUDE.md | progetto o globale | Memory |
| Consentire o bloccare specifiche chiamate di strumenti | settings.json permissions o hooks | progetto o globale | Permissions, Hooks |
| Eseguire uno script prima o dopo le chiamate di strumenti | settings.json hooks | progetto o globale | Hooks |
| Impostare variabili di ambiente per la sessione | settings.json env | progetto o globale | Settings |
| Mantenere gli override personali fuori da git | settings.local.json | solo progetto | Settings scopes |
Aggiungere un prompt o una capacità che invochi con /name | skills/<name>/SKILL.md | progetto o globale | Skills |
| Definire un subagent specializzato con i suoi strumenti | agents/*.md | progetto o globale | Subagents |
| Orchestrare molti subagent da uno script | workflows/*.js | progetto o globale | Dynamic workflows |
| Connettere strumenti esterni su MCP | .mcp.json | solo progetto | MCP |
| Cambiare il modo in cui Claude formatta le risposte | output-styles/*.md | progetto o globale | Output styles |
Riferimento dei file
Questa tabella elenca ogni file che l’explorer copre. I file con ambito di progetto si trovano nel tuo repository sotto.claude/ (o alla radice per CLAUDE.md, .mcp.json e .worktreeinclude). I file con ambito globale si trovano in ~/.claude/ e si applicano a tutti i progetti.
Diverse cose possono ignorare quello che metti in questi file:
- Le impostazioni gestite distribuite dalla tua organizzazione hanno la precedenza su tutto
- I flag CLI come
--permission-modeo--settingsignoranosettings.jsonper quella sessione - Alcune variabili di ambiente hanno la precedenza sulla loro impostazione equivalente, ma questo varia: controlla il riferimento delle variabili di ambiente per ciascuna
| File | Ambito | Commit | Cosa fa | Riferimento |
|---|---|---|---|---|
CLAUDE.md | Progetto e globale | ✓ | Istruzioni caricate ogni sessione | Memory |
rules/*.md | Progetto e globale | ✓ | Istruzioni con ambito di argomento, facoltativamente controllate dal percorso | Rules |
settings.json | Progetto e globale | ✓ | Permessi, hooks, variabili di ambiente, impostazioni predefinite del modello | Settings |
settings.local.json | Solo progetto | I tuoi override personali, auto-gitignored | Settings scopes | |
.mcp.json | Solo progetto | ✓ | Server MCP condivisi dal team | MCP scopes |
.worktreeinclude | Solo progetto | ✓ | File ignorati da git da copiare nei nuovi worktrees | Worktrees |
skills/<name>/SKILL.md | Progetto e globale | ✓ | Prompt riutilizzabili invocati con /name o auto-invocati | Skills |
commands/*.md | Progetto e globale | ✓ | Prompt a file singolo; stesso meccanismo delle skills | Skills |
output-styles/*.md | Progetto e globale | ✓ | Sezioni di prompt di sistema personalizzate | Output styles |
agents/*.md | Progetto e globale | ✓ | Definizioni di subagent con il loro prompt e strumenti | Subagents |
workflows/*.js | Progetto e globale | ✓ | Script di workflow dinamici scritti da Claude e salvati da /workflows; ogni file diventa un comando /<name> | Dynamic workflows |
agent-memory/<name>/ | Progetto e globale | ✓ | Memoria persistente per i subagents | Persistent memory |
~/.claude.json | Solo globale | Stato dell’app, OAuth, toggle dell’interfaccia utente, server MCP personali | Global config | |
projects/<project>/memory/ | Solo globale | Auto memory: note di Claude a se stesso tra le sessioni | Auto memory | |
keybindings.json | Solo globale | Scorciatoie da tastiera personalizzate | Keybindings | |
themes/*.json | Solo globale | Temi di colore personalizzati | Custom themes |
Risolvi i problemi di configurazione
Se un’impostazione, un hook o un file non sta avendo effetto, vedi Debug della tua configurazione per i comandi di ispezione e una tabella di ricerca per sintomi.Dati dell’applicazione
Oltre alla configurazione che crei,~/.claude contiene dati che Claude Code scrive durante le sessioni. Questi file sono in testo semplice. Qualsiasi cosa che passa attraverso uno strumento finisce in una trascrizione su disco: contenuti di file, output di comandi, testo incollato.
Puliti automaticamente
I file nei percorsi di seguito vengono eliminati all’avvio una volta che sono più vecchi dicleanupPeriodDays. L’impostazione predefinita è 30 giorni.
Percorso sotto ~/.claude/ | Contenuti |
|---|---|
projects/<project>/<session>.jsonl | Trascrizione della conversazione completa: ogni messaggio, chiamata di strumento e risultato dello strumento |
projects/<project>/<session>/subagents/ | Trascrizioni di conversazione Subagent, rimosse con la trascrizione della sessione padre quando scade |
projects/<project>/<session>/tool-results/ | Output di strumenti di grandi dimensioni versati in file separati |
file-history/<session>/ | Snapshot pre-modifica dei file che Claude ha modificato, utilizzati per il ripristino del checkpoint |
plans/ | File di piano scritti durante la Plan Mode |
debug/ | Log di debug per sessione, scritti solo quando inizi con --debug o esegui /debug |
paste-cache/, image-cache/ | Contenuti di incollamenti di grandi dimensioni e immagini allegate |
session-env/ | Metadati di ambiente per sessione |
tasks/ | Elenchi di attività per sessione scritti dagli strumenti di attività |
shell-snapshots/ | Ambiente shell acquisito utilizzato dallo strumento Bash. Rimosso all’uscita pulita. La pulizia cancella qualsiasi cosa rimasta dopo un arresto anomalo. |
backups/ | Copie con timestamp di ~/.claude.json prese prima delle migrazioni di configurazione |
feedback-bundles/ | Archivi di trascrizione redatti scritti da /feedback su provider di terze parti, per l’invio al tuo team di account Anthropic |
todos/, statsig/, logs/ | Directory legacy da versioni precedenti. Non più scritte. La pulizia rimuove i loro contenuti e poi la directory vuota. |
Mantenuti fino a quando non li elimini
I seguenti percorsi non sono coperti dalla pulizia automatica e persistono indefinitamente.Percorso sotto ~/.claude/ | Contenuti |
|---|---|
history.jsonl | Ogni prompt che hai digitato, con timestamp e percorso del progetto. Utilizzato per il richiamo con freccia su. |
stats-cache.json | Conteggi aggregati di token e costi mostrati da /usage |
remote-settings.json | Copia memorizzata nella cache delle impostazioni gestite dal server per la tua organizzazione. Presente solo quando la tua organizzazione le ha configurate. Aggiornato ad ogni avvio. |
Archiviazione in testo semplice
Le trascrizioni e la cronologia non sono crittografate a riposo. I permessi dei file del sistema operativo sono l’unica protezione. Se uno strumento legge un file.env o un comando stampa una credenziale, quel valore viene scritto in projects/<project>/<session>.jsonl. Per ridurre l’esposizione:
- Abbassa
cleanupPeriodDaysper accorciare il tempo in cui le trascrizioni vengono conservate - Imposta la variabile di ambiente
CLAUDE_CODE_SKIP_PROMPT_HISTORYper saltare la scrittura di trascrizioni e cronologia dei prompt in qualsiasi modalità. In modalità non interattiva, puoi invece passare--no-session-persistenceinsieme a-p, o impostarepersistSession: falsein Agent SDK. - Usa le regole di permesso per negare le letture dei file di credenziali
Cancella dati locali
Eseguiclaude project purge per eliminare lo stato che Claude Code mantiene per un progetto. Il comando richiede Claude Code v2.1.124 o successivo. Elimina:
- Trascrizioni e memoria automatica sotto
projects/ - Voci per sessione
tasks/,debug/efile-history/ - Righe di prompt corrispondenti in
history.jsonl - La voce del progetto in
~/.claude.json
--all invece di un percorso per eliminare lo stato per ogni progetto contemporaneamente, il che elimina history.jsonl completamente piuttosto che filtrarlo. Passa -i per scorrere il piano di eliminazione un elemento alla volta.
Il comando lascia shell-snapshots/ e backups/ da soli perché non sono limitati al progetto, e avverte su di essi nell’output del piano. Esce con stato 1 se nessuno stato corrisponde al percorso specificato.
Puoi anche eliminare manualmente uno qualsiasi dei percorsi di dati dell’applicazione sopra. Le nuove sessioni non sono interessate. La tabella di seguito mostra cosa perdi per le sessioni passate.
| Elimina | Perdi |
|---|---|
~/.claude/projects/ | Ripresa, continuazione e rewind per le sessioni passate |
~/.claude/history.jsonl | Richiamo del prompt con freccia su |
~/.claude/file-history/ | Ripristino del checkpoint per le sessioni passate |
~/.claude/stats-cache.json | Totali storici mostrati da /usage |
~/.claude/remote-settings.json | Nulla. Recuperato di nuovo al prossimo avvio. |
~/.claude/debug/, ~/.claude/plans/, ~/.claude/paste-cache/, ~/.claude/image-cache/, ~/.claude/session-env/, ~/.claude/tasks/, ~/.claude/shell-snapshots/, ~/.claude/backups/ | Nulla di visibile all’utente |
~/.claude/todos/, ~/.claude/statsig/, ~/.claude/logs/ | Nulla. Directory legacy non scritte dalle versioni correnti. |
~/.claude.json, ~/.claude/settings.json o ~/.claude/plugins/: contengono la tua autenticazione, preferenze e plugin installati.
Risorse correlate
- Gestisci la memoria di Claude: scrivi e organizza CLAUDE.md, rules e auto memory
- Configura le impostazioni: imposta permessi, hooks, variabili di ambiente e impostazioni predefinite del modello
- Crea skills: costruisci prompt e flussi di lavoro riutilizzabili
- Configura i subagents: definisci agenti specializzati con il loro contesto