Claude in Microsoft Foundry
Greife über Microsoft Foundry mit Azure-nativen Endpunkten und Authentifizierung auf Claude-Modelle zu.
Diese Anleitung zeigt dir, wie du Claude in Microsoft Foundry einrichtest und API-Aufrufe an Claude sendest. Du kannst eines der Client-SDKs von Anthropic oder direkte HTTP-Anfragen verwenden. Wenn du Claude in Microsoft Foundry nutzt, bezahlst du die Claude-Nutzung über den Azure Marketplace. Die verfügbaren Modelle findest du unter API-Modell-IDs und Deployments. Funktionen wie das „context window“ (Kontextfenster) mit 1M Token sind ebenfalls verfügbar. Die Kosten verwaltest du über dein Azure-Abonnement.
Claude ist in Foundry-Ressourcen in den Bereitstellungstypen Global Standard und US Data Zone Standard verfügbar und wird in Claude Consumption Units über den Azure Marketplace abgerechnet. Details findest du unter Preise für Claude in Microsoft Foundry.
Hosting-Optionen
Claude-Modelle in Microsoft Foundry sind in zwei Hosting-Optionen verfügbar. Du wählst die Hosting-Option, wenn du das Deployment konfigurierst.
| Hosted on Azure | Hosted on Anthropic | |
|---|---|---|
| Wo die Inferenz läuft | Von Anthropic betriebener Dienst auf Azure-Infrastruktur | Von Anthropic betriebener Dienst auf Anthropic-Infrastruktur |
| Modellverfügbarkeit | Einige Opus-, Sonnet- und Haiku-Modelle | Alle auf Microsoft Foundry verfügbaren Claude-Modelle |
| Bereitstellungstypen | Global Standard, US Data Zone Standard | Global Standard |
| Empfohlen für | Die meisten Workloads | Workloads, die nur auf Anthropic gehostete Modelle oder nur beim Hosting auf Anthropic verfügbare Funktionen benötigen |
Bei auf Azure gehosteten Deployments verarbeitet Anthropic Prompts und Completions auf Azure-Infrastruktur und speichert aufbewahrte Inhalte dort. Zu den aufbewahrten Inhalten gehören Inhalte, die von den Sicherheitssystemen von Anthropic zur Überprüfung durch Anthropic markiert wurden. Betriebsdaten, die keine Prompts oder Completions enthalten, werden in den Systemen von Anthropic außerhalb von Azure gespeichert. Beispiele sind von Sicherheitsklassifikatoren ausgegebene Scores, Kennungen sowie Nutzungs- und Abrechnungsdaten.
Voraussetzungen
Bevor du beginnst, stelle sicher, dass du Folgendes hast:
- Ein aktives Azure-Abonnement
- Zugriff auf das Foundry-Portal
- Eine Rolle der rollenbasierten Zugriffssteuerung von Azure (Azure RBAC), etwa Foundry User oder Cognitive Services User, für die Foundry-Ressource, die du unter Bereitstellung erstellst
- Optional: die Azure CLI, um Microsoft-Entra-ID-Tokens mit
az account get-access-tokenabzurufen
Ein SDK installieren
Die Client-SDKs von Anthropic unterstützen Foundry über ein plattformspezifisches Paket oder eine Client-Klasse. Die Beispiele auf dieser Seite zeigen außerdem Anfragen mit cURL und der ant-CLI. Informationen zur Einrichtung der CLI findest du im CLI-Schnellstart.
pip install -U "anthropic"
# Für die Entra ID-Authentifizierung installiere zusätzlich die Azure Identity-Bibliothek
pip install azure-identityBereitstellung
Foundry verwendet eine zweistufige Hierarchie: Ressourcen enthalten deine Sicherheits- und Abrechnungskonfiguration, während Bereitstellungen (Deployments) die Modellinstanzen sind, die du über die API aufrufst. Du erstellst zuerst eine Foundry-Ressource und dann eine oder mehrere Claude-Bereitstellungen darin.
Foundry-Ressourcen bereitstellen
So stellst du deine Ressource bereit:
- Navigiere zum Foundry-Portal.
- Erstelle oder wähle eine Foundry-Ressource in einer Azure-Region, in der dein Modell verfügbar ist. Du kannst den Anweisungen von Microsoft zum Erstellen einer Foundry-Ressource folgen oder ein Foundry-Projekt erstellen, wodurch eine Ressource für dich erstellt wird.
- Notiere dir deinen Ressourcennamen, der in API-Endpunkten wie
https://{resource}.services.ai.azure.com/anthropic/v1/*dem Wert{resource}entspricht.
Um den Netzwerkzugriff einzuschränken, kannst du deine Ressource zu einem privaten Netzwerk (Azure Virtual Network) hinzufügen.
Foundry-Deployments erstellen
Nachdem du deine Ressource erstellt hast, stelle ein Claude-Modell bereit, um es für API-Aufrufe verfügbar zu machen. Diese Schritte beschreiben das neue Foundry-Portal (der Schalter New Foundry ist aktiviert):
- Melde dich beim Foundry-Portal an. Wähle auf der Startseite des Portals Discover in der Navigation oben rechts und dann Models im linken Bereich, um den Modellkatalog zu öffnen.
- Suche nach einem Claude-Modell und wähle es aus (zum Beispiel
claude-opus-5-5). Jedes Modell erscheint nur einmal im Katalog, unabhängig davon, wie viele Hosting-Optionen es unterstützt. - Wähle auf der Modellkarte Deploy und dann Custom settings, um den Bereich mit den Bereitstellungseinstellungen zu öffnen. Wenn du stattdessen Default settings wählst, wird die Bereitstellung bei Modellen, die in beiden Hosting-Optionen verfügbar sind, automatisch als auf Azure gehostet konfiguriert.
- Prüfe bei deinem ersten Claude-Deployment die Bedingungen des Azure Marketplace, wähle eine Branche aus und wähle Agree and Proceed, um die Bedingungen zu akzeptieren und das Azure-Marketplace-Angebot zu abonnieren.
- Konfiguriere das Deployment:
- Deployment name: Standardmäßig die Modell-ID, du kannst ihn aber anpassen (zum Beispiel
my-claude-deployment). Der Deployment-Name kann nach der Erstellung nicht mehr geändert werden. - Model version: Diese Einstellung bestimmt die Hosting-Option. Erweitere Model version settings, öffne das Dropdown-Menü Model version und wähle die Version aus, die mit der gewünschten Hosting-Option gekennzeichnet ist.
- Region scope: Wähle Global oder, wenn das Deployment auf Azure gehostet wird, Data Zone. Data Zone erstellt ein US-Data-Zone-Standard-Deployment, das die Inferenz innerhalb der Vereinigten Staaten hält. Informationen zu den Preisen findest du unter Inferenz-Geografie.
- Deployment name: Standardmäßig die Modell-ID, du kannst ihn aber anpassen (zum Beispiel
- Wähle Deploy und warte, bis die Bereitstellung abgeschlossen ist.
- Wähle nach der Bereitstellung Build in der Navigation oben rechts, dann Models im linken Bereich und öffne dein Deployment. Der Tab Details zeigt die Target URI (deine Endpunkt-URL) und den Key (deinen API-Key).
Wenn der Schalter New Foundry deaktiviert ist, befindest du dich im klassischen Portal-Layout. Öffne dort Model catalog im linken Bereich, um ein Modell zu finden und bereitzustellen, und öffne Models + endpoints (unter My assets), um deine Deployments und deren Endpunktdetails anzuzeigen.
Authentifizierung
Claude in Microsoft Foundry unterstützt zwei Authentifizierungsmethoden: API-Keys und Entra-ID-Tokens. Beide Methoden verwenden Endpunkte im Format https://{resource}.services.ai.azure.com/anthropic/v1/*. Verwende für Claude-Mythos-Modelle Entra-ID-Tokens.
Authentifizierung mit API-Key
Nachdem du deine Foundry-Claude-Ressource bereitgestellt hast, kannst du einen API-Key aus dem Foundry-Portal abrufen:
- Wähle im Foundry-Portal Build in der Navigation oben rechts und dann Models im linken Bereich.
- Öffne dein Claude-Deployment und wähle den Tab Details.
- Kopiere den Wert Key (und notiere dir die Target URI für deinen Endpunkt).
- Verwende in deinen Anfragen entweder den Header
api-keyoderx-api-key, oder übergib ihn an das SDK.
Der Foundry-Client des SDK benötigt einen API-Key sowie entweder einen Ressourcennamen oder eine Basis-URL und liest diese automatisch aus den folgenden Umgebungsvariablen, sofern sie definiert sind:
ANTHROPIC_FOUNDRY_API_KEY- Dein API-KeyANTHROPIC_FOUNDRY_RESOURCE- Dein Ressourcenname (zum Beispielexample-resource)ANTHROPIC_FOUNDRY_BASE_URL- Alternative zum Ressourcennamen in jedem SDK außer C#: die vollständige Basis-URL (zum Beispielhttps://example-resource.services.ai.azure.com/anthropic/)
Beispiel mit API-Key:
import os
from anthropic import AnthropicFoundry
client = AnthropicFoundry(
api_key=os.environ.get("ANTHROPIC_FOUNDRY_API_KEY"),
resource="example-resource", # your resource name
)
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)Microsoft-Entra-Authentifizierung
Mit der Entra-ID-Authentifizierung kannst du den Zugriff mit Azure RBAC verwalten, die Identitätsverwaltung deiner Organisation einbinden und die manuelle Handhabung von API-Keys vermeiden. So verwendest du Entra-ID-Tokens:
- Aktiviere die Microsoft-Entra-ID-Authentifizierung für deine Foundry-Ressource.
- Rufe ein Zugriffstoken von Entra ID ab.
- Verwende das Token im Header
Authorization: Bearer {TOKEN}.
Beispiel mit Entra ID:
from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
# Rufe das Microsoft Entra ID-Token über das Token-Provider-Muster ab
token_provider = get_bearer_token_provider(
DefaultAzureCredential(), "https://ai.azure.com/.default"
)
# Erstelle den Client mit Entra ID-Authentifizierung
client = AnthropicFoundry(
resource="example-resource", # your resource name
azure_ad_token_provider=token_provider, # Use token provider for Entra ID auth
)
# Sende die Anfrage
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)Korrelations-Request-IDs
Foundry fügt zur Fehlersuche und Nachverfolgung Request-Kennungen in die HTTP-Antwort-Header ein. Wenn du den Support kontaktierst, gib sowohl den Wert request-id als auch apim-request-id (Azure API Management) an, damit die Teams deine Anfrage in den Systemen von Anthropic und Azure schnell finden und untersuchen können.
Funktionsunterstützung
Claude in Microsoft Foundry unterstützt die meisten Claude-Funktionen. Die Funktionsübersicht listet die Funktionen von Claude auf, und der Abschnitt Verfügbarkeit auf der Seite einer Funktion zeigt, ob Foundry sie unterstützt und mit welcher Hosting-Option.
Kontextfenster
Alle verfügbaren Modelle haben auf Microsoft Foundry ein Kontextfenster mit 1M Token, mit Ausnahme von Claude Opus 4.5, Claude Sonnet 4.5 (abgekündigt) und Claude Haiku 4.5. Diese drei Modelle haben ein Kontextfenster mit 200k Token.
Claude-Funktionen, die für Claude in Microsoft Foundry nicht unterstützt werden
- Admin API
- Advisor-Tool
- Claude Managed Agents
- Compliance API
- Models API
- Message Batches API
- Serverseitiges Fallback (der
fallbacks-Parameter; verwende stattdessen das clientseitige Fallback-Muster) - Endpunkte für Benutzerprofile (
/v1/user_profiles; erstelle Profile stattdessen in der Claude API)
Zusätzliche Funktionen, die beim Hosting auf Azure nicht unterstützt werden
Die folgenden Funktionen sind für auf Anthropic gehostete Deployments verfügbar, werden aber für auf Azure gehostete Deployments nicht unterstützt:
- Code-Ausführung
- Versionen der Tools Websuche und Web Fetch, die neuer sind als
web_search_20250305undweb_fetch_20250910. Auf Azure gehostete Deployments unterstützen nur diese Basisversionen, sodass dynamisches Filtern, Response-Einbindung und Cache-Umgehung nicht verfügbar sind. - Agent Skills
- Programmatisches Tool-Calling
- Files API
Anfragen, die diese Funktionen gegen ein auf Azure gehostetes Deployment verwenden, geben absichtlich einen Fehler 400 Bad Request zurück. Claude Code erkennt auf Azure gehostete Deployments und passt seinen Funktionsumfang automatisch an.
API-Antworten
API-Antworten von Claude in Microsoft Foundry folgen dem standardmäßigen Antwortformat der Claude APIVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren., einschließlich des usage-Objekts.
Details zu Foundry-spezifischen Antwort-Headern findest du unter Korrelations-Request-IDs.
API-Modell-IDs und Deployments
Die Lebenszyklusbegriffe („Deprecated“ (abgekündigt), „Retired“ (eingestellt)) sind unter Modell-Abkündigungen definiert. Microsoft Foundry folgt dem Lebenszyklus-Zeitplan der Claude API.
Die folgenden Claude-Modelle sind über Foundry verfügbar:
| Modell | Standard-Bereitstellungsname | Auf Azure gehostet | Gehostet bei Anthropic |
|---|---|---|---|
| Claude Fable 5.2 | claude-fable-5-2 | ✓ | |
| Claude Mythos 5.2 (eingeschränkt verfügbar(wird in neuem Tab geöffnet)) | claude-mythos-5-2 | ✓ | |
| Claude Fable 5.1 | claude-fable-5-1 | ✓ | |
| Claude Mythos 5.1 (eingeschränkt verfügbar(wird in neuem Tab geöffnet)) | claude-mythos-5-1 | ✓ | |
| Claude Fable 5 | claude-fable-5 | ✓ | |
| Claude Mythos 5 (eingeschränkt verfügbar(wird in neuem Tab geöffnet)) | claude-mythos-5 | ✓ | |
| Claude Opus 5.5 | claude-opus-5-5 | ✓ | ✓ |
| Claude Opus 5 | claude-opus-5 | ✓ | ✓ |
| Claude Opus 4.8 | claude-opus-4-8 | ✓ | ✓ |
| Claude Opus 4.7 | claude-opus-4-7 | ✓ | |
| Claude Opus 4.6 | claude-opus-4-6 | ✓ | |
| Claude Opus 4.5 | claude-opus-4-5 | ✓ | |
| Claude Sonnet 5.5 | claude-sonnet-5-5 | ✓ | ✓ |
| Claude Sonnet 5 | claude-sonnet-5 | ✓ | ✓ |
| Claude Sonnet 4.6 | claude-sonnet-4-6 | ✓ | |
| Claude Sonnet 4.5 (abgekündigt) | claude-sonnet-4-5 | ✓ | |
| Claude Haiku 5.5 | claude-haiku-5-5 | ✓ | ✓ |
| Claude Haiku 4.5 | claude-haiku-4-5 | ✓ | ✓ |
Standardmäßig entsprechen die Deployment-Namen den in der obigen Tabelle gezeigten Modell-IDs. Du kannst jedoch im Foundry-Portal benutzerdefinierte Deployments mit anderen Namen erstellen, um unterschiedliche Konfigurationen, Versionen oder Ratenlimits zu verwalten. Verwende in deinen API-Anfragen den Deployment-Namen (nicht unbedingt die Modell-ID).
Claude Code
Lass Claude Code deinen Code auf ein neueres Modell migrieren
/claude-api migrate dieses Projekt auf das neueste Claude Opus-ModellAbrechnung
Claude in Microsoft Foundry wird über den Azure Marketplace abgerechnet. Die Nutzung wird in Claude Consumption Units (CCUs) angegeben, stündlich gemessen und monatlich nachträglich auf deiner Azure-Rechnung ausgewiesen. CCUs sind keine vorausbezahlten Guthaben. Es gibt kein CCU-Guthaben und keine CCU-Verpflichtung.
Den CCU-Preis, die Umrechnungsmechanik und die Token-Raten pro Modell findest du unter Preise für Claude in Microsoft Foundry.
Zwischen Hosting-Optionen migrieren
So verschiebst du ein bestehendes Deployment von einer Hosting-Option zur anderen:
- Erstelle ein neues Deployment der anderen Hosting-Version des Modells (auf Azure gehostet oder auf Anthropic gehostet). Dies kann in derselben Foundry-Ressource oder in einer neuen erfolgen.
- Aktualisiere deine Anwendung, sodass sie den neuen Deployment-Namen im Parameter
modelübergibt. - Lösche das alte Deployment, sobald der Traffic umgezogen ist.
Wenn sich das neue Deployment in derselben Foundry-Ressource befindet, bleiben deine Endpunkt-URL und Authentifizierung unverändert. Wenn du eine neue Ressource erstellt hast, aktualisiere den Endpunkt und die Anmeldedaten deiner Anwendung, sodass sie darauf verweisen.
Monitoring und Logging
Azure bietet Monitoring und Logging für deine Claude-Nutzung über standardmäßige Azure-Muster:
- Azure Monitor: Verfolge API-Nutzung, Latenz und Fehlerraten
- Azure Log Analytics: Frage Anfrage-/Antwort-Logs ab und analysiere sie
- Cost Management: Überwache und prognostiziere die mit der Claude-Nutzung verbundenen Kosten
Anthropic empfiehlt, deine Aktivität mindestens auf rollierender 30-Tage-Basis zu protokollieren, um Nutzungsmuster zu verstehen und mögliche Probleme zu untersuchen.
Fehlerbehebung
Authentifizierungsfehler
Fehler: 401 Unauthorized oder Invalid API key
- Lösung: Überprüfe, ob dein API-Key korrekt ist. Du findest ihn im Foundry-Portal auf dem Tab Details deines Deployments (unter Build > Models).
- Lösung: Wenn du Microsoft Entra ID verwendest, stelle sicher, dass dein Zugriffstoken gültig und nicht abgelaufen ist. Token laufen in der Regel nach 1 Stunde ab.
Fehler: 403 Forbidden
Ursache: Deinem Azure-Konto fehlen möglicherweise die erforderlichen Berechtigungen.
- Lösung: Stelle sicher, dass dir die passende Azure-RBAC-Rolle zugewiesen ist (zum Beispiel Foundry User oder Cognitive Services User).
Ratenlimitierung
Fehler: 429 Too Many Requests
- Lösung: Du hast dein „rate limit“ (Ratenlimit) überschritten. Implementiere exponentielles Backoff und Retry-Logik in deiner Anwendung.
- Lösung: Erwäge, über das Azure-Portal oder den Azure-Support eine Erhöhung des Ratenlimits zu beantragen.
Ratenlimit-Header
Foundry fügt die standardmäßigen Ratenlimit-Header von Anthropic (anthropic-ratelimit-tokens-limit, anthropic-ratelimit-tokens-remaining, anthropic-ratelimit-tokens-reset, anthropic-ratelimit-input-tokens-limit, anthropic-ratelimit-input-tokens-remaining, anthropic-ratelimit-input-tokens-reset, anthropic-ratelimit-output-tokens-limit, anthropic-ratelimit-output-tokens-remaining und anthropic-ratelimit-output-tokens-reset) nicht in Antworten ein. Verwalte die Ratenlimitierung stattdessen über die Monitoring-Tools von Azure.
Modell- und Deployment-Fehler
Fehler: Model not found oder Deployment not found
- Lösung: Überprüfe, ob du den richtigen Deployment-Namen verwendest. Wenn du kein benutzerdefiniertes Deployment erstellt hast, verwende die Standard-Modell-ID (zum Beispiel
claude-opus-5-5). - Lösung: Stelle sicher, dass das Modell/Deployment in deiner Azure-Region verfügbar ist.
Fehler: Invalid model parameter
- Lösung: Der Parameter
modelsollte deinen Bereitstellungsnamen enthalten, der im Foundry-Portal angepasst werden kann. Überprüfe, ob die Bereitstellung existiert und korrekt konfiguriert ist.
Nächste Schritte
Entdecke die erweiterten Funktionen und Fähigkeiten von Claude.
Erfahre mehr über die Preisstruktur von Anthropic für Modelle und Funktionen.
Wenn sicherere und leistungsfähigere Modelle erscheinen, stellt Anthropic ältere regelmäßig ein. Sieh dir alle API-Abkündigungen zusammen mit empfohlenen Nachfolgern an.
Zusätzliche Ressourcen
Durchsuche Anthropic-Modelle im Foundry-Katalog.
Sieh dir die Preisdetails von Microsoft für Microsoft Foundry an.
Sieh dir die Preisdetails von Anthropic pro Modell an.
Verwalte deine Azure-Ressourcen.
War diese Seite hilfreich?