Claude Code supporta le configurazioni proxy HTTP/HTTPS standard tramite variabili d’ambiente. Questo ti permette di instradare tutto il traffico di Claude Code attraverso i server proxy della tua organizzazione per scopi di sicurezza, conformità e monitoraggio.

Configurazione proxy di base

Variabili d’ambiente

Claude Code rispetta le variabili d’ambiente proxy standard:

# Proxy HTTPS (raccomandato)
export HTTPS_PROXY=https://proxy.example.com:8080

# Proxy HTTP (se HTTPS non è disponibile)
export HTTP_PROXY=http://proxy.example.com:8080

Claude Code attualmente non supporta la variabile d’ambiente NO_PROXY. Tutto il traffico sarà instradato attraverso il proxy configurato.

Claude Code non supporta i proxy SOCKS.

Autenticazione

Autenticazione di base

Se il tuo proxy richiede l’autenticazione di base, includi le credenziali nell’URL del proxy:

export HTTPS_PROXY=http://username:password@proxy.example.com:8080

Evita di codificare le password direttamente negli script. Usa invece variabili d’ambiente o archiviazione sicura delle credenziali.

Per proxy che richiedono autenticazione avanzata (NTLM, Kerberos, ecc.), considera l’uso di un servizio LLM Gateway che supporti il tuo metodo di autenticazione.

Problemi con i certificati SSL

Se il tuo proxy usa certificati SSL personalizzati, potresti incontrare errori di certificato.

Assicurati di impostare il percorso corretto del bundle di certificati:

export SSL_CERT_FILE=/path/to/certificate-bundle.crt
export NODE_EXTRA_CA_CERTS=/path/to/certificate-bundle.crt

Requisiti di accesso alla rete

Claude Code richiede l’accesso ai seguenti URL:

  • api.anthropic.com - Endpoint API di Claude
  • statsig.anthropic.com - Telemetria e metriche
  • sentry.io - Segnalazione errori

Assicurati che questi URL siano nella lista bianca nella configurazione del tuo proxy e nelle regole del firewall. Questo è particolarmente importante quando si usa Claude Code in ambienti di rete containerizzati o ristretti.

Risorse aggiuntive