Vai al contenuto principale

​
Prerequisiti

Prima di configurare Claude Code con Microsoft Foundry, assicurati di avere:
  • Un abbonamento Azure con accesso a Microsoft Foundry
  • Autorizzazioni RBAC per creare risorse e distribuzioni di Microsoft Foundry
  • Azure CLI installato e configurato (facoltativo - necessario solo se non hai un altro meccanismo per ottenere le credenziali)
Se stai distribuendo Claude Code a più utenti, fissa le versioni del tuo modello per evitare problemi quando Anthropic rilascia nuovi modelli.

​
Setup

​
  1. Provisioning della risorsa Microsoft Foundry

Per prima cosa, crea una risorsa Claude in Azure:
  1. Accedi al portale Microsoft Foundry
  2. Crea una nuova risorsa, annotando il nome della risorsa
  3. Crea distribuzioni per i modelli Claude:
    • Claude Opus
    • Claude Sonnet
    • Claude Haiku

​
  1. Configurare le credenziali Azure

Claude Code supporta due metodi di autenticazione per Microsoft Foundry. Scegli il metodo che meglio si adatta ai tuoi requisiti di sicurezza. Opzione A: Autenticazione tramite chiave API
  1. Accedi alla tua risorsa nel portale Microsoft Foundry
  2. Vai alla sezione Endpoint e chiavi
  3. Copia Chiave API
  4. Imposta la variabile di ambiente:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
Opzione B: Autenticazione Microsoft Entra ID 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
Quando si utilizza Microsoft Foundry, il comando /logout non è disponibile poiché l’autenticazione viene gestita tramite le credenziali Azure.

​
  1. Configurare Claude Code

Imposta le seguenti variabili di ambiente per abilitare Microsoft Foundry: 
# Abilita l'integrazione Microsoft Foundry
export 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

​
  1. Fissa le versioni del modello

Fissa versioni specifiche del modello per ogni distribuzione. Se utilizzi alias di modello (sonnet, opus, haiku) senza fissare, Claude Code potrebbe tentare di utilizzare una versione di modello più recente che non è disponibile nel tuo account Foundry, interrompendo gli utenti esistenti quando Anthropic rilascia aggiornamenti. Quando crei distribuzioni Azure, seleziona una versione di modello specifica piuttosto che “aggiornamento automatico alla versione più recente”.
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.8 per utilizzare il modello più recente: 
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
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. Per gli ID dei modelli attuali e legacy, vedi Panoramica dei modelli. Vedi Configurazione del modello per l’elenco completo delle variabili di ambiente. 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

​
  1. Esegui Claude Code

Con le variabili di ambiente impostate, avvia Claude Code dalla directory del tuo progetto: 
claude
Claude 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.

​
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: 
{
  "permissions": [
    {
      "dataActions": [
        "Microsoft.CognitiveServices/accounts/providers/*"
      ]
    }
  ]
}
Per i dettagli, vedi Documentazione RBAC di Microsoft Foundry.

​
Risoluzione dei problemi

Se ricevi un errore “Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed”:
  • Configura Entra ID nell’ambiente, oppure imposta ANTHROPIC_FOUNDRY_API_KEY.

​
Risorse aggiuntive