Quando ANTHROPIC_FOUNDRY_API_KEY non è impostato, Claude Code utilizza automaticamente la catena di credenziali predefinita di Azure SDK.
Questo supporta una varietà di metodi per autenticare carichi di lavoro locali e remoti.
Negli ambienti locali, puoi comunemente utilizzare Azure CLI:
az login
3. Configurare Claude Code
Imposta le seguenti variabili di ambiente per abilitare Microsoft Foundry:
# Abilita l'integrazione Microsoft Foundryexport CLAUDE_CODE_USE_FOUNDRY=1# Nome della risorsa Azure (sostituisci {resource} con il nome della tua risorsa)export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Oppure fornisci l'URL di base completo:# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic
4. Fissa le versioni del modello
Imposta le variabili del modello in modo che corrispondano ai nomi di distribuzione che hai creato nel passaggio 1.
Senza ANTHROPIC_DEFAULT_OPUS_MODEL, l'alias opus su Foundry si risolve in Opus 4.6. Impostalo sull'ID di Opus 4.7 per utilizzare il modello più recente:
I 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.
Prompt caching è abilitato automaticamente. Per richiedere un TTL della cache di 1 ora invece del valore predefinito di 5 minuti, imposta la seguente variabile; le scritture della cache con un TTL di 1 ora vengono fatturate a una tariffa più elevata:
export ENABLE_PROMPT_CACHING_1H=1
Configurazione RBAC di Azure
I ruoli predefiniti Azure AI User e Cognitive Services User includono tutte le autorizzazioni necessarie per invocare i modelli Claude.
Per autorizzazioni più restrittive, crea un ruolo personalizzato con quanto segue:
166I 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.
167
166Per gli ID dei modelli attuali e legacy, vedi [Panoramica dei modelli](https://platform.claude.com/docs/en/about-claude/models/overview). Vedi [Configurazione del modello](/it/model-config#pin-models-for-third-party-deployments) per l'elenco completo delle variabili di ambiente.168Per gli ID dei modelli attuali e legacy, vedi [Panoramica dei modelli](https://platform.claude.com/docs/en/about-claude/models/overview). Vedi [Configurazione del modello](/it/model-config#pin-models-for-third-party-deployments) per l'elenco completo delle variabili di ambiente.
167169
168[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) è abilitato automaticamente. Per richiedere un TTL della cache di 1 ora invece del valore predefinito di 5 minuti, imposta la seguente variabile; le scritture della cache con un TTL di 1 ora vengono fatturate a una tariffa più elevata:170[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) è abilitato automaticamente. Per richiedere un TTL della cache di 1 ora invece del valore predefinito di 5 minuti, imposta la seguente variabile; le scritture della cache con un TTL di 1 ora vengono fatturate a una tariffa più elevata: