113 2) Configure Azure credentials113 2) Configure Azure credentials
114</h3>114</h3>
115 115
116Claude Code supporta due metodi di autenticazione per Microsoft Foundry. Scegli il metodo che meglio si adatta ai tuoi requisiti di sicurezza.116Claude Code supporta tre metodi di autenticazione per Microsoft Foundry. Scegli il metodo che meglio si adatta ai tuoi requisiti di sicurezza.
117 117
118**Option A: API key authentication**118**Option A: API key authentication**
119 119
128 128
129**Option B: Microsoft Entra ID authentication**129**Option B: Microsoft Entra ID authentication**
130 130
131Quando `ANTHROPIC_FOUNDRY_API_KEY` non è impostato, Claude Code utilizza automaticamente la [catena di credenziali predefinita](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview) di Azure SDK.131Quando né `ANTHROPIC_FOUNDRY_API_KEY` né `ANTHROPIC_FOUNDRY_AUTH_TOKEN` sono impostati, Claude Code utilizza automaticamente la [catena di credenziali predefinita](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview) di Azure SDK.
132Questo supporta una varietà di metodi per autenticare carichi di lavoro locali e remoti.132Questo supporta una varietà di metodi per autenticare carichi di lavoro locali e remoti.
133 133
134Negli ambienti locali, puoi comunemente utilizzare Azure CLI:134Negli ambienti locali, puoi comunemente utilizzare Azure CLI:
137az login137az login
138```138```
139 139
140**Option C: Bearer token authentication**
141
142{/* min-version: 2.1.203 */}Claude Code invia il valore di `ANTHROPIC_FOUNDRY_AUTH_TOKEN` su ogni richiesta come intestazione `Authorization: Bearer`. Utilizza questa opzione quando un altro processo, come un'applicazione host o uno script di accesso, ha già ottenuto un token di accesso per te. Richiede Claude Code v2.1.203 o successivo.
143
144Imposta la variabile su un token bearer emesso da Microsoft Entra ID per la tua risorsa:
145
146```bash theme={null}
147export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token
148```
149
150`ANTHROPIC_FOUNDRY_AUTH_TOKEN` ha la precedenza su `ANTHROPIC_FOUNDRY_API_KEY` e sulla catena di credenziali predefinita.
151
140<Note>152<Note>
141 Quando si utilizza Microsoft Foundry, il comando `/logout` non è disponibile poiché l'autenticazione viene gestita tramite le credenziali Azure.153 Quando si utilizza Microsoft Foundry, il comando `/logout` non è disponibile poiché l'autenticazione viene gestita tramite le credenziali Azure.
142</Note>154</Note>
162</h3>174</h3>
163 175
164<Warning>176<Warning>
165 Fissa versioni specifiche del modello per ogni distribuzione. Senza fissare, gli alias di modello come `sonnet` e `opus` si risolvono nel valore predefinito integrato di Claude Code per Foundry, che può essere in ritardo rispetto alla versione più recente e potrebbe non essere ancora disponibile nel tuo account. Foundry non ha un controllo del modello all'avvio, quindi le richieste non riescono quando il valore predefinito non è disponibile. Quando crei distribuzioni Azure, seleziona una versione di modello specifica piuttosto che "aggiornamento automatico alla versione più recente".177 Fissa versioni specifiche del modello per ogni distribuzione. Senza fissare, gli alias di modello come `sonnet` e `opus` si risolvono nel valore predefinito integrato di Claude Code per Microsoft Foundry, che può essere in ritardo rispetto alla versione più recente e potrebbe non essere ancora disponibile nel tuo account. Microsoft Foundry non ha un controllo del modello all'avvio, quindi le richieste non riescono quando il valore predefinito non è disponibile. Quando crei distribuzioni Azure, seleziona una versione di modello specifica piuttosto che "aggiornamento automatico alla versione più recente".
166</Warning>178</Warning>
167 179
168Imposta le variabili del modello in modo che corrispondano ai nomi di distribuzione che hai creato nel passaggio 1.180Imposta le variabili del modello in modo che corrispondano ai nomi di distribuzione che hai creato nel passaggio 1.
169 181
170Senza `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` su Foundry si risolve in Opus 4.6. Impostalo sull'ID di Opus 4.8 per utilizzare il modello più recente:182Senza `ANTHROPIC_DEFAULT_OPUS_MODEL`, l'alias `opus` su Microsoft Foundry si risolve in Opus 4.6. Impostalo sull'ID di Opus 4.8 per utilizzare il modello più recente:
171 183
172```bash theme={null}184```bash theme={null}
173export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'185export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
175export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'187export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
176```188```
177 189
178I compiti in background come la generazione del titolo della sessione utilizzano il modello piccolo/veloce, normalmente un modello della classe Haiku. Su Foundry, Claude Code utilizza per impostazione predefinita il modello primario perché non tutti gli account hanno una distribuzione Haiku. Per utilizzare Haiku per i compiti in background, imposta `ANTHROPIC_DEFAULT_HAIKU_MODEL` su una distribuzione Haiku disponibile nel tuo account, come mostrato sopra.190I compiti in background come la generazione del titolo della sessione utilizzano il modello piccolo/veloce, normalmente un modello della classe Haiku. Su Microsoft Foundry, Claude Code utilizza per impostazione predefinita il modello primario perché non tutti gli account hanno una distribuzione Haiku. Per utilizzare Haiku per i compiti in background, imposta `ANTHROPIC_DEFAULT_HAIKU_MODEL` su una distribuzione Haiku disponibile nel tuo account, come mostrato sopra.
179 191
180Per gli ID dei modelli attuali e legacy, vedi [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Vedi [Model configuration](/it/model-config#pin-models-for-third-party-deployments) per l'elenco completo delle variabili di ambiente.192Per gli ID dei modelli attuali e legacy, vedi [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Vedi [Model configuration](/it/model-config#pin-models-for-third-party-deployments) per l'elenco completo delle variabili di ambiente.
181 193
195claude207claude
196```208```
197 209
198Claude Code legge `CLAUDE_CODE_USE_FOUNDRY` e le altre variabili Foundry dall'ambiente e si connette alla tua risorsa Azure al primo prompt. A differenza di Bedrock e Vertex AI, Foundry non ha una procedura guidata di configurazione interattiva, quindi le variabili di ambiente nei passaggi 3 e 4 sono l'unico percorso di configurazione.210Claude Code legge `CLAUDE_CODE_USE_FOUNDRY` e le altre variabili Microsoft Foundry dall'ambiente e si connette alla tua risorsa Azure al primo prompt. A differenza di Amazon Bedrock e Google Cloud's Agent Platform, Microsoft Foundry non ha una procedura guidata di configurazione interattiva, quindi le variabili di ambiente nei passaggi 3 e 4 sono l'unico percorso di configurazione.
199 211
200<h2 id="azure-rbac-configuration">212<h2 id="azure-rbac-configuration">
201 Configurazione RBAC di Azure213 Configurazione RBAC di Azure
