Erstellen Sie eine neue Ressource und notieren Sie sich Ihren Ressourcennamen
Erstellen Sie Bereitstellungen für die Claude-Modelle:
Claude Opus
Claude Sonnet
Claude Haiku
2. Azure-Anmeldedaten konfigurieren
Claude Code unterstützt zwei 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
Wenn ANTHROPIC_FOUNDRY_API_KEY nicht 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
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 Foundry zu Opus 4.6 aufgelöst. Legen Sie ihn auf die Opus 4.7-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 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
Wenn die Umgebungsvariablen gesetzt sind, starten Sie Claude Code aus Ihrem Projektverzeichnis:
claude
Claude Code liest CLAUDE_CODE_USE_FOUNDRY und die anderen Foundry-Variablen aus der Umgebung und verbindet sich bei der ersten Eingabeaufforderung mit Ihrer Azure-Ressource. Im Gegensatz zu Bedrock und Vertex AI hat Foundry keinen interaktiven Setup-Assistenten, daher sind die Umgebungsvariablen in den Schritten 3 und 4 der einzige Konfigurationspfad.
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:
178Wenn die Umgebungsvariablen gesetzt sind, starten Sie Claude Code aus Ihrem Projektverzeichnis:
179
180```bash theme={null}
181claude
182```
183
184Claude Code liest `CLAUDE_CODE_USE_FOUNDRY` und die anderen Foundry-Variablen aus der Umgebung und verbindet sich bei der ersten Eingabeaufforderung mit Ihrer Azure-Ressource. Im Gegensatz zu Bedrock und Vertex AI hat Foundry keinen interaktiven Setup-Assistenten, daher sind die Umgebungsvariablen in den Schritten 3 und 4 der einzige Konfigurationspfad.
178Die Standardrollen `Azure AI User` und `Cognitive Services User` enthalten alle erforderlichen Berechtigungen zum Aufrufen von Claude-Modellen.188Die Standardrollen `Azure AI User` und `Cognitive Services User` enthalten alle erforderlichen Berechtigungen zum Aufrufen von Claude-Modellen.