Esplora la directory .claude

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. Se il tuo repository ha già un AGENTS.md per altri agenti di codifica, Claude Code può leggerlo da solo o insieme a CLAUDE.md. 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, a parte eccezioni ristrette. Vedi dove salvare il file e quale fonte gestita Claude Code utilizza.
`CLAUDE.local.md`	Radice del progetto	Le tue preferenze private per questo progetto, caricate insieme a CLAUDE.md. Crealo manualmente e aggiungilo a `.gitignore`.
`AGENTS.md`	Radice del progetto, `.claude/`, o qualsiasi directory	Istruzioni di progetto che scrivi per gli agenti di codifica AI. Claude Code può caricarlo autonomamente o insieme a `CLAUDE.md`.
Plugin installati	`~/.claude/plugins`	Marketplace clonati, versioni plugin installate, il record di installazione `installed_plugins.json` e dati per plugin, gestiti dai comandi `claude plugin`. I plugin sincronizzati dal tuo account claude.ai vengono scaricati in `~/.claude/plugins/synced/`. Per un plugin installato da un marketplace con fonte `command` in modalità link, Claude Code memorizza i link qui invece di una copia, e i file del plugin rimangono nella directory che il comando stampa. Una fonte `command` richiede Claude Code v2.1.229 o successivo. Un plugin elencato per percorso relativo in un marketplace di directory locale carica in posizione dalla sua directory di origine piuttosto che da una copia cache. Vedi plugin caching per come le versioni orfane vengono pulite.

~/.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, a parte le eccezioni nella precedenza delle impostazioni
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.

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 quando Claude Code salva un’impostazione in esso	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

Campi frontmatter per file

Skills, file di comando, subagent, stili di output e regole leggono la loro configurazione da YAML frontmatter nella parte superiore del file, e ognuno accetta il proprio set di campi. Questa tabella elenca i nomi dei campi per ogni file e collega ai riferimenti che li descrivono.

