SpyBara
Go Premium

microsoft-foundry.md 2026-05-15 22:58 UTC to 2026-05-17 01:01 UTC

10 added, 0 removed.

2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19

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) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true"> ; 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 <div className="cc-cs not-prose"> <div className="cc-cs-card"> <div className="cc-cs-text"> Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.

<div className="cc-cs-actions"> <a href={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:

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

2. 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

3. 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

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:

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-7'
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

5. 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":

Risorse aggiuntive