Skip to main content
Claude Code applica la policy dell’organizzazione attraverso impostazioni gestite che hanno la precedenza sulla configurazione locale dello sviluppatore. Fornisci queste impostazioni dalla console di amministrazione Claude, dal tuo sistema di gestione dei dispositivi mobili (MDM) o da un file su disco. Le impostazioni controllano quali strumenti, comandi, server e destinazioni di rete Claude può raggiungere. Questa pagina illustra le decisioni di distribuzione in ordine. Ogni riga si collega alla sezione sottostante e alla pagina di riferimento per quell’area.
SSO, il provisioning SCIM e l’assegnazione dei posti sono configurati a livello di account Claude. Consulta la Guida dell’amministratore aziendale Claude e l’assegnazione dei posti per questi passaggi.

​
Scegli il tuo provider API

Claude Code si connette a Claude attraverso uno dei diversi provider API. La tua scelta influisce sulla fatturazione, l’autenticazione, sulla postura di conformità che erediti e su quali funzionalità di Claude Code i tuoi sviluppatori possono utilizzare. Alcune funzionalità di Claude Code richiedono un account claude.ai. Le sessioni cloud, le attività pianificate cloud, Code Review, Remote Control e l’estensione Chrome non sono disponibili tramite chiavi API Console o credenziali di provider cloud da sole. Se distribuisci tramite Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry, pianifica se gli sviluppatori hanno anche bisogno di posti Claude for Teams o Enterprise. Ogni pagina di funzionalità elenca i suoi requisiti di piano. Per il confronto completo dei provider che copre l’autenticazione, le regioni e la parità delle funzionalità, consulta la panoramica della distribuzione aziendale. La configurazione dell’autenticazione di ogni provider è in Authentication. I requisiti di proxy e firewall in Network configuration si applicano indipendentemente dal provider. Se vuoi un singolo endpoint davanti a più provider o un logging centralizzato delle richieste, consulta LLM gateway.

​
Decidi come le impostazioni raggiungono i dispositivi

Le impostazioni gestite definiscono la policy dell’organizzazione. Claude Code controlla le quattro fonti nella tabella sottostante in ordine di priorità. Come Claude Code combina le fonti gestite dice quali di esse si applicano, cosa cambia un policy helper, e come comporre ogni fonte. La tabella è la mappa decisionale. Claude Code recupera le impostazioni gestite dal server all’avvio e le aggiorna ogni ora durante la sessione, senza infrastruttura di endpoint da distribuire. La consegna attraverso la console di amministrazione claude.ai richiede un piano Claude for Teams o Enterprise. Le distribuzioni su Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry possono ottenere la stessa consegna remota eseguendo un gateway di app Claude, oppure utilizzare uno dei meccanismi basati su file o a livello di sistema operativo. Se la tua organizzazione mescola provider, configura le impostazioni gestite dal server per gli utenti di claude.ai più un fallback basato su file o plist/registry in modo che gli altri utenti ricevano comunque la policy gestita. Le posizioni del registro plist e HKLM funzionano con qualsiasi provider e resistono alle manomissioni perché richiedono privilegi di amministratore per la scrittura. Il registro utente di Windows in HKCU è scrivibile senza elevazione, quindi trattalo come un default di convenienza piuttosto che come un canale di applicazione. Per impostazione predefinita, WSL legge solo il percorso del file Linux in /etc/claude-code. Per estendere la tua policy del registro Windows e C:\Program Files\ClaudeCode a WSL sulla stessa macchina, imposta wslInheritsWindowsSettings: true in una di quelle fonti solo amministratore di Windows. Qualunque meccanismo tu scelga, i valori gestiti hanno la precedenza sulle impostazioni dell’utente e del progetto, a parte alcune eccezioni sensibili alla sicurezza. Per le impostazioni di array come permissions.allow e permissions.deny viene eseguito il merge delle voci da tutte le fonti, quindi gli sviluppatori possono estendere gli elenchi gestiti ma non rimuovere da essi. Per fallbackModel, availableModels, e modelPicker, il valore gestito sostituisce i livelli inferiori anziché essere sottoposto a merge.

​
Sessioni WSL in Claude Code Desktop

