Skip to main content
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: ~/.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.

​
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.
Fai clic su un nome di file per aprire quel nodo nell’explorer sopra.

​
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.

​
Mantenuti fino a quando non li elimini

I seguenti percorsi non sono coperti dalla pulizia automatica e persistono indefinitamente. Altri piccoli file di cache e lock appaiono a seconda delle funzioni che utilizzi e sono sicuri 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. Il comando richiede Claude Code v2.1.124 o successivo. Elimina:
  • 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:
Elimina con un singolo prompt di conferma:
Ometti il percorso per scegliere un progetto da un elenco interattivo. Salta il prompt di conferma per l’uso negli script:
Passa --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. Non eliminare ~/.claude.json, ~/.claude/settings.json o ~/.claude/plugins/: contengono la tua autenticazione, preferenze e plugin installati.