llm-gateway.md +0 −96 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# Gateway LLM
6
7> Instrada Claude Code attraverso un gateway LLM per l'autenticazione centralizzata, il tracciamento dell'utilizzo e i controlli dei costi. Copre il collegamento di Claude Code a un gateway, il rollout per la tua organizzazione, cosa Claude Code invia a un gateway e come i gateway interagiscono con gli abbonamenti a claude.ai.
8
9Un gateway LLM è un proxy che la tua organizzazione esegue tra Claude Code e un provider di modelli. Claude Code invia il traffico API al gateway, e il gateway lo inoltra al provider utilizzando una credenziale che la tua organizzazione controlla.
10
11<Note>
12 * Se sei uno sviluppatore che si connette a un gateway esistente: [collega Claude Code al tuo gateway](/it/llm-gateway-connect)
13 * Se sei un amministratore che esegue il rollout di un gateway per la tua organizzazione: [distribuisci e distribuisci un gateway](/it/llm-gateway-rollout)
14 * Se stai configurando un prodotto gateway: il [riferimento del protocollo gateway](/it/llm-gateway-protocol)
15</Note>
16
17<h2 id="what-a-gateway-provides">
18 Cosa fornisce un gateway
19</h2>
20
21Un gateway offre alla tua organizzazione un unico posto per gestire:
22
23* **Credenziali**: la chiave del provider rimane lato server; gli sviluppatori mantengono invece le credenziali del gateway
24* **Tracciamento dell'utilizzo**: attribuisci l'utilizzo per sviluppatore o team, indipendentemente da quale provider serve la richiesta
25* **Controlli dei costi**: applica budget e limiti di velocità in un unico posto
26* **Registrazione di audit**: registra ogni richiesta di modello per la conformità
27* **Cambio di provider**: cambia il provider nella configurazione del gateway, senza toccare le macchine degli sviluppatori
28
29Tutti questi, tranne il cambio di provider, si applicano sia che l'upstream sia l'API di Anthropic che un [provider cloud](/it/third-party-integrations).
30
31Il compromesso è che il gateway diventa un'infrastruttura che la tua organizzazione gestisce. Claude Code aggiunge funzionalità con ogni rilascio, e un gateway che non le inoltra interrompe le funzionalità corrispondenti, quindi il prodotto gateway deve essere mantenuto aggiornato man mano che Claude Code evolve. Il [riferimento del protocollo gateway](/it/llm-gateway-protocol) copre cosa inoltrare.
32
33<h2 id="how-a-gateway-works">
34 Come funziona un gateway
35</h2>
36
37Per impostazione predefinita, Claude Code invia richieste direttamente all'API di Anthropic su `api.anthropic.com`. Per instradare attraverso un gateway, imposta `ANTHROPIC_BASE_URL` all'indirizzo del gateway; Claude Code invia le stesse richieste lì invece. Il gateway autentica lo sviluppatore, allega la credenziale del provider della tua organizzazione e inoltra ogni richiesta a qualunque provider sia configurato.
38
39`ANTHROPIC_BASE_URL` è la variabile di indirizzo per la maggior parte dei gateway. Un gateway che fronteggia un provider cloud specifico, come Bedrock, Vertex, Foundry o la Claude Platform su AWS, utilizza invece la variabile di URL di base di quel provider; [Formati API](/it/llm-gateway-protocol#api-formats) elenca quale variabile va con ogni configurazione.
40
41<Frame>
42 <img src="https://mintcdn.com/claude-code/-uq-4JE0W_JO5Er5/images/llm-gateway-flow.svg?fit=max&auto=format&n=-uq-4JE0W_JO5Er5&q=85&s=1c1a8dcc0cfcc3a58652cc8e28cd3e20" alt="Diagramma che mostra Claude Code instradato attraverso un gateway LLM. In una zona di macchine sviluppatore, la CLI di Claude Code, l'estensione VS Code e i client SDK CI o Agent inviano richieste al gateway, con la variabile di URL di base per il formato API del gateway che punta ad esso e ogni sviluppatore che tiene una credenziale per sviluppatore, e l'app desktop raggiunge lo stesso gateway attraverso la configurazione distribuita dall'organizzazione. In una zona etichettata la tua infrastruttura, il gateway LLM 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 di Anthropic, e frecce tratteggiate portano ad altre opzioni di provider, illustrate con Amazon Bedrock, Google Vertex AI e Microsoft Foundry come esempi." width="780" height="322" data-path="images/llm-gateway-flow.svg" />
43</Frame>
44
45Due tipi di credenziale sono coinvolti:
46
47* **Credenziali sviluppatore**: ogni sviluppatore ne tiene una propria, emessa dal gateway. Autentica lo sviluppatore al gateway e lo identifica nel tracciamento dell'utilizzo
48* **Credenziale provider**: il gateway ne tiene una per il tuo account provider, condivisa da tutto il traffico inoltrato. Non esegui il provisioning delle chiavi del provider per sviluppatore
49
50Il gateway inoltra ogni richiesta al provider che configuri, come l'API di Anthropic, [Amazon Bedrock](/it/amazon-bedrock), [Google Vertex AI](/it/google-vertex-ai), [Microsoft Foundry](/it/microsoft-foundry), o la [Claude Platform su AWS](/it/claude-platform-on-aws). Poiché Claude Code parla solo al gateway, la scelta del provider è la configurazione del gateway, non quella del client.
51
52<h2 id="roll-out-a-gateway">
53 Esegui il rollout di un gateway
54</h2>
55
56Quando sei pronto a eseguire il rollout di un gateway LLM alla tua organizzazione, la sequenza è la stessa indipendentemente dal prodotto gateway che scegli:
57
581. Distribuisci il gateway e dagli la tua credenziale del provider, in modo che possa autenticare le richieste che inoltra.
592. Emetti a ogni sviluppatore una credenziale del gateway, in modo che l'utilizzo sia attribuito allo sviluppatore e l'offboarding revoca una credenziale.
603. Distribuisci la configurazione attraverso un [file di impostazioni gestite](/it/settings#settings-files) e il tuo strumento di segreti, in modo che ogni macchina riceva l'URL di base e una credenziale. Quando entrambi sono distribuiti, gli sviluppatori non configurano nulla. Se non hai la distribuzione delle impostazioni in atto, gli sviluppatori seguono la [pagina di connessione](/it/llm-gateway-connect) per impostare le variabili stessi.
614. Fai in modo che ogni sviluppatore [verifichi la configurazione in Claude Code](/it/llm-gateway-connect#check-for-an-existing-configuration), in modo che i problemi di distribuzione emergano prima che dipendano dal gateway.
62
63[Esegui il rollout di un gateway LLM per la tua organizzazione](/it/llm-gateway-rollout) esamina ogni passaggio e mostra i file di configurazione da distribuire a ogni passaggio. Il gateway è una parte della configurazione dell'organizzazione; per l'applicazione delle politiche, la visibilità dell'utilizzo e le decisioni sulla gestione dei dati, vedi [Configura Claude Code per la tua organizzazione](/it/admin-setup).
64
65<h2 id="third-party-gateways">
66 Gateway di terze parti
67</h2>
68
69Qualsiasi gateway che espone un [formato API supportato](/it/llm-gateway-protocol#api-formats) funziona. Anthropic non approva, mantiene o controlla i prodotti gateway di terze parti. Distribuiscili seguendo la loro documentazione, quindi completa il lato Claude Code del rollout con i [passaggi di rollout](/it/llm-gateway-rollout).
70
71<h2 id="subscriptions-and-gateways">
72 Abbonamenti e gateway
73</h2>
74
75Mentre una [variabile di credenziale del gateway](/it/llm-gateway-connect#set-the-credential-variable) o `apiKeyHelper` è attiva, l'abbonamento a claude.ai di uno sviluppatore non viene utilizzato: la credenziale sostituisce l'accesso all'abbonamento per quella sessione, e i limiti di utilizzo dell'abbonamento non si applicano. Quel traffico viene fatturato per token a chiunque possieda la credenziale che il gateway inoltra, come l'account Anthropic Console della tua organizzazione, o il tuo account Bedrock, Vertex o Foundry quando il gateway instrada lì.
76
77Impostare solo `ANTHROPIC_BASE_URL`, senza una credenziale del gateway, non sostituisce l'abbonamento. Le richieste vengono comunque instradate attraverso il gateway, ma un accesso a claude.ai salvato rimane la credenziale attiva, quindi i suoi limiti di utilizzo e la fatturazione si applicano. I gateway che passano questo traffico ad Anthropic devono inoltrare la capacità OAuth in `anthropic-beta`; vedi il [riferimento delle intestazioni della richiesta](/it/llm-gateway-protocol#request-headers).
78
79<h2 id="configure-separately-from-the-gateway">
80 Configura separatamente dal gateway
81</h2>
82
83Un gateway determina dove vengono inviate le richieste API del modello. La selezione del modello, il resto del traffico di rete di Claude Code e i proxy aziendali sono configurati separatamente:
84
85* **Selezione del modello**: l'URL di base decide dove vanno le richieste, non quale modello le risponde. Scegli il modello con il comando `/model` o le variabili di ambiente del modello; vedi [come impostare il tuo modello](/it/model-config#setting-your-model)
86* **Traffico lato client**: i controlli della versione e la telemetria facoltativa del client, entrambi disabilitati con [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/it/env-vars), e il traffico di accesso quando è in uso un accesso a claude.ai o Console, vanno agli endpoint di aggiornamento e autenticazione di Anthropic piuttosto che al gateway. Vedi [requisiti di accesso alla rete](/it/network-config#network-access-requirements) per i domini
87* **Proxy aziendali**: un proxy impostato con `HTTPS_PROXY` si trova tra Claude Code e ogni server con cui parla, incluso il gateway. Se la tua rete richiede un proxy, configura entrambi; vedi [configurazione del proxy](/it/network-config#proxy-configuration)
88
89<h2 id="related-pages">
90 Pagine correlate
91</h2>
92
93* [Collega Claude Code a un gateway LLM](/it/llm-gateway-connect): imposta l'URL di base e la credenziale sulla tua macchina, con configurazione per superficie e una tabella di risoluzione dei problemi
94* [Esegui il rollout di un gateway LLM per la tua organizzazione](/it/llm-gateway-rollout): la checklist dell'amministratore per distribuire un gateway, emettere credenziali sviluppatore e distribuire impostazioni gestite
95* [Riferimento del protocollo gateway](/it/llm-gateway-protocol): cosa Claude Code invia a un gateway, per gli operatori che ne configurano uno, coprendo endpoint, intestazioni da inoltrare e pass-through delle funzionalità
96* [Configura Claude Code per la tua organizzazione](/it/admin-setup): le decisioni di rollout più ampie di cui un gateway è una parte, inclusa l'applicazione delle politiche e la visibilità dell'utilizzo