Su Windows, Claude Code Desktop può eseguire sessioni di Code all’interno di una distribuzione WSL 2. Il processo Claude Code della sessione viene eseguito all’interno della distribuzione, quindi risolve le impostazioni gestite attraverso il percorso di discovery WSL sopra: le fonti solo Windows non lo raggiungono a meno che wslInheritsWindowsSettings: true non sia distribuito. Claude Desktop disattiva le sessioni WSL per impostazione predefinita sui dispositivi che rileva come gestiti dall’organizzazione, ad esempio quando C:\Program Files\ClaudeCode\managed-settings.json esiste. Per attivarle, distribuisci una policy del registro Windows, che richiede Claude Desktop v1.19367.0 o successivo:
  • Crea un valore denominato disableWslSessions sotto HKLM\SOFTWARE\Policies\Claude e impostalo sulla stringa REG_SZ false o su REG_DWORD 0. Questo valore si trova sotto la chiave policy di Claude Desktop, separato dalla chiave ClaudeCode che contiene le impostazioni gestite. Distribuisci il valore sotto HKLM, che richiede privilegi di amministratore per la scrittura. Un valore sotto HKCU non abilita le sessioni WSL.
  • Lascia C:\Program Files\ClaudeCode\managed-settings.json in posizione se lo distribuisci. Una volta che disableWslSessions è false sotto HKLM, Desktop consente le sessioni WSL anche se quel file è presente.
Desktop legge la policy ogni volta che inizia una sessione WSL, quindi non è necessario riavviare l’app dopo averla distribuita. Se un dispositivo rifiuta ancora le sessioni WSL, apri Help > Troubleshooting > Show Logs in File Explorer in Claude Desktop su quel dispositivo, che salva una copia della sua cartella di log in Download. Cerca main.log in quella copia per [wslPolicyGate] denying WSL session. Il motivo del rifiuto segue tra parentesi, come (cli-file-present). Dopo che le sessioni WSL sono abilitate, estendi le tue impostazioni gestite a loro:
  • Distribuisci wslInheritsWindowsSettings: true attraverso il registro HKLM o il file C:\Program Files\ClaudeCode in modo che le sessioni WSL ereditino la stessa policy delle sessioni host.
  • Verifica eseguendo /status all’interno di una sessione WSL e leggendo la riga Setting sources. Per interpretare ciò che elenca, vedi Leggi la fonte in /status.
I processi all’interno della VM utility WSL 2 non sono visibili ai sensori di rilevamento endpoint lato Windows. Per osservare l’attività dei processi e dei file all’interno della distribuzione, controlla la guida WSL del tuo fornitore di rilevamento endpoint per un sensore Linux che puoi eseguire all’interno della distribuzione e le esclusioni di cui ha bisogno. La telemetria di esecuzione dello strumento OpenTelemetry di Claude Code viene emessa in modo identico per le sessioni WSL e native.

​
Decidi cosa applicare

Le impostazioni gestite possono bloccare gli strumenti, l’esecuzione sandbox, limitare i server MCP e le fonti di plugin e controllare quali hook vengono eseguiti. Ogni riga è una superficie di controllo con le chiavi di impostazione che la guidano. Se i tuoi membri si autenticano tramite claude.ai o l’API Anthropic e sei su un piano Claude Enterprise, puoi anche governare i modelli dalle impostazioni di amministrazione della tua organizzazione senza distribuire nulla: Nessuno di questi controlli raggiunge le sessioni su Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry, o Claude Platform on AWS. Su questi provider, utilizza le impostazioni gestite invece: availableModels per le restrizioni, model per un valore predefinito, e maxEffortLevel per un limite di sforzo. Le Cloud sessions hanno le proprie superfici di amministrazione su claude.ai: Le regole di autorizzazione e il sandboxing coprono livelli diversi. Negare WebFetch blocca lo strumento fetch di Claude, ma se Bash è consentito, curl e wget possono comunque raggiungere qualsiasi URL. Il sandboxing chiude questo divario con un allowlist di domini di rete applicato a livello di sistema operativo. Per il modello di minaccia che questi controlli difendono, consulta Security.

​
Account GitHub connessi

