La cartella di Claude Code

La cartella di Claude è la cartella in cui Claude Code tiene la sua configurazione: regole, skill, comandi, agenti, CLAUDE.md e settings.json. È esattamente ciò che KoNiMa Claude Sync legge da questa macchina e riscrive quando arriva qualcosa dalle altre. Per impostazione predefinita si trova in ~/.claude, cioè nella tua cartella utente.

Nella grande maggioranza dei casi non devi fare nulla: Claude Sync la individua da solo. Questa pagina spiega cosa succede quando la cartella è altrove, quando manca o quando ne hai più di una.

La mia cartella è in un posto non standard: come la trova?

Claude Sync stabilisce quale cartella usare seguendo un ordine preciso, e si ferma alla prima che trova:

l’impostazione Cartella di Claude, se l’hai valorizzata a mano;
la variabile d’ambiente CLAUDE_CONFIG_DIR — l’override ufficiale di Claude Code — che viene rilevata automaticamente, senza chiederti nulla;
il valore predefinito ~/.claude.

Chi tiene la configurazione in un posto non standard di norma ha già impostato CLAUDE_CONFIG_DIR per far funzionare Claude Code stesso: in quel caso il rilevamento è automatico e non devi configurare niente in Claude Sync.

L’impostazione Cartella di Claude vale solo per questa macchina e non viaggia mai: è una scelta locale, non parte della configurazione condivisa. Un percorso relativo nell’impostazione viene ignorato e si torna al rilevamento automatico.

Claude Sync mi chiede quale cartella usare?

Solo quando non riesce davvero a distinguerle. Se su questa macchina esiste più di una vera cartella di Claude Code — per esempio una personale in ~/.claude e una aziendale raggiunta tramite CLAUDE_CONFIG_DIR — Claude Sync ti chiede quale sincronizzare invece di indovinare e agganciare il repository a quella sbagliata. Vedi Ho più di una cartella di Claude qui sotto per quando e come succede.

In tutti i casi normali — una sola cartella, o una che hai già scelto — non dice nulla e procede da solo: non ti interrompe mai con un popup a sorpresa.

Puoi comunque scegliere la cartella a mano in qualsiasi momento con il pulsante Scegli cartella…, che compare in un solo punto: la riga Cartella di Claude del Controllo sistema (scheda Sistema), e solo quando quella verifica non è a posto. La cartella che scegli viene validata: deve contenere configurazione riconoscibile di Claude Code. Se scegli la cartella sbagliata, viene rifiutata con un messaggio del tipo «Quella cartella non sembra una cartella di Claude Code — non contiene settings.json, CLAUDE.md, skill o agenti. Non è stato modificato nulla.»

Se invece la cartella è valida e la confermi, il cambio è immediato: Claude Sync si riavvia da solo sulla nuova cartella («Cartella di Claude aggiornata. Claude Sync è stato riavviato con la nuova cartella.»), senza ricaricare l’editor e senza ri-clonare nulla. Se annulli, non cambia niente.

E se la cartella è sbagliata o manca?

Quando la cartella manca, è vuota o probabilmente non è quella giusta, Claude Sync te lo dice apertamente invece di mostrare un falso «tutto sincronizzato»:

la barra di stato diventa gialla con l’icona di avviso e non è mai verde;
ogni scheda della dashboard mostra il banner Cartella di Claude non trovata, con il percorso in cui l’app sta cercando;
lo stato sintetico riporta la pillola Controlla il setup.

La riga Cartella di Claude del Controllo sistema spiega esattamente in quale situazione ti trovi:

Verifica	Cosa significa
Cartella mancante	La cartella di Claude Code non è stata trovata in questo percorso: non c’è nulla da cui o verso cui sincronizzare.
Posto sbagliato	Claude Code è configurato su questa macchina ma non in questa cartella: Claude Sync sta guardando nel posto sbagliato.
Cartella vuota, ma il repository ha contenuto	Qui non c’è configurazione di Claude Code, ma nel tuo repository sì: Claude Sync sta leggendo la cartella sbagliata.
Macchina davvero nuova	Qui non c’è ancora configurazione di Claude Code: la prima sincronizzazione la creerà.

