SpyBara
Go Premium

microsoft-foundry.md 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC

3 added, 3 removed.

2026
Thu 6 04:57 Wed 5 22:02 Tue 4 22:59 Mon 3 20:02 Sun 2 19:00

Claude Code auf Microsoft Foundry

Erfahren Sie, wie Sie Claude Code über Microsoft Foundry konfigurieren, einschließlich Setup, Konfiguration und Fehlerbehebung.

export const ContactSalesCard = ({surface}) => { const utm = content => utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}; 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"> ; const STYLES = .cc-cs { --cs-slate: #141413; --cs-clay: #d97757; --cs-clay-deep: #c6613f; --cs-gray-000: #ffffff; --cs-gray-700: #3d3d3a; --cs-border-default: rgba(31, 30, 29, 0.15); font-family: inherit; } .dark .cc-cs { --cs-slate: #f0eee6; --cs-gray-000: #262624; --cs-gray-700: #bfbdb4; --cs-border-default: rgba(240, 238, 230, 0.14); } .cc-cs-card { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 14px 16px; margin: 0; background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default); border-radius: 8px; flex-wrap: wrap; } .cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; } .cc-cs-text strong { font-weight: 550; color: var(--cs-slate); } .cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; } .cc-cs-btn-clay { display: inline-flex; align-items: center; gap: 8px; background: var(--cs-clay-deep); color: #fff; border: none; border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; transition: background-color 0.15s; white-space: nowrap; } .cc-cs-btn-clay:hover { background: var(--cs-clay); } .cc-cs-btn-ghost { display: inline-flex; align-items: center; gap: 8px; background: transparent; color: var(--cs-gray-700); border: 0.5px solid var(--cs-border-default); border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; } .cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); } .dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); } @media (max-width: 720px) { .cc-cs-actions { width: 100%; } }; return <div className="cc-cs not-prose"> <div className="cc-cs-card"> <div className="cc-cs-text"> Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.

<div className="cc-cs-actions"> <a href={https://claude.com/pricing?${utm('view_plans')}#plans-business} className="cc-cs-btn-ghost"> View plans <a href={https://claude.com/contact-sales?${utm('contact_sales')}} className="cc-cs-btn-clay"> Contact sales {iconArrowRight()}
; };

Voraussetzungen

Bevor Sie Claude Code mit Microsoft Foundry konfigurieren, stellen Sie sicher, dass Sie über Folgendes verfügen:

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

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

  1. Navigieren Sie zu Ihrer Ressource im Microsoft Foundry-Portal
  2. Gehen Sie zum 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:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

Option B: Microsoft Entra ID-Authentifizierung

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

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:

export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

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 aktivieren
export 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:

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'

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:

{
  "permissions": [
    {
      "dataActions": [
        "Microsoft.CognitiveServices/accounts/providers/*"
      ]
    }
  ]
}

Weitere Informationen finden Sie in der Microsoft Foundry RBAC-Dokumentation.

Fehlerbehebung

Wenn Sie einen Fehler erhalten „Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":

Wenn Anfragen mit wiederholten Verbindungsfehlern bei der ersten Eingabeaufforderung fehlschlagen:

Zusätzliche Ressourcen