Erstellen Sie eine neue Ressource und notieren Sie sich Ihren Ressourcennamen
Erstellen Sie Bereitstellungen für die Claude-Modelle und notieren Sie sich den Bereitstellungsnamen, den Sie jedem geben; Sie werden diese Namen in Schritt 4 als Modellvariablen festlegen:
Claude Opus
Claude Sonnet
Claude Haiku
2) Azure-Anmeldedaten konfigurieren
Claude Code unterstützt drei Authentifizierungsmethoden für Microsoft Foundry. Wählen Sie die Methode, die Ihren Sicherheitsanforderungen am besten entspricht.
Option A: API-Schlüssel-Authentifizierung
Navigieren Sie zu Ihrer Ressource im Microsoft Foundry-Portal
Gehen Sie zum Abschnitt Endpunkte und Schlüssel
Kopieren Sie API-Schlüssel
Legen Sie die Umgebungsvariable fest und ersetzen Sie your-azure-api-key durch den Schlüssel, den Sie kopiert haben:
Wenn weder ANTHROPIC_FOUNDRY_API_KEY noch ANTHROPIC_FOUNDRY_AUTH_TOKEN gesetzt ist, verwendet Claude Code automatisch die Azure SDK Standard-Anmeldekette.
Dies unterstützt eine Vielzahl von Methoden zur Authentifizierung lokaler und Remote-Workloads.
In lokalen Umgebungen können Sie häufig die Azure CLI verwenden:
az login
Option C: Bearer-Token-Authentifizierung
{/* min-version: 2.1.203 */}Claude Code sendet den Wert von ANTHROPIC_FOUNDRY_AUTH_TOKEN bei jeder Anfrage als Authorization: Bearer-Header. Verwenden Sie diese Option, wenn ein anderer Prozess, z. B. eine Host-Anwendung oder ein Anmeldeskript, bereits ein Zugriffstoken für Sie erhalten hat. Erfordert Claude Code v2.1.203 oder später.
Legen Sie die Variable auf ein Bearer-Token fest, das Microsoft Entra ID für Ihre Ressource ausgestellt hat:
ANTHROPIC_FOUNDRY_AUTH_TOKEN hat Vorrang vor ANTHROPIC_FOUNDRY_API_KEY und vor der Standard-Anmeldekette.
3. Claude Code konfigurieren
Legen Sie die folgenden Umgebungsvariablen fest, um Microsoft Foundry zu aktivieren:
# Microsoft Foundry-Integration aktivierenexport CLAUDE_CODE_USE_FOUNDRY=1# Azure-Ressourcenname (ersetzen Sie {resource} durch Ihren Ressourcennamen)export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Oder geben Sie die vollständige Basis-URL an:# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic
4. Modellversionen fixieren
Legen Sie die Modellvariablen so fest, dass sie den Bereitstellungsnamen entsprechen, die Sie in Schritt 1 erstellt haben.
Ohne ANTHROPIC_DEFAULT_OPUS_MODEL wird der opus-Alias auf Microsoft Foundry zu Opus 4.6 aufgelöst. Legen Sie ihn auf die Opus 4.8-ID fest, um das neueste Modell zu verwenden:
Hintergrundaufgaben wie die Generierung von Sitzungstiteln verwenden das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Bei Microsoft Foundry setzt Claude Code dies standardmäßig auf das primäre Modell, da nicht jedes Konto eine Haiku-Bereitstellung hat. Um Haiku für Hintergrundaufgaben zu verwenden, legen Sie ANTHROPIC_DEFAULT_HAIKU_MODEL auf eine Haiku-Bereitstellung fest, die in Ihrem Konto verfügbar ist, wie oben gezeigt.
Aktuelle und ältere Modell-IDs finden Sie unter Modellübersicht. Siehe Modellkonfiguration für die vollständige Liste der Umgebungsvariablen.
Prompt Caching ist automatisch aktiviert. Um stattdessen eine 1-Stunden-Cache-TTL anstelle des 5-Minuten-Standards anzufordern, legen Sie die folgende Variable fest; Cache-Schreibvorgänge mit einer 1-Stunden-TTL werden mit einem höheren Satz abgerechnet:
export ENABLE_PROMPT_CACHING_1H=1
5. Claude Code ausführen
Mit den gesetzten Umgebungsvariablen starten Sie Claude Code aus Ihrem Projektverzeichnis:
claude
Claude Code liest CLAUDE_CODE_USE_FOUNDRY und die anderen Microsoft Foundry-Variablen aus der Umgebung und verbindet sich bei der ersten Eingabeaufforderung mit Ihrer Azure-Ressource. Im Gegensatz zu Amazon Bedrock und Google Cloud's Agent Platform hat Microsoft Foundry keinen interaktiven Setup-Assistenten, daher sind die Umgebungsvariablen in den Schritten 3 und 4 der einzige Konfigurationspfad.
Um Ihre Einrichtung zu überprüfen, führen Sie /status in Claude Code aus. Die API-Provider-Zeile zeigt Microsoft Foundry zusammen mit dem Ressourcennamen oder der Basis-URL, die Sie konfiguriert haben.
Azure RBAC-Konfiguration
Die Standardrollen Azure AI User und Cognitive Services User enthalten alle erforderlichen Berechtigungen zum Aufrufen von Claude-Modellen.
Für restriktivere Berechtigungen erstellen Sie eine benutzerdefinierte Rolle mit Folgendem:
Wenn Sie einen Fehler erhalten „Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":
Konfigurieren Sie Entra ID in der Umgebung, oder legen Sie ANTHROPIC_FOUNDRY_API_KEY fest.
Wenn Anfragen mit wiederholten Verbindungsfehlern bei der ersten Eingabeaufforderung fehlschlagen:
Überprüfen Sie, dass ANTHROPIC_FOUNDRY_RESOURCE auf Ihren tatsächlichen Ressourcennamen und nicht auf einen Platzhalter gesetzt ist. Claude Code erstellt die Endpunkt-URL aus diesem Wert, daher verweist ein falscher Name auf einen Host, der nicht vorhanden ist.
1051. Navigieren Sie zum [Microsoft Foundry-Portal](https://ai.azure.com/)1051. Navigieren Sie zum [Microsoft Foundry-Portal](https://ai.azure.com/)
1062. Erstellen Sie eine neue Ressource und notieren Sie sich Ihren Ressourcennamen1062. Erstellen Sie eine neue Ressource und notieren Sie sich Ihren Ressourcennamen
1073. Erstellen Sie Bereitstellungen für die Claude-Modelle:1073. Erstellen Sie Bereitstellungen für die Claude-Modelle und notieren Sie sich den Bereitstellungsnamen, den Sie jedem geben; Sie werden diese Namen in Schritt 4 als Modellvariablen festlegen:
108 * Claude Opus108 * Claude Opus
109 * Claude Sonnet109 * Claude Sonnet
110 * Claude Haiku110 * Claude Haiku
1201. Navigieren Sie zu Ihrer Ressource im Microsoft Foundry-Portal1201. Navigieren Sie zu Ihrer Ressource im Microsoft Foundry-Portal
1212. Gehen Sie zum Abschnitt **Endpunkte und Schlüssel**1212. Gehen Sie zum Abschnitt **Endpunkte und Schlüssel**
1223. Kopieren Sie **API-Schlüssel**1223. Kopieren Sie **API-Schlüssel**
1234. Legen Sie die Umgebungsvariable fest:1234. Legen Sie die Umgebungsvariable fest und ersetzen Sie `your-azure-api-key` durch den Schlüssel, den Sie kopiert haben:
210Claude Code liest `CLAUDE_CODE_USE_FOUNDRY` und die anderen Microsoft Foundry-Variablen aus der Umgebung und verbindet sich bei der ersten Eingabeaufforderung mit Ihrer Azure-Ressource. Im Gegensatz zu Amazon Bedrock und Google Cloud's Agent Platform hat Microsoft Foundry keinen interaktiven Setup-Assistenten, daher sind die Umgebungsvariablen in den Schritten 3 und 4 der einzige Konfigurationspfad.210Claude Code liest `CLAUDE_CODE_USE_FOUNDRY` und die anderen Microsoft Foundry-Variablen aus der Umgebung und verbindet sich bei der ersten Eingabeaufforderung mit Ihrer Azure-Ressource. Im Gegensatz zu Amazon Bedrock und Google Cloud's Agent Platform hat Microsoft Foundry keinen interaktiven Setup-Assistenten, daher sind die Umgebungsvariablen in den Schritten 3 und 4 der einzige Konfigurationspfad.
211211
212Um Ihre Einrichtung zu überprüfen, führen Sie `/status` in Claude Code aus. Die API-Provider-Zeile zeigt `Microsoft Foundry` zusammen mit dem Ressourcennamen oder der Basis-URL, die Sie konfiguriert haben.
240* Konfigurieren Sie Entra ID in der Umgebung, oder legen Sie `ANTHROPIC_FOUNDRY_API_KEY` fest.242* Konfigurieren Sie Entra ID in der Umgebung, oder legen Sie `ANTHROPIC_FOUNDRY_API_KEY` fest.
241243
244Wenn Anfragen mit wiederholten Verbindungsfehlern bei der ersten Eingabeaufforderung fehlschlagen:
245
246* Überprüfen Sie, dass `ANTHROPIC_FOUNDRY_RESOURCE` auf Ihren tatsächlichen Ressourcennamen und nicht auf einen Platzhalter gesetzt ist. Claude Code erstellt die Endpunkt-URL aus diesem Wert, daher verweist ein falscher Name auf einen Host, der nicht vorhanden ist.