Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Claude Code legge istruzioni, impostazioni, skills, subagents e memoria dalla tua directory di progetto e da ~/.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 |
| 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-mode o --settings ignorano settings.json per 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
Vedi precedenza delle impostazioni per l’ordine completo. | 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 |
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 di cleanupPeriodDays. 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 |
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. |
todos/ | Elenchi di attività legacy per sessione. Non più scritti dalle versioni correnti; sicuro da eliminare. |
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
cleanupPeriodDays per accorciare il tempo in cui le trascrizioni vengono conservate
- Imposta la variabile di ambiente
CLAUDE_CODE_SKIP_PROMPT_HISTORY per saltare la scrittura di trascrizioni e cronologia dei prompt in qualsiasi modalità. In modalità non interattiva, puoi invece passare --no-session-persistence insieme a -p, o impostare persistSession: false in Agent SDK.
- Usa le regole di permesso per negare le letture dei file di credenziali
Cancella dati locali
Esegui claude project purge per eliminare lo stato che Claude Code mantiene per un progetto:
- Trascrizioni e memoria automatica sotto
projects/
- Voci per sessione
tasks/, debug/ e file-history/
- Righe di prompt corrispondenti in
history.jsonl
- La voce del progetto in
~/.claude.json
Il comando stampa il piano di eliminazione completo e chiede conferma prima di rimuovere qualsiasi cosa.
Visualizza l’anteprima del piano senza eliminare nulla:
claude project purge ~/work/my-repo --dry-run
claude project purge ~/work/my-repo
claude project purge ~/work/my-repo --yes
--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/ | Nulla. Directory legacy non scritta dalle versioni correnti. |
~/.claude.json, ~/.claude/settings.json o ~/.claude/plugins/: contengono la tua autenticazione, preferenze e plugin installati.
Risorse correlate