Claude Sync non crea mai la cartella da solo, con un’unica eccezione: una macchina davvero nuova su cui Claude Code non è mai stato eseguito, dove la prima sincronizzazione la crea come previsto.

Il modale Controllo sistema: ogni riga dell'ambiente con un'icona di stato; la riga Cartella di Claude è segnalata, con il suo esito e un pulsante Scegli cartella… Il Controllo sistema, con la riga della cartella di Claude segnalata e il pulsante per sceglierne una corretta.

Ho più di una cartella di Claude

Alcune macchine hanno due installazioni reali di Claude Code affiancate — una personale in ~/.claude e una aziendale raggiunta tramite CLAUDE_CONFIG_DIR, oppure una seconda ~/.claude-work accanto a quella predefinita. Quando Claude Sync trova due o più cartelle che contengono davvero configurazione di Claude Code e non ne hai ancora scelta una, ti chiede quale sincronizzare invece di indovinare: la cartella scelta è quella a cui viene agganciato il tuo repository, e una scelta sbagliata legherebbe la sincronizzazione al profilo sbagliato.

Durante il primo setup (prima che un repository sia collegato) la domanda viene prima di tutto: «Claude Sync ha trovato più di una cartella di Claude Code su questa macchina. Scegli quella da sincronizzare — il tuo repository verrà configurato nella cartella che scegli.» Ogni candidata è etichettata in base a dove è stata trovata — cartella predefinita, impostata da CLAUDE_CONFIG_DIR o trovata su questa macchina — e la confermi con Usa questa cartella (oppure Scegli un’altra cartella…). Il setup attende la tua scelta.
Su una macchina che sta già sincronizzando non interrompe il lavoro: propone la stessa scelta una sola volta, con delicatezza, mostrando la cartella su cui sei ora («Stai sincronizzando … Mantienila, oppure passa a un’altra cartella.»), così puoi Mantenere la cartella attuale oppure passare a un’altra.

Una volta scelta, la scelta viene ricordata come impostazione Cartella di Claude di questa macchina, così non te lo chiede più. Se invece una sola cartella contiene configurazione vera, non c’è nulla da chiedere: Claude Sync la usa e segue l’ordine di risoluzione descritto sopra, senza alcuna domanda.

Cosa resta sempre nella home

Due elementi seguono la tua cartella utente e non si spostano insieme alla cartella di configurazione:

~/.claude.json resta sempre nella home: Claude Code non lo sposta sotto CLAUDE_CONFIG_DIR, e Claude Sync non lo sincronizza mai.
Il database delle memorie ~/.claude-mem segue anch’esso la home, non la cartella di configurazione.

Dentro la cartella di Claude stessa, Claude Sync tiene una piccola area di lavoro .knm-sync per la propria contabilità locale — baseline, backup di sicurezza e lock. È strettamente locale a questa macchina e non viene mai sincronizzata: non raggiunge il tuo repository né le altre macchine.

Più finestre o sessioni insieme

Se apri più finestre di VS Code o più sessioni di Claude Code sulla stessa cartella, sei al sicuro: fanno a turno, quindi le tue modifiche non vengono mai perse né duplicate. Una sola finestra guida la sincronizzazione automatica; le altre seguono in modo passivo. Se avvii una sincronizzazione manuale mentre un’altra è in corso, vedrai «Un’altra finestra sta sincronizzando in questo momento — riprova tra poco.»

Cartelle di Claude diverse, invece, si sincronizzano in modo del tutto indipendente l’una dall’altra.

Vedi anche

Risoluzione dei problemi — cosa fare quando compare Controlla il setup.
Barra di stato e comandi — gli stati della barra, inclusa la cartella non trovata.
Cosa sincronizza — i domini e cosa viaggia in ognuno.