SpyBara
Go Premium

gateways.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 19 additions and 16 deletions.

2026
Wed 9 22:58

Eseguire Claude Code attraverso un gateway

Instrada Claude Code attraverso un gateway auto-ospitato per credenziali centralizzate, tracciamento dell'utilizzo e controlli dei costi. Copre l'architettura, il gateway delle app Claude di Anthropic e l'utilizzo di altri prodotti gateway.

Un gateway è un proxy che la tua organizzazione esegue tra Claude Code e un provider di modelli. Claude Code invia il traffico API al gateway invece di inviarlo direttamente al provider, e il gateway lo inoltra utilizzando una credenziale che la tua organizzazione possiede. Gli sviluppatori si autenticano al gateway piuttosto che detenere credenziali del provider, quindi l'autenticazione, il tracciamento dell'utilizzo, i budget e la registrazione di audit avvengono in un unico posto che controlli.

Claude Code include un gateway auto-ospitato, Claude apps gateway, nel binario claude, quindi non devi adottare un prodotto gateway separato per eseguirne uno. Se la tua organizzazione esegue già un gateway LLM, Claude Code funziona anche con quello.

Questa pagina copre:

Come funziona un gateway

Ogni Claude Code dello sviluppatore invia le sue richieste all'indirizzo del gateway e si autentica con una credenziale emessa dal gateway.

Il gateway autentica lo sviluppatore, applica qualsiasi regola di accesso e budget che configuri, e inoltra la richiesta al tuo provider con la credenziale dell'organizzazione. Il provider può essere l'API di Anthropic o un provider cloud come Amazon Bedrock, Agent Platform di Google Cloud o Microsoft Foundry; la configurazione del gateway decide. Con Claude apps gateway, o un altro gateway che espone un singolo endpoint in formato Anthropic, il cambio del provider non richiede di toccare le macchine degli sviluppatori.

Diagramma che mostra Claude Code instradato attraverso un gateway. In una zona di macchine sviluppatore, la CLI di Claude Code e l'estensione VS Code inviano richieste all'indirizzo del gateway con una credenziale per sviluppatore. In una zona etichettata come tua infrastruttura, il gateway gestisce l'autenticazione, il tracciamento dell'utilizzo, i budget e l'instradamento, e inoltra le richieste con la credenziale della tua organizzazione. In una zona di provider di modelli, una freccia solida porta al provider che configuri, mostrato come l'API Anthropic, e frecce tratteggiate portano ad altre opzioni di provider, illustrate con Amazon Bedrock, Google Cloud e Microsoft Foundry come esempi.

Due tipi di credenziale sono coinvolti:

  • Credenziale dello sviluppatore: ogni sviluppatore ne possiede una propria, emessa dal gateway. Li autentica al gateway e li identifica nel tracciamento dell'utilizzo
  • Credenziale del provider: il gateway possiede una credenziale per il tuo account provider, condivisa da tutto il traffico inoltrato

Scegli un gateway

Claude Code funziona con il gateway di Anthropic o con un gateway che la tua organizzazione già esegue.

Claude apps gateway

Claude apps gateway è il gateway auto-ospitato di Anthropic, incluso nel binario claude. Instrada ad Amazon Bedrock, Claude Platform su AWS, Google Cloud, Microsoft Foundry o l'API Anthropic come upstream. Gli sviluppatori accedono con il tuo provider di identità aziendale attraverso /login, il gateway applica l'accesso ai modelli e le impostazioni gestite per gruppo IdP, e emette metriche di utilizzo OpenTelemetry Protocol (OTLP) al tuo stack di osservabilità.

Poiché è costruito e testato insieme a ogni rilascio di Claude Code, inoltra le intestazioni e i campi di richiesta che Claude Code invia. Un gateway mantenuto separatamente ha bisogno che le sue regole di inoltro vengano aggiornate mentre quelle intestazioni e campi cambiano con ogni rilascio; Claude apps gateway viene rilasciato con la CLI, quindi non c'è alcun elenco da mantenere aggiornato. Vedi Disponibilità e limitazioni per il piccolo insieme di funzionalità che si comportano diversamente in una sessione gateway.

