6 6
7> Scopri come configurare Claude Code tramite Microsoft Foundry, inclusi setup, configurazione e risoluzione dei problemi.7> Scopri come configurare Claude Code tramite Microsoft Foundry, inclusi setup, configurazione e risoluzione dei problemi.
8 8
9export const ContactSalesCard = ({surface}) => {
10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;
11 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">
12 <line x1="5" y1="12" x2="19" y2="12" />
13 <polyline points="12 5 19 12 12 19" />
14 </svg>;
15 const STYLES = `
16.cc-cs {
17 --cs-slate: #141413;
18 --cs-clay: #d97757;
19 --cs-clay-deep: #c6613f;
20 --cs-gray-000: #ffffff;
21 --cs-gray-700: #3d3d3a;
22 --cs-border-default: rgba(31, 30, 29, 0.15);
23 font-family: inherit;
24}
25.dark .cc-cs {
26 --cs-slate: #f0eee6;
27 --cs-gray-000: #262624;
28 --cs-gray-700: #bfbdb4;
29 --cs-border-default: rgba(240, 238, 230, 0.14);
30}
31.cc-cs-card {
32 display: flex; align-items: center; justify-content: space-between;
33 gap: 16px; padding: 14px 16px; margin: 0;
34 background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);
35 border-radius: 8px; flex-wrap: wrap;
36}
37.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }
38.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }
39.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }
40.cc-cs-btn-clay {
41 display: inline-flex; align-items: center; gap: 8px;
42 background: var(--cs-clay-deep); color: #fff; border: none;
43 border-radius: 8px; padding: 8px 14px;
44 font-size: 13px; font-weight: 500;
45 transition: background-color 0.15s; white-space: nowrap;
46}
47.cc-cs-btn-clay:hover { background: var(--cs-clay); }
48.cc-cs-btn-ghost {
49 display: inline-flex; align-items: center; gap: 8px;
50 background: transparent; color: var(--cs-gray-700);
51 border: 0.5px solid var(--cs-border-default);
52 border-radius: 8px; padding: 8px 14px;
53 font-size: 13px; font-weight: 500;
54}
55.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }
56.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }
57@media (max-width: 720px) {
58 .cc-cs-actions { width: 100%; }
59}
60`;
61 return <div className="cc-cs not-prose">
62 <style>{STYLES}</style>
63 <div className="cc-cs-card">
64 <div className="cc-cs-text">
65 <strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.
66 </div>
67 <div className="cc-cs-actions">
68 <a href={`https://claude.com/pricing?${utm('view_plans')}#plans-business`} className="cc-cs-btn-ghost">
69 View plans
70 </a>
71 <a href={`https://claude.com/contact-sales?${utm('contact_sales')}`} className="cc-cs-btn-clay">
72 Contact sales {iconArrowRight()}
73 </a>
74 </div>
75 </div>
76 </div>;
77};
78
79<ContactSalesCard surface="foundry" />
80
9<h2 id="prerequisites">81<h2 id="prerequisites">
10 Prerequisiti82 Prerequisiti
11</h2>83</h2>
17* Azure CLI installato e configurato (facoltativo - necessario solo se non hai un altro meccanismo per ottenere le credenziali)89* Azure CLI installato e configurato (facoltativo - necessario solo se non hai un altro meccanismo per ottenere le credenziali)
18 90
19<Note>91<Note>
20 Se stai distribuendo Claude Code a più utenti, [fissa le versioni del tuo modello](#4-pin-model-versions) per evitare problemi quando Anthropic rilascia nuovi modelli.92 Se stai distribuendo Claude Code a più utenti, [fissa le versioni del tuo modello](#4-pin-model-versions) prima di implementare.
21</Note>93</Note>
22 94
23<h2 id="setup">95<h2 id="setup">
25</h2>97</h2>
26 98
27<h3 id="1-provision-microsoft-foundry-resource">99<h3 id="1-provision-microsoft-foundry-resource">
28 1. Provisioning della risorsa Microsoft Foundry100 1. Provision Microsoft Foundry resource
29</h3>101</h3>
30 102
31Per prima cosa, crea una risorsa Claude in Azure:103Per prima cosa, crea una risorsa Claude in Azure:
38 * Claude Haiku110 * Claude Haiku
39 111
40<h3 id="2-configure-azure-credentials">112<h3 id="2-configure-azure-credentials">
41 2) Configurare le credenziali Azure113 2) Configure Azure credentials
42</h3>114</h3>
43 115
44Claude Code supporta due metodi di autenticazione per Microsoft Foundry. Scegli il metodo che meglio si adatta ai tuoi requisiti di sicurezza.116Claude Code supporta due metodi di autenticazione per Microsoft Foundry. Scegli il metodo che meglio si adatta ai tuoi requisiti di sicurezza.
45 117
46**Opzione A: Autenticazione tramite chiave API**118**Option A: API key authentication**
47 119
481. Accedi alla tua risorsa nel portale Microsoft Foundry1201. Accedi alla tua risorsa nel portale Microsoft Foundry
492. Vai alla sezione **Endpoint e chiavi**1212. Vai alla sezione **Endpoints and keys**
503. Copia **Chiave API**1223. Copia **API Key**
514. Imposta la variabile di ambiente:1234. Imposta la variabile di ambiente:
52 124
53```bash theme={null}125```bash theme={null}
54export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key126export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
55```127```
56 128
57**Opzione B: Autenticazione Microsoft Entra ID**129**Option B: Microsoft Entra ID authentication**
58 130
59Quando `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 `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.
60Questo 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.
70</Note>142</Note>
71 143
72<h3 id="3-configure-claude-code">144<h3 id="3-configure-claude-code">
73 3. Configurare Claude Code145 3. Configure Claude Code
74</h3>146</h3>
75 147
76Imposta le seguenti variabili di ambiente per abilitare Microsoft Foundry:148Imposta le seguenti variabili di ambiente per abilitare Microsoft Foundry:
77 149
78```bash theme={null}150```bash theme={null}
79# Abilita l'integrazione Microsoft Foundry151# Enable Microsoft Foundry integration
80export CLAUDE_CODE_USE_FOUNDRY=1152export CLAUDE_CODE_USE_FOUNDRY=1
81 153
82# Nome della risorsa Azure (sostituisci {resource} con il nome della tua risorsa)154# Azure resource name (replace {resource} with your resource name)
83export ANTHROPIC_FOUNDRY_RESOURCE={resource}155export ANTHROPIC_FOUNDRY_RESOURCE={resource}
84# Oppure fornisci l'URL di base completo:156# Or provide the full base URL:
85# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic157# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic
86```158```
87 159
88<h3 id="4-pin-model-versions">160<h3 id="4-pin-model-versions">
89 4. Fissa le versioni del modello161 4. Pin model versions
90</h3>162</h3>
91 163
92<Warning>164<Warning>
93 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".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".
94</Warning>166</Warning>
95 167
96Imposta le variabili del modello in modo che corrispondano ai nomi di distribuzione che hai creato nel passaggio 1.168Imposta le variabili del modello in modo che corrispondano ai nomi di distribuzione che hai creato nel passaggio 1.
105 177
106I 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.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.
107 179
108Per 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.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.
109 181
110[Prompt caching](/it/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:182[Prompt caching](/it/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:
111 183
114```186```
115 187
116<h3 id="5-run-claude-code">188<h3 id="5-run-claude-code">
117 5. Esegui Claude Code189 5. Run Claude Code
118</h3>190</h3>
119 191
120Con le variabili di ambiente impostate, avvia Claude Code dalla directory del tuo progetto:192Con le variabili di ambiente impostate, avvia Claude Code dalla directory del tuo progetto:
