Zum Hauptinhalt springen

Voraussetzungen

Bevor Sie Claude Code mit Microsoft Foundry konfigurieren, stellen Sie sicher, dass Sie über Folgendes verfügen:
  • Ein Azure-Abonnement mit Zugriff auf Microsoft Foundry
  • RBAC-Berechtigungen zum Erstellen von Microsoft Foundry-Ressourcen und Bereitstellungen
  • Azure CLI installiert und konfiguriert (optional - nur erforderlich, wenn Sie keinen anderen Mechanismus zum Abrufen von Anmeldedaten haben)
Wenn Sie Claude Code für mehrere Benutzer bereitstellen, fixieren Sie Ihre Modellversionen, bevor Sie die Bereitstellung durchführen.

Einrichtung

  1. Microsoft Foundry-Ressource bereitstellen

Erstellen Sie zunächst eine Claude-Ressource in Azure:
  1. Navigieren Sie zum Microsoft Foundry-Portal
  2. Erstellen Sie eine neue Ressource und notieren Sie sich Ihren Ressourcennamen
  3. 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
    Wenn Sie eine Bereitstellung konfigurieren, wählen Sie auch ihre Hosting-Option, die bestimmt, ob der Rückschluss auf Azure oder auf Anthropic-Infrastruktur ausgeführt wird.

  1. Azure-Anmeldedaten konfigurieren

Claude Code unterstützt drei Authentifizierungsmethoden für Microsoft Foundry. Wählen Sie die Methode, die Ihren Sicherheitsanforderungen am besten entspricht:
  • API-Schlüssel: Sie kopieren einen Schlüssel aus dem Microsoft Foundry-Portal und setzen ihn als ANTHROPIC_FOUNDRY_API_KEY
  • Microsoft Entra ID: Claude Code bezieht Token über die Standard-Anmeldekette des Azure SDK, zum Beispiel aus einer az login-Sitzung, sodass kein API-Schlüssel gespeichert werden muss
  • Bearer-Token: Ein anderer Prozess bezieht ein Microsoft Entra ID-Zugriffstoken, und Sie übergeben es in ANTHROPIC_FOUNDRY_AUTH_TOKEN
Bei Verwendung von Microsoft Foundry ist der /logout-Befehl nicht verfügbar, da die Authentifizierung über Azure-Anmeldedaten erfolgt.

API-Schlüssel verwenden

Kopieren Sie einen Schlüssel aus dem Microsoft Foundry-Portal und setzen Sie ihn dann als Umgebungsvariable:
  1. Navigieren Sie zu Ihrer Ressource im Microsoft Foundry-Portal
  2. Öffnen Sie den Abschnitt Endpunkte und Schlüssel
  3. Kopieren Sie API-Schlüssel
  4. Legen Sie die Umgebungsvariable fest und ersetzen Sie your-azure-api-key durch den Schlüssel, den Sie kopiert haben:

Microsoft Entra ID verwenden

Lassen Sie ANTHROPIC_FOUNDRY_API_KEY und ANTHROPIC_FOUNDRY_AUTH_TOKEN ungesetzt. Claude Code verwendet dann die Azure SDK Standard-Anmeldekette. Dies unterstützt eine Vielzahl von Methoden zur Authentifizierung lokaler und Remote-Workloads. Melden Sie sich auf einem lokalen Rechner mit der Azure CLI an:
Die Rollen, die Ihre Identität benötigt, finden Sie unter Azure RBAC-Konfiguration.

Bearer-Token verwenden

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

  1. Claude Code konfigurieren

Legen Sie die folgenden Umgebungsvariablen fest, um Microsoft Foundry zu aktivieren:
Setzen Sie ANTHROPIC_FOUNDRY_RESOURCE ausschließlich auf den Ressourcennamen, z. B. my-resource. Claude Code lehnt eine URL oder einen Hostnamen ab, wenn Sie eine Nachricht senden.

  1. Modellversionen fixieren

Fixieren Sie spezifische Modellversionen für jede Bereitstellung. Ohne Fixierung werden Modellaliase wie sonnet und opus zu Claude Codes integriertem Standard für Microsoft Foundry aufgelöst, der hinter der neuesten Version zurückbleiben kann und möglicherweise noch nicht in Ihrem Konto verfügbar ist. Microsoft Foundry hat keine Startup-Modellprüfung, daher schlagen Anfragen fehl, wenn der Standard nicht verfügbar ist. Wenn Sie Azure-Bereitstellungen erstellen, wählen Sie eine spezifische Modellversion anstelle von „automatisch auf die neueste Version aktualisieren“.
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 ID eines neueren Opus-Modells fest, z. B. Opus 4.8:
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:
Um unterschiedliche TTLs für Ihre Hauptkonversation und für die Anfragen festzulegen, die Claude Code außerhalb davon stellt, wählen Sie die TTL selbst.

  1. Claude Code ausführen

Mit den gesetzten Umgebungsvariablen starten Sie Claude Code aus Ihrem Projektverzeichnis:
Claude Code liest CLAUDE_CODE_USE_FOUNDRY und die anderen Microsoft Foundry-Variablen aus der Umgebung und verbindet sich beim ersten Prompt 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

Wenn Sie sich mit Microsoft Entra ID oder einem von Microsoft Entra ID ausgestellten Bearer-Token authentifizieren, weisen Sie Ihrer Identität die Rolle Foundry User oder Cognitive Services User für Ihre Foundry-Ressource zu. Möglicherweise sehen Sie Foundry User noch unter seinem früheren Namen Azure AI User. Wenn diese Rollen Ihre Anforderungen nicht erfüllen, finden Sie Informationen zu benutzerdefinierten Rollen in der Microsoft Foundry RBAC-Dokumentation.

1M-Token-Kontextfenster

Wenn Claude Code auf Microsoft Foundry erkennen kann, welches Modell Ihre Bereitstellung bereitstellt, laufen Fable-Modelle, Sonnet 5 und neuer sowie Opus 4.7 und neuer standardmäßig mit dem 1M-Token-Kontextfenster, ohne dass ein [1m]-Suffix erforderlich ist. Claude Code liest das Modell aus dem Bereitstellungsnamen in Ihren Modellvariablen. Benennen Sie jede Bereitstellung mit ihrer Modell-ID, z. B. claude-opus-4-8, oder ordnen Sie das Modell mit modelOverrides Ihrem Bereitstellungsnamen zu. Bei einem Bereitstellungsnamen, den Claude Code keinem Modell zuordnen kann, nimmt es ein 200K-Fenster an, sofern Sie nicht ein anderes angeben. Dieser Eintrag in settings.json teilt Claude Code mit, dass eine Bereitstellung namens team-opus-prod Opus 4.8 bereitstellt:
Um stattdessen ein 200K-Fenster beizubehalten, setzen Sie CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Opus 4.6 und Sonnet 4.6 erreichen das 1M-Fenster, wenn Sie [1m] an den Bereitstellungsnamen in ANTHROPIC_DEFAULT_OPUS_MODEL oder ANTHROPIC_DEFAULT_SONNET_MODEL anhängen, wie unter Modelle für Drittanbieter-Bereitstellungen festlegen beschrieben. Vor v2.1.287 benötigten auch die Fable-Modelle sowie Opus 4.7 und neuer dieses Suffix auf Microsoft Foundry und liefen ohne es standardmäßig mit einem 200K-Fenster.

Fehlerbehebung

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.

Zusätzliche Ressourcen