settings.json di esempio, uno per ogni luogo in cui salvi un’impostazione:
- Un file
~/.claude/settings.jsondi uno sviluppatore - Un file
.claude/settings.jsondi un team, sottoposto a commit nel repository - Un file
managed-settings.jsondi un’organizzazione
Le tue impostazioni personali
Le impostazioni personali di uno sviluppatore. Sceglie un modello e uno sforzo, regola il terminale e pre-approva un comando di sola lettura e una lettura di file. Tutto ciò che non è elencato mantiene il suo valore predefinito. Un file come questo va in~/.claude/settings.json, dove si applica a ogni progetto che apri.
- Copyable settings file
- What each key does
Salva questo come
~/.claude/settings.json. È JSON valido senza commenti, quindi puoi incollarlo così com’è ed eliminare le chiavi che non desideri.~/.claude/settings.json
Le impostazioni condivise di un team
Le impostazioni condivise di un team, sottoposte a commit nel repository in modo che tutti coloro che lo clonano ottengano le stesse autorizzazioni, hook, telemetria e marketplace di plugin. Salva un file come questo in.claude/settings.json nella parte superiore del repository. Tre cose da sapere prima di sottoporre a commit uno:
- Le sessioni cloud lo leggono anche. Una sessione cloud su Claude Code sul web inizia da un clone del repository, quindi il file sottoposto a commit si applica anche lì.
- Le regole di autorizzazione attendono la fiducia. Le regole di autorizzazione e le voci
extraKnownMarketplaceshanno effetto dopo che ogni persona si fida di questa cartella stessa, non solo di una cartella padre; le regole di negazione e richiesta si applicano in ogni sessione, fidata o meno. - L’hook è uno script nel repo. L’hook di questo file esegue
.claude/hooks/block-rm.sh; How a hook resolves illustra come scriverlo.
- Copyable settings file
- What each key does
Salva questo come
.claude/settings.json nella parte superiore del repository e sottoponi a commit. È JSON valido senza commenti, quindi puoi incollarlo così com’è ed eliminare le chiavi che non desideri..claude/settings.json
Le impostazioni gestite di un’organizzazione
Un filemanaged-settings.json che mostra la forma delle chiavi gestite, con un valore plausibile per ognuna. Non è una politica consigliata: scegli le chiavi che corrispondono ai tuoi requisiti e imposta i tuoi valori. L’esempio imposta queste chiavi:
forceLoginMethodeforceLoginOrgUUIDfissano il metodo di accesso e l’organizzazioneavailableModelseenforceAvailableModelslimitano quali modelli possono utilizzare le sessionipermissions.denyblocca due letture di file ecurl, edisableBypassPermissionsModerimuove la modalità di autorizzazione di bypassallowManagedPermissionRulesOnlyeallowManagedMcpServersOnlyrendono le liste di autorizzazione di autorizzazione e MCP gestite le uniche che si applicanoallowedMcpServersfissa il server MCP per URLstrictKnownMarketplacesconsente un marketplace di pluginsandboxesegue il sandboxing dei comandi con una lista di autorizzazione di rete fissa e nessun retry non sandboxatorequiredMinimumVersionimposta una versione minima di Claude CodecleanupPeriodDaysaccorcia la conservazione dei trascritti delle sessioni e altri dati locali a sette giornicompanyAnnouncementsmostra un messaggio all’avvio
managed-settings.json, o lo stesso JSON tramite MDM o impostazioni gestite dal server. Un file distribuito si applica a ogni macchina o account che raggiunge. Per dare a un gruppo valori diversi, distribuisci un file o profilo diverso a quel gruppo, poiché le impostazioni gestite dal server non supportano ancora la politica per gruppo.
- Copyable settings file
- What each key does
Distribuisci questo come
managed-settings.json, o lo stesso JSON tramite MDM o la console claude.ai. È JSON valido senza commenti; sostituisci l’UUID dell’organizzazione di esempio, l’URL del server e il marketplace con i tuoi e elimina le chiavi che non desideri.managed-settings.json