CLAUDE_CONFIG_DIR: cosa fa in Claude Code

Cosa fa la variabile

Il riferimento sulle variabili d’ambiente di Anthropic descrive CLAUDE_CONFIG_DIR come un override della cartella di configurazione, che per impostazione predefinita è ~/.claude. Tutte le impostazioni, la cronologia delle sessioni e i plug-in vengono salvati nel percorso che le indichi.

Nient’altro cambia in Claude Code. Il comando claude è lo stesso programma; semplicemente legge e scrive in una cartella diversa. Avvialo con un valore e ottieni una configurazione. Avvialo con un altro e ne ottieni una seconda, indipendente.

Cosa c’è in una cartella di configurazione

Secondo la guida di Anthropic alla cartella .claude, quando imposti CLAUDE_CONFIG_DIR, ogni percorso che normalmente starebbe sotto ~/.claude si trova invece sotto la tua cartella. Questo comprende:

Il tuo CLAUDE.md personale, settings.json, skill, comandi, subagenti e stili di output.
Le trascrizioni delle sessioni in projects/, più la memoria automatica di ogni progetto.
Gli snapshot dei file usati per il ripristino dei checkpoint, i file dei piani e la cronologia dei prompt.
Scorciatoie da tastiera e temi personalizzati.

I file di progetto non sono toccati. Il CLAUDE.md, la cartella .claude/ e il file .mcp.json di un repository appartengono al progetto, quindi ogni cartella di configurazione li vede.

Come restano separati gli accessi su un Mac

Su macOS, Claude Code salva le credenziali nel Portachiavi cifrato. Le note sulla gestione delle credenziali di Anthropic dicono che, con CLAUDE_CONFIG_DIR impostata, Claude Code lega la voce del Portachiavi a quella cartella, quindi una sessione con una cartella diversa legge una voce diversa. Se il Portachiavi rifiuta la scrittura, anche il file di riserva .credentials.json finisce in quella cartella.

C’è un’eccezione documentata. Cartelle separate non tengono distinti due accessi a Claude Console effettuati senza chiave API, perché Claude Code salva quel tipo di accesso fuori dalla cartella di configurazione (documentazione sull’autenticazione, a ottobre 2026).

Anche le variabili d’ambiente possono sostituire l’accesso in ogni cartella. Se ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN o CLAUDE_CODE_OAUTH_TOKEN è esportata nella tua shell, può avere la meglio sull’account con cui hai effettuato l’accesso. Vedi come cambiare account in Claude Code per l’ordine completo.

Dove impostarla

Il modo più semplice è un alias della shell, che è l’esempio fornito da Anthropic. Aggiungilo a ~/.zshrc e apri una nuova finestra di Terminale:

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

Al primo avvio ti guida nell’accesso e nella configurazione della nuova cartella. Il semplice claude continua a usare ~/.claude.

Puoi anche impostare la variabile nelle impostazioni utente o gestite. In un file di impostazioni, scrivi il percorso assoluto. Claude Code la ignora nelle impostazioni di progetto e locali, quindi in quel modo non si può impostare per singolo repository.

Per verificare quale cartella usa una shell, esegui claude auth status. Nelle versioni recenti il suo output JSON include un campo configDirectory (riferimento della CLI).

Errori comuni

Dimenticare la variabile in una finestra. Una scheda di Terminale senza la variabile usa ~/.claude e il relativo accesso, ed è facile non accorgersene. Gli alias evitano il problema.
Usare ~ in un file di impostazioni. I file di impostazioni richiedono il percorso assoluto, come /Users/you/.claude-work.
Copiare un’intera cartella per crearne una nuova. Così copi la cronologia e lo stato di un account nell’altro. Parti da una cartella vuota e aggiungi ciò che ti serve. Condividere skill e server MCP spiega come fare.
Aspettarsi che le vecchie sessioni ti seguano. Le trascrizioni restano nella cartella che le ha create, quindi claude --resume in un’altra cartella non le elenca. Vedi riprendere le sessioni di Claude Code.
Una chiave API esportata. Sostituisce l’accesso in ogni cartella.

Come la usa Switch per Claude Desktop

Claude Code dentro Claude Desktop non legge gli alias della tua shell. Switch gestisce questo caso. Ogni profilo di Switch apre l’app Claude Desktop di Anthropic con la propria cartella dati. Con Keep coding preferences separate attiva, che è l’impostazione predefinita per i nuovi profili, il profilo ha anche la propria cartella di configurazione di Claude Code, e Switch avvia il Claude Desktop di quel profilo con CLAUDE_CONFIG_DIR puntata su di essa.

Switch non aggiunge alcun comando al Terminale, e ogni account mantiene il proprio piano e i propri limiti di utilizzo. Come Switch gestisce Claude Code.