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 e marketplace di plugin. Salva un file come questo in.claude/settings.json nella parte superiore del repository. Cose da sapere prima di sottoporre a commit uno:
- Le sessioni cloud lo leggono anche. Una sessione cloud inizia da un clone del repository, quindi il file sottoposto a commit si applica anche lì.
- La telemetria va nelle impostazioni gestite o personali. Claude Code ignora le variabili dell’esportatore OpenTelemetry nei file di impostazioni di un repository, a parte alcuni valori che disattivano la telemetria. Impostale nelle impostazioni gestite per la tua organizzazione, o nel file
~/.claude/settings.jsondi ogni persona. - 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. - Le regole corrispondono al comando e al percorso come scritti.
Bash(git push *)non corrisponde agit -C . push.Read(./.env)da solo interrompe i file tool e i comandi che nominano il file, comecat .env, ma nongrep -reseguito sulla directory; il bloccosandboxin questo file colma questa lacuna, perché la sandbox aggiunge i tuoi percorsi di negazioneReada ciò che ogni comando in sandbox non può leggere.
- 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 e comandicurlcome Claude li scrive, 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 i comandi in una sandbox con un’allowlist di rete fissa e nessun nuovo tentativo fuori dalla sandbox. La sua chiavefailIfUnavailableimpedisce a Claude Code di avviarsi dove la sandbox non può essere eseguitarequiredMinimumVersionimposta 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