Vai al contenuto principale
Le impostazioni gestite dal server consentono agli amministratori di configurare centralmente Claude Code tramite un’interfaccia basata sul web su Claude.ai. I client di Claude Code ricevono automaticamente queste impostazioni quando gli utenti si autenticano con le credenziali della loro organizzazione. Questo approccio è progettato per le organizzazioni che non dispongono di infrastrutture di gestione dei dispositivi, o che hanno la necessità di gestire le impostazioni per gli utenti su dispositivi non gestiti.
Le impostazioni gestite dal server sono in beta pubblico e disponibili per i clienti di Claude for Teams e Claude for Enterprise. Le funzionalità potrebbero evolversi prima della disponibilità generale.

​
Requisiti

Per utilizzare le impostazioni gestite dal server, è necessario:
  • Piano Claude for Teams o Claude for Enterprise
  • Claude Code versione 2.1.38 o successiva per Claude for Teams, o versione 2.1.30 o successiva per Claude for Enterprise
  • Accesso di rete a api.anthropic.com

​
Scegliere tra impostazioni gestite dal server e gestite dall’endpoint

Claude Code supporta due approcci per la configurazione centralizzata. Le impostazioni gestite dal server forniscono la configurazione dai server di Anthropic. Le impostazioni gestite dall’endpoint vengono distribuite direttamente ai dispositivi tramite criteri nativi del sistema operativo (preferenze gestite macOS, registro Windows) o file di impostazioni gestiti.
ApproccioIdeale perModello di sicurezza
Impostazioni gestite dal serverOrganizzazioni senza MDM, o utenti su dispositivi non gestitiImpostazioni consegnate dai server di Anthropic al momento dell’autenticazione
Impostazioni gestite dall’endpointOrganizzazioni con MDM o gestione degli endpointImpostazioni distribuite ai dispositivi tramite profili di configurazione MDM, criteri del registro, o file di impostazioni gestiti
Se i vostri dispositivi sono registrati in una soluzione MDM o di gestione degli endpoint, le impostazioni gestite dall’endpoint forniscono garanzie di sicurezza più forti perché il file di impostazioni può essere protetto dalla modifica dell’utente a livello del sistema operativo.

​
Configurare le impostazioni gestite dal server

1

Aprire la console di amministrazione

In Claude.ai, navigare a Admin Settings > Claude Code > Managed settings.
2

Definire le impostazioni

Aggiungere la configurazione come JSON. Tutte le impostazioni disponibili in settings.json sono supportate, inclusi hooks, variabili di ambiente, e impostazioni solo gestite come allowManagedPermissionRulesOnly.Questo esempio applica un elenco di negazione delle autorizzazioni e impedisce agli utenti di ignorare le autorizzazioni:
{
  "permissions": {
    "deny": [
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ],
    "disableBypassPermissionsMode": "disable"
  }
}
Gli hook utilizzano lo stesso formato di settings.json.Questo esempio esegue uno script di audit dopo ogni modifica di file in tutta l’organizzazione:
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "/usr/local/bin/audit-edit.sh" }
        ]
      }
    ]
  }
}
Per configurare il classificatore della modalità auto in modo che conosca quali repository, bucket e domini la vostra organizzazione ritiene affidabili:
{
  "autoMode": {
    "environment": [
      "Source control: github.example.com/acme-corp and all repos under it",
      "Trusted cloud buckets: s3://acme-build-artifacts, gs://acme-ml-datasets",
      "Trusted internal domains: *.corp.example.com"
    ]
  }
}
Poiché gli hook eseguono comandi shell, gli utenti vedono una finestra di dialogo di approvazione della sicurezza prima che vengano applicati. Vedere Configurare il classificatore della modalità auto per come le voci autoMode influenzano ciò che il classificatore blocca e avvertimenti importanti sui campi allow e soft_deny.
3

Salvare e distribuire

Salvare le modifiche. I client di Claude Code ricevono le impostazioni aggiornate al prossimo avvio o ciclo di polling orario.

​
Verificare la consegna delle impostazioni

Per confermare che le impostazioni vengono applicate, chiedere a un utente di riavviare Claude Code. Se la configurazione include impostazioni che attivano la finestra di dialogo di approvazione della sicurezza, l’utente vede un prompt che descrive le impostazioni gestite all’avvio. È inoltre possibile verificare che le regole di autorizzazione gestite siano attive facendo eseguire a un utente /permissions per visualizzare le regole di autorizzazione effettive.

​
Controllo di accesso

I seguenti ruoli possono gestire le impostazioni gestite dal server:
  • Primary Owner
  • Owner
Limitare l’accesso al personale di fiducia, poiché le modifiche alle impostazioni si applicano a tutti gli utenti dell’organizzazione.

​
Limitazioni attuali

Le impostazioni gestite dal server hanno le seguenti limitazioni durante il periodo beta:
  • Le impostazioni si applicano uniformemente a tutti gli utenti dell’organizzazione. Le configurazioni per gruppo non sono ancora supportate.
  • Le configurazioni del server MCP non possono essere distribuite tramite impostazioni gestite dal server.