Sui piani Team ed Enterprise, la sezione GitHub di Organization settings > Git providers elenca le organizzazioni GitHub e gli account personali collegati alla tua organizzazione Claude tramite la Claude GitHub App. Claude Code, Claude Tag e Claude Security condividono l’elenco. Per aprire la pagina è necessario un ruolo di amministratore nella tua organizzazione Claude. Un amministratore o un membro può collegare un account:
  • Connessione dell’amministratore: un amministratore fa clic su Connect in quella sezione, oppure su Add organization una volta che un account è connesso, e installa la Claude GitHub App su un’organizzazione GitHub. Collegare un’organizzazione in questo modo richiede una persona che sia sia proprietario dell’organizzazione GitHub sia amministratore della tua organizzazione Claude.
  • Connessione del membro: quando un membro connette il proprio account GitHub a Claude, ad esempio durante la configurazione delle sessioni cloud, Claude collega gli account GitHub di proprietà di quel membro su cui la Claude GitHub App è già installata. Questi possono includere il suo account personale e le organizzazioni GitHub di cui è proprietario.
Una riga contrassegnata come Not linked proviene dal tuo accesso a GitHub. Si tratta di un account che puoi vedere su GitHub su cui è installata la Claude GitHub App. Per scollegare un account dalla tua organizzazione Claude, apri il menu della sua riga e seleziona Unlink from this workspace. Lo scollegamento lascia la Claude GitHub App installata su GitHub, e l’account viene collegato di nuovo la prossima volta che uno dei suoi proprietari connette GitHub a Claude. Per evitare che venga collegato di nuovo, disinstalla la Claude GitHub App da quell’account su GitHub. Sui piani Enterprise, i tipi di attività della Compliance API per il collegamento e lo scollegamento sono github_app_installation_linked e github_app_installation_unlinked.

​
Configura la visibilità dell’utilizzo

Scegli il monitoraggio in base a ciò che devi segnalare. Le dashboard, le API e i controlli di spesa differiscono tra i piani Claude for Teams o Enterprise e le organizzazioni Claude Console, quindi controlla la colonna Disponibilità prima di pianificare la tua reportistica attorno a una capacità. Su Teams e Enterprise, i numeri di utilizzo e spesa per utente provengono dal rapporto di spesa nelle impostazioni di analisi della tua organizzazione, non dalla dashboard di analisi. I provider cloud espongono la spesa attraverso AWS Cost Explorer, GCP Billing o Azure Cost Management. Per pianificare i budget aziendali su Claude chat, Claude Code e Cowork, consulta la guida al consumo Claude Enterprise.

​
Rivedi la gestione dei dati

Sui piani Team, Enterprise, Claude API e provider cloud, Anthropic non addestra i modelli sul tuo codice o sui tuoi prompt. Il tuo provider API determina la conservazione e la postura di conformità. Se hai bisogno di logging di audit a livello di richiesta o di instradare il traffico in base alla sensibilità dei dati, ti consigliamo di posizionare un gateway tra gli sviluppatori e il tuo provider: un Claude apps gateway auto-ospitato registra un log di audit per richiesta con identità IdP, oppure puoi utilizzare un altro LLM gateway. Le sessioni che passano attraverso un gateway non sono idonee per la configurazione HIPAA. Verifica come gli sviluppatori accedono e si connettono elenca quali metodi di accesso e di connessione lo sono. Per i requisiti normativi e le certificazioni, consulta Legal and compliance.

​
Verifica e onboard

Dopo aver configurato le impostazioni gestite, fai eseguire a uno sviluppatore /status all’interno di Claude Code. Nella scheda Status, la riga Setting sources mostra Enterprise managed settings seguita dalla fonte tra parentesi; Verify enforcement elenca le etichette. Condividi queste risorse per aiutare gli sviluppatori a iniziare: Per i problemi di accesso, indirizza gli sviluppatori alla risoluzione dei problemi di autenticazione. Le correzioni più comuni sono:
  • Esegui /logout quindi /login per cambiare account
  • Esegui claude update se l’opzione di autenticazione aziendale è mancante
  • Riavvia il terminale dopo l’aggiornamento
Se uno sviluppatore vede “You haven’t been added to your organization yet,” il suo posto non include l’accesso a Claude Code e deve essere aggiornato nella console di amministrazione.

​
Passaggi successivi

Con il provider e il meccanismo di consegna scelti, passa alla configurazione dettagliata: