Claude Code su Microsoft Foundry
Scopri come configurare Claude Code tramite Microsoft Foundry, inclusi setup, configurazione e risoluzione dei problemi.
export const ContactSalesCard = ({surface}) => {
const utm = content => utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content};
const iconArrowRight = (size = 13) => ;
const STYLES = .cc-cs { --cs-slate: #141413; --cs-clay: #d97757; --cs-clay-deep: #c6613f; --cs-gray-000: #ffffff; --cs-gray-700: #3d3d3a; --cs-border-default: rgba(31, 30, 29, 0.15); font-family: inherit; } .dark .cc-cs { --cs-slate: #f0eee6; --cs-gray-000: #262624; --cs-gray-700: #bfbdb4; --cs-border-default: rgba(240, 238, 230, 0.14); } .cc-cs-card { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 14px 16px; margin: 0; background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default); border-radius: 8px; flex-wrap: wrap; } .cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; } .cc-cs-text strong { font-weight: 550; color: var(--cs-slate); } .cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; } .cc-cs-btn-clay { display: inline-flex; align-items: center; gap: 8px; background: var(--cs-clay-deep); color: #fff; border: none; border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; transition: background-color 0.15s; white-space: nowrap; } .cc-cs-btn-clay:hover { background: var(--cs-clay); } .cc-cs-btn-ghost { display: inline-flex; align-items: center; gap: 8px; background: transparent; color: var(--cs-gray-700); border: 0.5px solid var(--cs-border-default); border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; } .cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); } .dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); } @media (max-width: 720px) { .cc-cs-actions { width: 100%; } };
return
https://claude.com/pricing?${utm('view_plans')}#plans-business} className="cc-cs-btn-ghost">
View plans
<a href={https://claude.com/contact-sales?${utm('contact_sales')}} className="cc-cs-btn-clay">
Contact sales {iconArrowRight()}
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)
Setup
1. Provision Microsoft Foundry resource
Per prima cosa, crea una risorsa Claude in Azure:
- Accedi al portale Microsoft Foundry
- Crea una nuova risorsa, annotando il nome della risorsa
- Crea distribuzioni per i modelli Claude:
- Claude Opus
- Claude Sonnet
- Claude Haiku
2) Configure Azure credentials
Claude Code supporta due metodi di autenticazione per Microsoft Foundry. Scegli il metodo che meglio si adatta ai tuoi requisiti di sicurezza.
Option A: API key authentication
- Accedi alla tua risorsa nel portale Microsoft Foundry
- Vai alla sezione Endpoints and keys
- Copia API Key
- Imposta la variabile di ambiente:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
Option B: Microsoft Entra ID authentication
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. Configure Claude Code
Imposta le seguenti variabili di ambiente per abilitare Microsoft Foundry:
# Enable Microsoft Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1
# Azure resource name (replace {resource} with your resource name)
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Or provide the full base URL:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic
4. Pin model versions
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 Models overview. Vedi Model configuration 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
5. Run 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.