Dove si trova settings.json di Claude Code su Mac, e perché la stessa variabile non funziona su claude.ai

Su Mac il file settings.json di Claude Code si trova in ~/.claude/settings.json, cioè nella cartella .claude dentro la tua home. Il Finder non la mostra perché il nome inizia con un punto: per aprirla premi Cmd + Shift + G nel Finder e scrivi ~/.claude.

Perché la cartella .claude non si vede nel Finder?

Su Mac, come su Linux, ogni file o cartella il cui nome inizia con un punto è nascosto. La cartella .claude esiste, ma il Finder non la mostra nell’elenco della tua home.

Dentro .claude c’è settings.json, il file delle impostazioni utente di Claude Code. Secondo la documentazione ufficiale vale per tutti i tuoi progetti, e le variabili d’ambiente vanno sotto la chiave env. La riga che mostro nello Short, quella che rende Claude Code meno verboso, è questa:

{
  "env": {
    "CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT": "0"
  }
}

Come si apre ~/.claude dal Finder?

Bastano tre tasti:

1. Apri il Finder.
2. Premi Cmd + Shift + G: si apre una finestra dove puoi scrivere un percorso.
3. Scrivi ~/.claude e premi Invio. La tilde ~ è l’abbreviazione della tua home: equivale a /Users/tuonome/.claude.

A quel punto sei dentro la cartella e puoi modificare settings.json.

Quali errori evitare quando modifichi settings.json su Mac?

Su Mac ci sono due trappole. Tutte e due producono un file che Claude Code non riesce a leggere.

• TextEdit salva in formato ricco. TextEdit, l’editor di default del Mac, crea i nuovi documenti in formato ricco. Prima di salvare apri il menu Formato e scegli Converti in testo normale, altrimenti settings.json non è più un JSON valido.
• Il Finder nasconde le estensioni. Rischi di salvare un file che nel Finder sembra settings.json ma in realtà si chiama settings.json.txt. Claude Code cerca settings.json e quel file lo ignora.

Qual è il modo più rapido per modificare settings.json?

La mia risposta onesta: salta tutti questi passaggi. Apri Claude Code nel terminale e chiedigli di impostare la variabile d’ambiente nel file settings.json dentro ~/.claude. Claude Code sa esattamente dove si trova il file e come va scritto, e tu eviti cartelle nascoste, formato ricco ed estensioni sbagliate.

Poi chiudi e riapri Claude Code, così ricarica le impostazioni con la nuova variabile. La documentazione di Claude Code spiega che molti valori del blocco env vengono applicati già al salvataggio, ma alcune funzioni leggono le variabili solo all’avvio: riavviare è il modo per non avere dubbi.

La stessa impostazione funziona anche su claude.ai?

No. Quella riga imposta una variabile d’ambiente, e le variabili d’ambiente le leggono solo i programmi che girano sul tuo computer, come Claude Code.

Claude.ai è una web app che usi dal browser. Su claude.ai non c’è nessun file settings.json da modificare, quindi non puoi cambiare il system prompt con una variabile d’ambiente.

Cosa conviene fare adesso?

~/.claude/settings.json è il posto dove decidi come si comporta Claude Code in tutti i tuoi progetti. Vale la pena sapere dove si trova, anche se poi lo fai modificare a Claude Code.

La prossima volta che trovi una riga utile da aggiungere alle impostazioni, apri il terminale e chiedila direttamente a Claude Code: ti bastano una frase e un riavvio.