Skip to main content
Claude Code supporta varie configurazioni di rete e sicurezza aziendali attraverso variabili di ambiente. Ciò include l’instradamento del traffico attraverso server proxy aziendali, la fiducia in Autorità di Certificazione (CA) personalizzate e l’autenticazione con certificati Transport Layer Security (mTLS) reciproco per una sicurezza migliorata.
Tutte le variabili di ambiente mostrate in questa pagina possono essere configurate anche in settings.json.

​
Configurazione del proxy

​
Variabili di ambiente

Claude Code rispetta le variabili di ambiente proxy standard:
Claude Code non supporta proxy SOCKS.

​
Autenticazione di base

Se il proxy richiede l’autenticazione di base, includere le credenziali nell’URL del proxy:
Evitare di codificare le password negli script. Utilizzare variabili di ambiente o archiviazione sicura delle credenziali.
Per proxy che richiedono autenticazione avanzata (NTLM, Kerberos, ecc.), considerare l’utilizzo di un servizio LLM Gateway che supporti il metodo di autenticazione.

​
Archivio certificati CA

Per impostazione predefinita, Claude Code si fida sia dei certificati CA Mozilla in bundle che dell’archivio certificati del sistema operativo. La lettura dell’archivio del sistema operativo richiede un runtime con tls.getCACertificates: il programma di installazione nativo lo ha sempre, e gli install npm necessitano di Node 22.15 o versioni successive. Su versioni di Node più vecchie, si applicano solo il set in bundle e NODE_EXTRA_CA_CERTS. I proxy di ispezione TLS aziendali come CrowdStrike Falcon e Zscaler funzionano senza configurazione aggiuntiva quando il loro certificato radice è installato nell’archivio di fiducia del sistema operativo e il runtime può leggerlo. CLAUDE_CODE_CERT_STORE accetta un elenco separato da virgole di fonti. I valori riconosciuti sono bundled per il set CA Mozilla fornito con Claude Code e system per l’archivio di fiducia del sistema operativo. L’impostazione predefinita è bundled,system. Per fidarsi solo del set CA Mozilla in bundle:
Per fidarsi solo dell’archivio certificati del sistema operativo:
CLAUDE_CODE_CERT_STORE non ha una chiave dello schema settings.json dedicata. Impostarla tramite il blocco env in ~/.claude/settings.json o direttamente nell’ambiente del processo.

​
Certificati CA personalizzati

Se l’ambiente aziendale utilizza una CA personalizzata, configurare Claude Code per fidarsi di essa direttamente:

​
Autenticazione mTLS

Per ambienti aziendali che richiedono l’autenticazione del certificato client:
Claude Code legge i file del certificato e della chiave all’avvio e li rilegge ogni volta che applica le impostazioni, incluso quando le impostazioni cambiano durante una sessione. Per ruotare il certificato e la chiave, sostituire i file negli stessi percorsi.

​
Requisiti di accesso alla rete

Claude Code richiede accesso ai seguenti URL. Inserire questi nella whitelist nella configurazione del proxy e nelle regole del firewall, soprattutto in ambienti di rete containerizzati o limitati. Se si installa Claude Code tramite npm o si gestisce la propria distribuzione binaria, gli utenti finali non hanno bisogno dell’installer nativo e l’auto-updater non utilizza downloads.claude.ai. Gli altri usi nella tabella si applicano indipendentemente dal metodo di installazione. Claude Code invia anche telemetria operativa facoltativa per impostazione predefinita, che è possibile disabilitare con variabili di ambiente. Consultare Servizi di telemetria per informazioni su come disabilitarla prima di finalizzare la whitelist. Quando si utilizza Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry o una sessione gateway app Claude con accesso effettuato, il traffico del modello e l’autenticazione vanno al provider o al gateway invece di api.anthropic.com, claude.ai o platform.claude.com. Lo strumento WebFetch chiama comunque api.anthropic.com per il suo controllo di sicurezza del dominio a meno che non si imposti skipWebFetchPreflight: true nelle impostazioni. Claude Code sul web e Code Review si connettono ai repository dall’infrastruttura gestita da Anthropic. Se l’organizzazione GitHub Enterprise Cloud limita l’accesso per indirizzo IP, abilitare l’ereditarietà della lista di indirizzi IP consentiti per le app GitHub installate. L’app GitHub di Claude registra i suoi intervalli di indirizzi IP, quindi l’abilitazione di questa impostazione consente l’accesso senza configurazione manuale. Per aggiungere gli intervalli alla lista di indirizzi consentiti manualmente invece, o per configurare altri firewall, consultare gli indirizzi IP dell’API Anthropic. Per istanze GitHub Enterprise Server auto-ospitate dietro un firewall, inserire nella whitelist gli stessi indirizzi IP dell’API Anthropic in modo che l’infrastruttura Anthropic possa raggiungere l’host GHES per clonare i repository e pubblicare i commenti di revisione.

​
Desktop e claude.ai

La tabella precedente copre principalmente la CLI standalone. L’app Claude Desktop e claude.ai in un browser caricano il codice dell’applicazione da host CDN Anthropic aggiuntivi, incluso assets-proxy.anthropic.com. Consentire claude.ai mentre si bloccano questi host produce una pagina vuota piuttosto che un errore. Consultare requisiti di accesso alla rete nella pagina Desktop.

​
Risorse aggiuntive