Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
< Anthropic c0>Claude Code è uno strumento di codifica agente che legge la codebase, modifica i file, esegue i comandi e si integra con gli strumenti di sviluppo. È disponibile come strumento CLI e estensione per VS Code. Quando si configura Claude Code con Microsoft Foundry, si esegue l'agente di codifica nell'infrastruttura Azure mantenendo i dati all'interno dei limiti di conformità. Questa configurazione offre sicurezza di livello aziendale, rete privata, controllo degli accessi in base al ruolo e gestione dei costi.
Questo articolo illustra come:
- Installare e configurare l'interfaccia della riga di comando di Claude Code per Microsoft Foundry
- Configurare l'estensione Claude Code VS Code
- Eseguire l'autenticazione con chiavi API o Microsoft Entra ID
- Creare file di contesto del progetto per una migliore assistenza per l'intelligenza artificiale
- Eseguire Claude Code in GitHub Actions per l'automazione CI/CD
Per usare i modelli Claude in Microsoft Foundry, è necessario avere una sottoscrizione a pagamento Azure con un account di fatturazione in un paese o un'area geografica in cui Anthropic offre i modelli per l'acquisto. Per un elenco degli errori comuni relativi alle sottoscrizioni, vedere Messaggi di errore e soluzioni comuni. I tipi di sottoscrizione seguenti non sono attualmente supportati:
- Account aziendali situati in Corea del Sud
- sottoscrizioni Cloud Solution Provider
- Le sottoscrizioni di Azure che non hanno un metodo di fatturazione con pagamento in base al consumo attivo (ad esempio, studente, versione di prova gratuita o account basati su credito per startup)
- Sottoscrizioni sponsorizzate che usano solo crediti Azure. Note: se si dispone di un account con una carta di credito nel file, la carta di credito verrà addebitata invece di Azure Credits.
Per un elenco delle aree supportate, vedere località geografiche supportate. Si noti che la "Politica sulle aree supportate" di Anthropic può essere applicata alla disponibilità nella tua regione, controlla aree supportate per informazioni dettagliate.
Prerequisiti
- Sottoscrizione Azure con un metodo di pagamento valido. Se non si ha un abbonamento Azure, creare un account Azure a pagamento.
- Accesso a Microsoft Foundry con autorizzazioni di collaboratore per creare e gestire le risorse.
- Un progetto Microsoft Foundry creato in una delle regioni supportate per le distribuzioni del modello Claude.
- Ruolo collaboratore o proprietario nel gruppo di risorse Foundry. Per altre informazioni, vedere ruoli RBAC di Azure.
- Accesso a Azure Marketplace per distribuire i modelli Foundry dai partner.
- Per Windows, usare Git Bash (incluso con Git per Windows) o installare WSL2 (consigliato per la compatibilità completa di Linux). Consulta Installare WSL.
- (Facoltativo) interfaccia della riga di comando di Azure installato e
az logincompletato per l'autenticazione con Microsoft Entra ID.
Requisiti di sistema
| Requisito | Dettagli |
|---|---|
| Sistema operativo | macOS 13+, Ubuntu 20.04+/Debian 10+, Windows 10+ (nativo tramite Git Bash o WSL) |
| RAM | Minimo 4 GB (consigliato 8 GB) |
| Git (facoltativo, consigliato) | 2.23+ per gli helper delle richieste pull |
Distribuire un modello Claude in Foundry
Prima di configurare Claude Code, distribuire i modelli Claude disponibili necessari per Claude Code. La maggior parte dei modelli Claude supporta la distribuzione standard globale. Per altre informazioni sui tipi di distribuzione supportati, vedere Modelli Claude in Microsoft Foundry.
Claude Code usa modelli diversi per diverse attività:
Importante
La disponibilità dei modelli Claude in Microsoft Foundry potrebbe cambiare. Per l'elenco più recente dei modelli disponibili, vedere la pagina Modelli Foundry dei partner .
| Ruolo Claude Code | Distribuzione consigliata | Scopo |
|---|---|---|
| Modello primario | claude-sonnet-4-6 |
Codifica generale : velocità e qualità bilanciate |
| Modello veloce | claude-haiku-4-5 |
Operazioni rapide : letture di file, modifiche di piccole dimensioni |
| Elaborazione estesa | claude-opus-4-6 |
Attività di ragionamento complesse (facoltativo) |
Distribuire il modello direttamente in Foundry
Per distribuire un modello:
Seguire le istruzioni in Distribuire e usare modelli Claude in Microsoft Foundry per distribuire un modello Claude, ad esempio Opus 4.6.
Dopo la distribuzione, selezionare la scheda Dettagli della distribuzione e prendere nota dell'URI e della chiave di destinazione. Questi valori sono necessari per la configurazione.
Alternativa: distribuire il modello usando il router del modello
Il router del modello è un modello Foundry che indirizza in modo intelligente ogni richiesta al modello sottostante migliore in base alla complessità, ai costi e alle prestazioni delle query. La versione 2025-11-18 del router modello supporta la selezione di modelli Claude (claude-haiku-4-5, claude-sonnet-4-5, claude-opus-4-6claude-opus-4-7, e claude-opus-4-8) insieme ad altri modelli Foundry.
Nota
Il router modello potrebbe non supportare ancora alcuni modelli Claude più recenti. Se sono necessari questi modelli, distribuirli e farvi riferimento direttamente anziché usare il router del modello.
Vantaggi per gli utenti di Claude Code:
- Selezione automatica del modello: i semplici prompt instradano verso modelli più veloci e più economici. Le attività di codifica complesse instradano a modelli più idonei.
- Ottimizzazione dei costi: usare i profili di routing per bilanciare la qualità rispetto ai costi mantenendo le prestazioni di base.
- Endpoint singolo: una sola distribuzione gestisce tutte le decisioni di routing nella flotta di modelli.
Per usare il Model Router con Claude Code, distribuisci prima i modelli Claude supportati, poi distribuisci Model Router e abilitali tramite la configurazione della sottoselezione del modello.
Installare la CLI di Claude Code
Installare l'interfaccia della riga di comando di Claude Code per usare Claude Code direttamente nel terminale. Verificare quindi che claude si trova nel percorso eseguendo claude --version.
Nota
Anthropic ha deprecato il metodo di installazione via npm. Usare invece il programma di installazione nativo o Homebrew. Se è già stato installato tramite npm, eseguire claude install per eseguire la migrazione al metodo nativo.
Installazione nativa (scelta consigliata)
Le installazioni native vengono aggiornate automaticamente in background per mantenere la versione più recente.
In macOS o Windows (Git Bash o WSL), eseguire lo script del programma di installazione, che scarica e configura il file binario claude:
curl -fsSL https://claude.ai/install.sh | bash
claude --version # verify installation
Installazione con Homebrew
Se si usa macOS:
brew install --cask claude-code
claude --version # verify installation
Le installazioni homebrew non vengono aggiornate automaticamente. Eseguire brew upgrade claude-code periodicamente per ottenere le funzionalità e le correzioni di sicurezza più recenti.
Risolvere i problemi relativi alla posizione di installazione
Se il comando claude --version non viene trovato, aggiungi il percorso di installazione al PATH come segue:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
Per altre opzioni di installazione, vedere la documentazione di Claude Code.
Configurare il codice Claude per Foundry
Per configurare Claude Code per Foundry, si può usare il nome della risorsa Foundry o l'URL di base.
Per trovare il nome della risorsa Foundry dal portale Foundry:
- Passare al riquadro di spostamento in alto a sinistra e selezionare Gestisci>Project dettagli.
- Copiare il valore della risorsa principale dalla pagina Dettagli del progetto.
Per trovare l'URL di base dal portale foundry:
- Passare alla home page del portale Foundry
- Trovare l'endpoint Project e copiare la parte dell'URL che precede
/api/projects/<your-project-name>. L'URL di base è nel formatohttps://<your-resource-name>.services.ai.azure.com. Claude Code aggiunge/anthropicautomaticamente a questo URL quando si usaANTHROPIC_FOUNDRY_RESOURCE.
Impostare le variabili di ambiente per connettere Claude Code alla distribuzione di Microsoft Foundry:
# Required: Enable Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1
# Azure resource name (replace <your-resource-name> with your resource name)
export ANTHROPIC_FOUNDRY_RESOURCE=<your-resource-name>
# Or provide the full base URL:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://<your-resource-name>.services.ai.azure.com
# Optional: Specify model deployment names if different from defaults
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
La tabella seguente descrive ogni variabile:
| Variabile | Descrizione |
|---|---|
CLAUDE_CODE_USE_FOUNDRY |
Impostare su 1 per abilitare l'integrazione di Microsoft Foundry. |
ANTHROPIC_FOUNDRY_RESOURCE |
Nome della risorsa Foundry. Claude Code costruisce l'URL dell'endpoint come https://<resource-name>.services.ai.azure.com/anthropic. |
ANTHROPIC_DEFAULT_SONNET_MODEL |
Nome di distribuzione per il modello Claude Sonnet (modello principale di programmazione). |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
Nome della distribuzione per il modello Claude Haiku (operazioni veloci). |
ANTHROPIC_DEFAULT_OPUS_MODEL |
Nome della distribuzione per il modello Claude Opus (ragionamento complesso). |
Per rendere persistenti queste variabili tra le sessioni del terminale, aggiungerle al profilo della shell , ad esempio ~/.bashrc o ~/.zshrc.
Eseguire l'autenticazione con Foundry
Claude Code supporta due metodi di autenticazione per Microsoft Foundry:
- Microsoft Entra ID (scelta consigliata): usa le credenziali di interfaccia della riga di comando di Azure. Ideale per ambienti aziendali, accesso ai team e pipeline CI/CD in cui si vuole centralizzare la gestione delle identità senza gestire i segreti.
- Chiave API: usa una chiave API del progetto dal portale di Foundry. Ideale per test rapidi o ambienti in cui il interfaccia della riga di comando di Azure non è disponibile.
Opzione A: Microsoft Entra ID (scelta consigliata)
L'autenticazione di Microsoft Entra ID utilizza automaticamente le credenziali di interfaccia della riga di comando di Azure. Eseguire az login prima di avviare Claude Code:
Accedere con il interfaccia della riga di comando di Azure:
az loginSuggerimento
Se la risorsa Foundry si trova in un tenant diverso da quello predefinito interfaccia della riga di comando di Azure tenant, specificare l'ID tenant:
az login --tenant <tenant-id>Verificare che l'accesso sia destinato alla sottoscrizione corretta:
az account show
Quando si usa Microsoft Foundry, i comandi /login e /logout all'interno di Claude Code sono disabilitati. L'autenticazione viene gestita tramite le credenziali di Azure.
Claude Code rileva la sessione di interfaccia della riga di comando di Azure e la usa per l'autenticazione senza configurazione aggiuntiva.
Opzione B: Chiave API
Se si preferisce l'autenticazione della chiave API, impostare la chiave nelle variabili di ambiente.
- Nel portale Microsoft Foundry aprire la risorsa.
- Nella pagina Home, trovare il campo chiave API del progetto.
- Selezionare Copia chiave API di progetto per copiare il valore. Questa è la chiave usata per la
ANTHROPIC_FOUNDRY_API_KEYvariabile di ambiente. - Impostare la variabile di ambiente nel terminale:
export ANTHROPIC_FOUNDRY_API_KEY="<your-foundry-api-key>"
Suggerimento
È anche possibile trovare la chiave API nel portale Foundry nella scheda Dettagli della distribuzione del modello.
Configurare l'estensione VS Code
L'estensione Claude Code VS Code fornisce un'interfaccia grafica nativa per Claude Code direttamente nell'IDE.
Installare l'estensione da VS Code Marketplace.
Aprire le impostazioni di VS Code (CTRL+, o Cmd+) e cercare Claude Code: Variabili di ambiente.
Selezionare Modifica in settings.json e aggiungere la configurazione seguente:
{ "Claude Code: Environment Variables": [ { "name": "CLAUDE_CODE_USE_FOUNDRY", "value": "1" }, { "name": "ANTHROPIC_FOUNDRY_RESOURCE", "value": "<your-resource-name>" }, { "name": "ANTHROPIC_FOUNDRY_API_KEY", "value": "<optional-for-non-entra-auth>" } ] }Selezionare l'icona Spark nella barra laterale per aprire il pannello Claude Code.
Claude Code esegue l'autenticazione usando le credenziali di Azure. Esegui
az loginprima se utilizzi l'autenticazione con Microsoft Entra ID.
L'estensione supporta la modalità di accettazione automatica delle modifiche, la modalità di pianificazione, il pensiero avanzato e la gestione dei file con menzioni di tipo @, il tutto instradando alla distribuzione di Microsoft Fonderia.
Convalidare la configurazione
Verificare che Claude Code sia configurato correttamente per l'uso di Microsoft Foundry.
Aprire un terminale e accedere a una directory del progetto:
cd your-projectAvvia Claude Code:
claudeClaude Code usa per impostazione predefinita il modello Sonnet per la codifica generale. Se non sono ancora stati distribuiti tutti e tre i modelli, è possibile specificare direttamente un modello distribuito:
claude --model claude-opus-4-6Eseguire il
/statuscomando :> /statusL'output dovrebbe essere simile all'esempio seguente. Il formato esatto può variare a seconda della versione di Claude Code.
───────────────────────────────────── Version: 2.1.52 Session name: /rename to add a name Session ID: <your-session-ID> cwd: C:\WINDOWS\system32 API provider: Microsoft Foundry Microsoft Foundry Resource: <your-resource-name> Model: Default (claude-sonnet-4-6) Memory: Setting sources: ─────────────────────────────────────Confermare quanto segue nell'output dello stato del sistema:
Campo Valore previsto Fornitore di API Microsoft Foundry Risorsa Foundry Nome della risorsa Foundry Modello Il tuo modello distribuito (ad esempio, claude-sonnet-4-6)Invia una richiesta di test, ad esempio "Riepiloga la struttura di questo progetto".
Verificare che Claude Code risponda con un'analisi del progetto. Una connessione riuscita mostra il prompt interattivo di Claude Code senza errori di autenticazione.
Se Claude Code visualizza un errore simile a "Impossibile ottenere il token" o "modello non disponibile", vedere la sezione Risoluzione dei problemi .
Creare un contesto di progetto con CLAUDE.md
È possibile fornire istruzioni aggiuntive e indicazioni a Claude Code usando CLAUDE.md i file. Claude Code cerca CLAUDE.md i file nelle posizioni seguenti e li unisce dall'alto verso il basso (ovvero i file vengono caricati in ordine, con i file successivi che sostituiscono quelli precedenti), fornendo il contesto sulle preferenze personali, i dettagli specifici del progetto e l'attività corrente:
-
~/.claude/CLAUDE.md– Impostazioni predefinite globali in tutti i progetti -
./CLAUDE.md– Impostazioni della radice del repository -
./current-dir/CLAUDE.md– Specifiche della directory corrente
Claude Code supporta anche regole di progetto () e memoria locale (.claude/rules/*.mdCLAUDE.local.md) per un controllo più granulare. Per la gerarchia di memoria completa, vedere la documentazione relativa alla memoria di Claude Code.
Nell'esempio seguente viene illustrato un file CLAUDE.md per un progetto Microsoft Agent Framework. Creare un file simile nella radice del progetto per consentire a Claude Code di comprendere la codebase:
# Project: Customer Service Agent
## Overview
Multi-agent system using Microsoft Agent Framework with Foundry Agent Service.
## Tech Stack
- Python 3.11+
- agent-framework (Microsoft Agent Framework Python SDK)
- Microsoft Foundry for hosted agents
- MCP tools for enterprise data access
## Architecture
- `src/agents/` - Agent definitions (triage, specialist, escalation)
- `src/tools/` - MCP tool implementations
- `src/workflows/` - Multi-agent orchestration
- `tests/` - pytest with async fixtures
## Commands
```bash
# Run locally
python -m src.main
# Test
pytest tests/ -v
# Deploy to Foundry Agent Service
az ai agent deploy --config deploy.yaml
```
## Code Patterns
Use `AzureAIAgentClient` with `AzureCliCredential`:
```python
async with AzureAIAgentClient(async_credential=AzureCliCredential()) as client:
agent = client.create_agent(instructions="...", tools=[...])
```
## Current Sprint
- Implementing RAG grounding with Foundry IQ
- Adding Fabric connector for sales data
Dopo aver creato un CLAUDE.md file, avviare Claude Code nella directory del progetto per caricare il contesto:
# Start Claude Code in your project
cd your-project
claude
# Or run a one-off command
claude "explain the agent orchestration in src/workflows/"
Configurare Controllo degli accessi in base al ruolo di Azure
Per concedere ai membri del team l'accesso ai modelli Claude ospitati in Foundry, assegnare uno dei ruoli predefiniti seguenti:
| Ruolo | Autorizzazioni |
|---|---|
| Utente di Foundry | Richiamare modelli, visualizzare le distribuzioni |
| Utente di Servizi cognitivi | Richiamare modelli, visualizzare i deployment (ruolo legacy dei Servizi di Azure AI) |
Importante
I ruoli di Controllo degli accessi in base al ruolo di Foundry sono stati recentemente rinominati. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager erano precedentemente denominati Azure AI User, Azure AI Owner, Azure AI Account Owner e Azure AI Project Manager. È possibile che i nomi precedenti vengano visualizzati in alcune posizioni durante l'esecuzione della ridenominazione. Gli ID ruolo e le autorizzazioni di base sono invariati dalla ridenominazione.
Il ruolo Utente Foundry è il ruolo nativo di Foundry consigliato. Il ruolo Utente di Servizi cognitivi è un ruolo legacy che concede anche autorizzazioni di chiamata al modello a livello di risorsa Azure.
Questi ruoli includono tutte le autorizzazioni necessarie per l'esecuzione di Claude Code con Foundry.
Per un accesso più restrittivo, creare un ruolo personalizzato con ambito per le azioni di dati specifiche richieste dal team. Per indicazioni sulla definizione di ruoli personalizzati, vedere Controllo degli accessi in base al ruolo per Microsoft Foundry.
Eseguire il codice Claude in GitHub Actions
Claude Code si integra con GitHub Actions per l'automazione CI/CD. Archiviare la chiave API nell'archivio dei segreti del repository prima di usare questi flussi di lavoro.
Generare test sulle richieste pull
Creare un flusso di lavoro che genera test quando i file dell'agente o degli strumenti cambiano:
name: Generate Agent Tests
on:
pull_request:
paths:
- 'src/agents/**'
- 'src/tools/**'
jobs:
generate-tests:
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
steps:
- uses: actions/checkout@v4
- name: Run Claude Code
uses: anthropics/claude-code-action@v1
with:
prompt: |
Review the changed agent files and generate pytest tests.
Use async fixtures for AIProjectClient mocking.
Follow patterns in tests/conftest.py.
allowed_tools: "edit,write,bash"
env:
CLAUDE_CODE_USE_FOUNDRY: "1"
ANTHROPIC_FOUNDRY_RESOURCE: ${{ secrets.AZURE_FOUNDRY_RESOURCE }}
ANTHROPIC_FOUNDRY_API_KEY: ${{ secrets.AZURE_FOUNDRY_API_KEY }}
Attivare la revisione del codice con @claude
Creare un flusso di lavoro che risponda alle @claude menzioni nei commenti delle pull request:
name: Claude PR Assistant
on:
issue_comment:
types: [created]
jobs:
respond:
if: contains(github.event.comment.body, '@claude')
runs-on: ubuntu-latest
permissions:
contents: read
pull-requests: write
steps:
- uses: actions/checkout@v4
- name: Claude Review
uses: anthropics/claude-code-action@v1
with:
prompt: ${{ github.event.comment.body }}
context: "PR #${{ github.event.issue.number }}"
env:
CLAUDE_CODE_USE_FOUNDRY: "1"
ANTHROPIC_FOUNDRY_RESOURCE: ${{ secrets.AZURE_FOUNDRY_RESOURCE }}
ANTHROPIC_FOUNDRY_API_KEY: ${{ secrets.AZURE_FOUNDRY_API_KEY }}
Monitorare l'utilizzo
Monitorare l'utilizzo di Claude Code nel portale foundry:
Passare a Microsoft Foundry e aprire il progetto.
Passare a Opera per visualizzare le metriche di utilizzo:
- Utilizzo di token in base al modello
- Latenza della richiesta
- Percentuali di errore e corrispondenze di limite di flusso in entrata
Per impostare i limiti dei token per richiesta, configurare la ANTHROPIC_MAX_TOKENS variabile di ambiente:
Nota
La ANTHROPIC_MAX_TOKENS variabile potrebbe non essere supportata in tutte le versioni di Claude Code. Consultare la documentazione di Claude Code per le variabili di ambiente supportate più recenti.
export ANTHROPIC_MAX_TOKENS=100000
Per le opzioni di configurazione che controllano l'utilizzo e i costi dei token, ad esempio i limiti dei token specifici del modello, vedere la documentazione sulla configurazione di Claude Code.
Pulire le risorse
Se le distribuzioni del modello Claude non sono più necessarie, eliminarle per liberare slot di distribuzione e quota nella risorsa. I modelli Claude usano distribuzioni Standard globali con fatturazione con pagamento in base al token, quindi le distribuzioni inattive non comportano addebiti. Tuttavia, ogni distribuzione viene conteggiata rispetto al limite di distribuzione di 32 per risorsa.
Eliminare le implementazioni nel portale Foundry
Usare uno di questi percorsi di spostamento:
- Selezionare Operare nel riquadro di navigazione superiore, quindi selezionare Asset>Modelli dal riquadro di navigazione a sinistra. Selezionare la distribuzione da eliminare e quindi selezionare Elimina.
- Selezionare Compila nel riquadro di spostamento superiore, quindi selezionare Modelli nel riquadro di spostamento a sinistra. Selezionare il nome della distribuzione per aprire la relativa pagina dei dettagli, selezionare la scheda Dettagli e quindi selezionare Elimina nel pannello superiore.
Eliminare le distribuzioni con il interfaccia della riga di comando di Azure
Eseguire il comando az cognitiveservices account deployment delete per ogni distribuzione:
az cognitiveservices account deployment delete \
--deployment-name <deployment-name> \
--name <resource-name> \
--resource-group <resource-group-name>
Sostituire <deployment-name> con il nome della distribuzione del modello (ad esempio claude-sonnet-4-6), <resource-name> con il nome della risorsa Foundry e <resource-group-name> con il gruppo di risorse che contiene la risorsa Foundry.
Risoluzione dei problemi
| Problema | Soluzione |
|---|---|
| Autorizzazione non riuscita (HTTP 401/403) | Verificare che az login sia stata completata correttamente o che la chiave API sia impostata correttamente. Verificare che l'account abbia accesso alla risorsa Foundry. |
| Claude Code inizia ma non riesce a trovare modelli | Verifica che ANTHROPIC_FOUNDRY_RESOURCE corrisponda al nome della risorsa e che i valori di ANTHROPIC_DEFAULT_*_MODEL corrispondano ai nomi di distribuzione. |
| Limite di velocità superato (HTTP 429) | Controllare le quote nel portale foundry in Gestisci>quota. Valutare la possibilità di modificare i limiti dei token in base alla documentazione sulla configurazione di Claude Code. |
| Estensione VS Code non si connette | Assicurarsi che le variabili di ambiente siano impostate prima di avviare VS Code. Provare ad avviare VS Code dal terminale dopo aver impostato le variabili. |
| Problemi relativi all'estensione WSL + VS Code | L'estensione potrebbe verificare la presenza della chiave API nell'host Windows anziché in WSL. Impostare la variabile di ambiente sia sull'host Windows che su WSL, quindi avviare un nuovo terminale da WSL ed eseguire code . |
| Errori nell'area | I modelli Claude sono disponibili solo negli Stati Uniti orientali 2 e in Svezia centrale. |
| "Impossibile ottenere il token da azureADTokenProvider: Autenticazione chainedTokenCredential non riuscita" | Accedere con az logino impostare ANTHROPIC_FOUNDRY_API_KEY per l'autenticazione della chiave API. |
"Il modello <model-name> non è disponibile nell'ambiente di distribuzione Foundry" |
Distribuire il modello mancante nel portale Foundry. Claude Code richiede che ogni ruolo del modello (Sonnet, Haiku, Opus) abbia una distribuzione corrispondente. |
| "Il tenant del token non corrisponde al tenant della risorsa" | Il interfaccia della riga di comando di Azure è connesso a un tenant diverso rispetto alla risorsa Foundry. Eseguire az login --tenant <tenant-id> per accedere al tenant corretto. |
| La creazione dell'implementazione non riesce nel portale Foundry | Verificare di avere il ruolo di Collaboratore o Proprietario sul gruppo di risorse e che la sottoscrizione abbia l'accesso ad Azure Marketplace abilitato. |
| Claude Code richiede accesso all'account Anthropic | Verificare che CLAUDE_CODE_USE_FOUNDRY=1 sia impostato. Senza questa variabile, Claude Code usa l'API di Anthropic predefinita. |
Contenuto correlato
- Modelli Claude in Microsoft Foundry
- Distribuire e usare i modelli Claude in Microsoft Foundry
- Dati, privacy e sicurezza per i modelli Claude
- Quote e limiti dei modelli Microsoft Foundry
- Monitorare l'utilizzo e i costi del modello
- Configurare Claude Desktop per Microsoft Foundry
- Claude in Microsoft Foundry (documentazione di Anthropic)
- Documentazione del codice Claude (documentazione Anthropic)
- Codice Claude in Microsoft Foundry (documentazione Anthropic)