L'accesso al gateway è un passaggio SSO del browser, e non c'è alcun flusso di token di servizio, quindi una pipeline CI senza uno sviluppatore per approvare l'accesso non può autenticarsi attraverso di essa; configura quelli direttamente contro il tuo provider. Le sessioni Agent SDK e le esecuzioni claude -p su una macchina dove uno sviluppatore ha effettuato l'accesso utilizzano la sessione gateway di quella macchina e sono governate dalle sue politiche. Vedi Pipeline CI e macchine remote.

Vedi Claude apps gateway per distribuirlo.

Altri gateway

Se la tua organizzazione esegue già un gateway LLM o un gateway API, puoi usarlo invece. Anthropic non approva, mantiene o controlla altri prodotti gateway, e non supporta l'instradamento di Claude Code a modelli non-Claude attraverso alcun gateway. Vedi Altri gateway LLM per la lista di controllo del rollout amministrativo, cosa deve implementare un gateway e come puntare Claude Code ad esso.

Abbonamenti e gateway

Quando gli sviluppatori si connettono attraverso un gateway con una credenziale gateway, l'utilizzo viene fatturato all'account provider della tua organizzazione alle tariffe API, e i loro abbonamenti claude.ai non vengono utilizzati o addebitati. Impostare ANTHROPIC_AUTH_TOKEN per un gateway che esegui, o accedere a un Claude apps gateway con /login, disattiva l'accesso all'abbonamento per quella sessione. Ogni richiesta inoltrata sotto quella credenziale viene addebitata all'account dietro la credenziale del provider del gateway.

L'eccezione è impostare solo ANTHROPIC_BASE_URL, senza credenziale gateway. Le richieste vengono comunque instradate attraverso il gateway, ma un accesso claude.ai salvato rimane la credenziale attiva, quindi i limiti di utilizzo e la fatturazione dell'abbonamento si applicano. Altri gateway LLM copre quella configurazione e cosa il gateway deve inoltrare affinché funzioni.

Configura separatamente dal gateway

Un gateway instrada le richieste API del modello. Poche cose che potresti aspettarti che gestisca sono configurate altrove:

  • Quale modello risponde: scegli il modello con il comando /model o le variabili di ambiente del modello. Il gateway decide dove vanno le richieste, non quale modello seleziona lo sviluppatore. Claude apps gateway può limitare la scelta con una lista di autorizzazione availableModels per gruppo, ma lo sviluppatore sceglie comunque all'interno di essa.
  • Altro traffico di rete: Claude Code stesso invia controlli di versione e download direttamente ad Anthropic, separato dal percorso del gateway. La tua rete ha ancora bisogno di uscita verso i domini richiesti, o imposta CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC per disattivare i flussi opzionali.
  • Telemetria del client: Claude Code disabilita la sua analittica client legata ad Anthropic quando una sessione accede a un Claude apps gateway. Per mantenere disattivata anche l'analittica di avvio pre-accesso, fornisci DISABLE_TELEMETRY nelle impostazioni gestite lato client su ogni dispositivo.
  • Telemetria del client su altri gateway: se Claude Code invia il flusso di telemetria client opzionale dipende dal tuo provider, e la tabella dei valori predefiniti di telemetria copre ogni caso.
  • Destinazioni di telemetria: dove Claude Code invia la telemetria di una sessione gateway dipende da come la sessione ha effettuato l'accesso, e What's enforced on developers dice dove vanno le esportazioni di ogni tipo di sessione.
  • Proxy HTTP aziendali: un HTTPS_PROXY si posiziona tra Claude Code e ogni server con cui comunica, incluso il gateway. Se la tua rete ne richiede uno, configura il proxy in aggiunta al gateway. Per un Claude apps gateway che ospiti, l'accesso verifica che l'host proxy sia anche su una rete privata; se non lo è, aggiungi l'host gateway a NO_PROXY in modo che la CLI si connetta ad esso direttamente.

Passaggi successivi

La pagina successiva dipende da chi esegue il gateway. Il gateway di Anthropic viene eseguito dal binario claude e ha la sua propria guida di configurazione; un gateway che la tua organizzazione già esegue ha un protocollo da implementare e una lista di controllo del rollout amministrativo.