File	Campi frontmatter	Riferimento
`skills/<name>/SKILL.md`	`name`, `description`, `when_to_use`, `argument-hint`, `arguments`, `disable-model-invocation`, `user-invocable`, `allowed-tools`, `disallowed-tools`, `model`, `effort`, `context`, `agent`, `background`, `hooks`, `paths`, `shell`, `metadata`, `license`, `compatibility`	Skill frontmatter
`commands/*.md`	I campi skill eccetto `name` e `paths`	Skill frontmatter
`agents/*.md`	`name`, `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `maxTurns`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `effort`, `isolation`, `color`, `initialPrompt`, `omitClaudeMd`, `experimental`	Subagent frontmatter
`output-styles/*.md`	`name`, `description`, `keep-coding-instructions`, `force-for-plugin`	Output style frontmatter
`rules/*.md`	`paths`	Rule frontmatter

Gli agenti forniti in un plugin rispettano un sottoinsieme dei campi subagent.

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

Claude Code elimina i file nei percorsi di seguito una volta che sono più vecchi di cleanupPeriodDays, purché possa determinare in modo sicuro il periodo di conservazione. L’impostazione predefinita è 30 giorni e il minimo è 1; impostare 0 genera un errore di convalida. Lo stesso limite di età si applica alla rimozione automatica dei worktrees orfani.

Percorso sotto `~/.claude/`	Contenuti
`projects/<project>/<session>.jsonl`	Trascrizione della conversazione completa: ogni messaggio, chiamata di strumento e risultato dello strumento
`projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>`	Una trascrizione precedente per la sessione che Claude Code ha messo da parte invece di sovrascriverla o eliminarla. Non appare nel selettore di sessione
`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, e copie a dimensione intera di immagini che gli strumenti MCP restituiscono
`file-history/<session>/`	Snapshot pre-modifica dei file che Claude ha modificato, utilizzati per il ripristino del checkpoint. Contiene snapshot per i 100 checkpoint più recenti; i file snapshot a cui nessun checkpoint conservato fa riferimento vengono eliminati, tranne il primo snapshot di ogni file
`plans/`	File di piano scritti durante la Plan Mode
`debug/`	Log di debug per sessione, scritti mentre il debug logging è attivo, ad esempio quando inizi con `--debug` o esegui `/debug`
`paste-cache/`	Contenuti di incollamenti di grandi dimensioni
`image-cache/<session>/`	Immagini allegate salvate da Claude Code v2.1.274 e versioni precedenti. Le versioni successive salvano le immagini incollate e allegate al di fuori di `~/.claude`, in una directory `images/` per ogni sessione nella directory temporanea che `CLAUDE_CODE_TMPDIR` controlla. La pulizia rimuove le directory di altre sessioni rimaste qui, indipendentemente dalla loro età.
`uploads/<session>/`	File che allega dal web o dall’app mobile, e foto che allega dall’app mobile, quando messaggia una sessione Remote Control. Un allegato a una sessione cloud viene salvato nell’ambiente cloud della sessione stessa, non sulla tua macchina.
`session-env/`	Metadati di ambiente per sessione
`tasks/`	Elenchi di attività scritti dagli strumenti di attività, una directory per elenco
`shell-snapshots/`	Alias, funzioni e opzioni shell acquisiti all’avvio e applicati dallo strumento Bash a ogni comando. Rimosso all’uscita pulita. La pulizia cancella qualsiasi cosa rimasta dopo un arresto anomalo.
`backups/`	Versioni precedenti di `~/.claude.json`, copiate quando Claude Code riscrive il file. Claude Code mantiene i cinque più recenti, più una copia di qualsiasi versione che non poteva analizzare.
`feedback-bundles/`	Archivi di trascrizione redatti scritti da `/feedback` su provider di terze parti o quando nessuna credenziale Anthropic è configurata, per l’invio al tuo team di account Anthropic
`feedback/drafts/`	Feedback redatto da Claude in coda in attesa della tua revisione in `/feedback`. Pulito dopo `cleanupPeriodDays` o 30 giorni, a seconda di quale sia più breve. Quando la coda raggiunge il limite di 10 bozze, Claude Code elimina la bozza più vecchia per fare spazio.
`usage-data/`	`report.html` e copie di report con timestamp scritte da `/insights`, più dati di analisi per sessione memorizzati nella cache utilizzati per costruirli
`skills/.trash/`, `plugins/.trash/`	Skills e plugins che il sync da claude.ai ha rimosso, ad esempio dopo che ne hai disattivato uno su claude.ai o hai smesso di sincronizzare. I file rimangono qui in modo che tu possa recuperarli fino a quando la pulizia non li elimina
`todos/`, `statsig/`, `logs/`	Directory legacy da versioni precedenti. Non più scritte. La pulizia rimuove i loro contenuti e poi la directory vuota.

I file di sessione in sessions/, la memoria automatica e le trascrizioni di Claude Desktop e Cowork seguono ciascuno la propria regola di conservazione:

sessions/: contiene un piccolo file per sessione in esecuzione, utilizzato per rilevare sessioni simultanee e arresti anomali. Non fa parte della pulizia basata sull’età: Claude Code rimuove ogni file quando la sua sessione esce e cancella i residui di arresto anomalo al prossimo avvio.
Memoria automatica: la pulizia non elimina i file di memoria nella directory di memoria automatica di un progetto, projects/<project>/memory/. Claude Code rimuove quella directory solo se è stata vuota per l’intero periodo di conservazione. Prima della v2.1.228, la pulizia trattava le cartelle all’interno della directory di memoria come dati di sessione e poteva eliminare file vecchi al di sotto di essa.
Trascrizioni di Claude Desktop e Cowork: Claude Code mantiene la trascrizione di una sessione che hai avviato o continuato più di recente in Claude Desktop o Cowork a qualsiasi età. Per dare a queste trascrizioni un limite di età, imposta desktopSessionCleanupPeriodDays. Quando le impostazioni gestite impostano cleanupPeriodDays, Claude Code elimina invece queste trascrizioni dopo quel periodo. Richiede Claude Code v2.1.248 o successivo; le versioni precedenti le eliminano dopo cleanupPeriodDays.

Claude Code salta la pulizia basata sull’età in questi casi:

Modalità bare: quando esegui claude -p con --bare, Claude Code non esegue la pulizia in quella sessione.
Pulizia in pausa: se Claude Code non può determinare in modo sicuro il periodo di conservazione, mette in pausa la pulizia della conservazione; l’evento retention_sweep elenca ogni configurazione che la mette in pausa. Quando la causa è un file di impostazioni che non può essere letto o analizzato, o errori di impostazioni con cleanupPeriodDays o desktopSessionCleanupPeriodDays impostati esplicitamente, Claude Code mostra anche un avviso in /status finché non correggi gli errori di impostazioni. Quando le impostazioni gestite forniscono cleanupPeriodDays, Claude Code esegue la pulizia al valore gestito in entrambi i casi.

Directory scratchpad della sessione

Lo scratchpad è una directory per sessione che Claude Code fornisce a Claude per file temporanei: risultati intermedi, script helper e bozze che non appartengono al tuo progetto. Quando Claude dice che ha salvato qualcosa “nello scratchpad”, il file è lì. Claude lo usa invece di /tmp, e può creare, modificare e leggere file in esso senza un prompt di permesso. Lo scratchpad si trova nella directory temporanea di Claude Code piuttosto che in ~/.claude. Trova il percorso della sessione corrente per la tua piattaforma:

macOS: /private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/
Linux: /tmp/claude-<uid>/<project>/<session-id>/scratchpad/, o la stessa forma sotto $TMPDIR quando il tuo sistema ne imposta uno
Windows: %TEMP%\claude\<project>\<session-id>\scratchpad\

<project> è il percorso della tua directory di lavoro con ogni carattere diverso da lettere e cifre sostituito da -, ad esempio -Users-you-my-project. Se imposti CLAUDE_CODE_TMPDIR, l’albero si sposta sotto quella directory. Gli hooks ricevono il percorso della sessione corrente come scratchpad_dir. I file scratchpad durano quanto la trascrizione della sessione: la pulizia della conservazione elimina la directory quando elimina la trascrizione, e claude project purge non tocca la directory temporanea. Poiché la directory si trova nella posizione temporanea del sistema, il tuo sistema operativo può anche cancellarla, ad esempio al riavvio. Per mantenere qualcosa che Claude ha scritto lì, chiedi a Claude di spostarlo nel tuo progetto. Una sessione ha uno scratchpad solo quando tutti questi elementi sono veri:

Sei connesso con un account claude.ai piuttosto che con una chiave API
La sessione utilizza l’API Anthropic, non Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry
enableArtifact non è impostato su false

Mantenuti fino a quando non li elimini

La pulizia della conservazione non rimuove i percorsi di seguito. Claude Code li mantiene fino a quando non li elimini, a parte i due cache che elimina quando esci.

Percorso sotto `~/.claude/`	Contenuti
`history.jsonl`	Ogni prompt che hai digitato, con timestamp e percorso del progetto. Utilizzato per il richiamo con freccia su, la ricerca nella cronologia `Ctrl+R` e il completamento dei comandi shell `!`.
`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, o `{}` quando la tua organizzazione non ne ha configurate. Presente solo quando la sessione le recupera. Claude Code verifica gli aggiornamenti all’avvio e ogni ora durante una sessione. Claude Code lo elimina quando esci.
`cache/changelog.md`	Copia memorizzata nella cache del changelog di Claude Code, mostrata da `/release-notes`. Aggiornata in background.
`policy-limits.json`	Impostazioni di policy delle funzioni memorizzate nella cache per la tua organizzazione. Presente solo per alcuni tipi di account. Aggiornate automaticamente. Un file sidecar `policy-limits.json.stamp.json` registra quale account o chiave API appartiene la cache. Claude Code elimina entrambi i file quando esci.

Altri file appaiono a seconda delle funzioni che utilizzi. I cache e i file di lock sono sicuri da eliminare. Mantieni questi file di stato:

.credentials.json: le tue credenziali di accesso
agent-memory/: memoria del subagent
jobs/ e daemon/: stato della sessione in background

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 Claude Code mantiene le trascrizioni
Imposta desktopSessionCleanupPeriodDays per dare anche alle trascrizioni di Claude Desktop e Cowork un limite di età
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 TypeScript Agent SDK; l’SDK Python non ha un’opzione equivalente.
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. 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

Le immagini che hai incollato o allegato nelle sessioni del progetto e la scratchpad di ogni sessione sono archiviate nella directory temporanea di Claude Code piuttosto che in ~/.claude, quindi la pulizia non le rimuove. La pulizia della conservazione elimina ancora le immagini una volta che sono più vecchie di cleanupPeriodDays; lo scratchpad di una sessione eliminata rimane fino a quando non lo elimini o il tuo sistema operativo non cancella la directory temporanea. Il comando stampa il piano di eliminazione completo e chiede conferma prima di rimuovere qualsiasi cosa. Gli esempi di seguito utilizzano ~/work/my-repo come segnaposto. Sostituiscilo con il percorso del tuo progetto. Se nessuno stato corrisponde al percorso, il comando stampa un errore e esce con stato 1. Visualizza l’anteprima del piano senza eliminare nulla:

claude project purge ~/work/my-repo --dry-run

Il piano elenca ogni elemento corrispondente e il motivo per cui è incluso:

Purge plan for /home/user/work/my-repo:

  dir:    /home/user/.claude/projects/-home-user-work-my-repo
           project transcripts (.jsonl) and memory/
  config: projects["/home/user/work/my-repo"]
           project entry in ~/.claude.json (trust, history, MCP servers)
  filter: /home/user/.claude/history.jsonl
           12 prompt(s) typed in this project

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/home/user/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 3 item(s) would be deleted.

Elimina con un singolo prompt di conferma:

claude project purge ~/work/my-repo

Il comando stampa lo stesso piano, quindi chiede Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] ed elimina solo se rispondi y. Ometti il percorso per scegliere un progetto da un elenco interattivo. Salta il prompt di conferma per l’uso negli script:

claude project purge ~/work/my-repo --yes

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. Puoi anche eliminare manualmente uno qualsiasi dei percorsi di dati dell’applicazione sopra, a parte i file di stato da mantenere. 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, e memoria automatica per ogni progetto
`~/.claude/history.jsonl`	Richiamo del prompt con freccia su, ricerca nella cronologia `Ctrl+R` e completamento dei comandi shell `!`
`~/.claude/paste-cache/`	Testo incollato nei prompt richiamati; vedi incolla contenuto di grandi dimensioni
`~/.claude/uploads/`	Allegati a cui le sessioni Remote Control passate si riferiscono per percorso
`~/.claude/file-history/`	Ripristino del checkpoint per le sessioni passate
`~/.claude/stats-cache.json`	Totali storici mostrati da `/usage`
`~/.claude/usage-data/`	Report `/insights` passati e i dati di analisi memorizzati nella cache utilizzati per costruirli
`~/.claude/feedback-bundles/`	Feedback e archivi di segnalazione di bug che non hai ancora inviato al tuo team di account Anthropic
`~/.claude/feedback/drafts/`	Feedback redatto da Claude che non hai inviato
`~/.claude/remote-settings.json`	Nulla. Recuperato di nuovo al prossimo avvio.
`~/.claude/cache/changelog.md`	Nulla. Aggiornato in background.
`~/.claude/policy-limits.json`	Nulla. Aggiornato automaticamente.
`~/.claude/tasks/`	Elenchi di attività che una sessione ripresa raccoglierebbe
`~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/`	La possibilità di recuperare skills sincronizzate e plugins sincronizzati che Claude Code ha rimosso
`~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/`	Nulla di visibile all’utente
`~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/`, `~/.claude/image-cache/`	Nulla. Directory legacy non scritte dalle versioni correnti.

Non eliminare ~/.claude.json, ~/.claude/settings.json o ~/.claude/plugins/: contengono la tua autenticazione, preferenze e plugin installati.

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

Guida introduttiva

Concetti fondamentali

Usa Claude Code

Piattaforme e integrazioni