​
Consegna delle impostazioni

​
Precedenza delle impostazioni

Le impostazioni gestite dal server e le impostazioni gestite dall’endpoint occupano entrambe il livello più alto nella gerarchia delle impostazioni di Claude Code. Nessun altro livello di impostazioni può sostituirle, inclusi gli argomenti della riga di comando. Quando entrambe sono presenti, le impostazioni gestite dal server hanno la precedenza e le impostazioni gestite dall’endpoint non vengono utilizzate.

​
Comportamento di recupero e caching

Claude Code recupera le impostazioni dai server di Anthropic all’avvio e esegue il polling per gli aggiornamenti ogni ora durante le sessioni attive. Primo avvio senza impostazioni memorizzate nella cache:
  • Claude Code recupera le impostazioni in modo asincrono
  • Se il recupero non riesce, Claude Code continua senza impostazioni gestite
  • C’è una breve finestra prima che le impostazioni si carichino in cui le restrizioni non sono ancora applicate
Avvii successivi con impostazioni memorizzate nella cache:
  • Le impostazioni memorizzate nella cache si applicano immediatamente all’avvio
  • Claude Code recupera le impostazioni aggiornate in background
  • Le impostazioni memorizzate nella cache persistono attraverso i guasti di rete
Claude Code applica gli aggiornamenti delle impostazioni automaticamente senza un riavvio, ad eccezione delle impostazioni avanzate come la configurazione di OpenTelemetry, che richiedono un riavvio completo per avere effetto.

​
Finestre di dialogo di approvazione della sicurezza

Determinate impostazioni che potrebbero comportare rischi di sicurezza richiedono l’approvazione esplicita dell’utente prima di essere applicate:
  • Impostazioni dei comandi shell: impostazioni che eseguono comandi shell
  • Variabili di ambiente personalizzate: variabili non nell’elenco di sicurezza noto
  • Configurazioni di hook: qualsiasi definizione di hook
Quando queste impostazioni sono presenti, gli utenti vedono una finestra di dialogo di sicurezza che spiega cosa viene configurato. Gli utenti devono approvare per procedere. Se un utente rifiuta le impostazioni, Claude Code esce.
In modalità non interattiva con il flag -p, Claude Code salta le finestre di dialogo di sicurezza e applica le impostazioni senza approvazione dell’utente.

​
Disponibilità della piattaforma

Le impostazioni gestite dal server richiedono una connessione diretta a api.anthropic.com e non sono disponibili quando si utilizzano provider di modelli di terze parti:
  • Amazon Bedrock
  • Google Vertex AI
  • Microsoft Foundry
  • Endpoint API personalizzati tramite ANTHROPIC_BASE_URL o gateway LLM

​
Registrazione di audit

Gli eventi del registro di audit per le modifiche alle impostazioni sono disponibili tramite l’API di conformità o l’esportazione del registro di audit. Contattare il vostro team di account Anthropic per l’accesso. Gli eventi di audit includono il tipo di azione eseguita, l’account e il dispositivo che ha eseguito l’azione, e riferimenti ai valori precedenti e nuovi.

​
Considerazioni sulla sicurezza

Le impostazioni gestite dal server forniscono l’applicazione centralizzata dei criteri, ma operano come un controllo lato client. Su dispositivi non gestiti, gli utenti con accesso amministratore o sudo possono modificare il binario di Claude Code, il filesystem, o la configurazione di rete.
ScenarioComportamento
L’utente modifica il file di impostazioni memorizzato nella cacheIl file manomesso si applica all’avvio, ma le impostazioni corrette si ripristinano al prossimo recupero dal server
L’utente elimina il file di impostazioni memorizzato nella cacheSi verifica il comportamento del primo avvio: le impostazioni vengono recuperate in modo asincrono con una breve finestra non applicata
L’API non è disponibileLe impostazioni memorizzate nella cache si applicano se disponibili, altrimenti le impostazioni gestite non vengono applicate fino al prossimo recupero riuscito
L’utente si autentica con un’organizzazione diversaLe impostazioni non vengono consegnate per gli account al di fuori dell’organizzazione gestita
L’utente imposta un ANTHROPIC_BASE_URL non predefinitoLe impostazioni gestite dal server vengono ignorate quando si utilizzano provider API di terze parti
Per rilevare le modifiche della configurazione in fase di esecuzione, utilizzare gli hook ConfigChange per registrare le modifiche o bloccare le modifiche non autorizzate prima che abbiano effetto. Per garanzie di applicazione più forti, utilizzare le impostazioni gestite dall’endpoint su dispositivi registrati in una soluzione MDM.

​
Vedere anche

Pagine correlate per la gestione della configurazione di Claude Code:
  • Settings: riferimento di configurazione completo incluse tutte le impostazioni disponibili
  • Endpoint-managed settings: impostazioni gestite distribuite ai dispositivi dal reparto IT
  • Authentication: configurare l’accesso degli utenti a Claude Code
  • Security: salvaguardie di sicurezza e best practice