Claude in Microsoft Foundry

Dieser Leitfaden führt dich durch den Prozess der Einrichtung und des Ausführens von API-Aufrufen an Claude in Microsoft Foundry mit einem der Client-SDKs von Anthropic oder direkten HTTP-Anfragen. Wenn du auf Claude in Microsoft Foundry zugreifst, wird dir die Claude-Nutzung über den Azure Marketplace in Rechnung gestellt, sodass du auf die neuesten Funktionen von Claude zugreifen und gleichzeitig die Kosten über dein Azure-Abonnement verwalten kannst.

Claude ist in den Bereitstellungstypen Global Standard und US Data Zone Standard in Foundry-Ressourcen verfügbar und wird in Claude Consumption Units über den Azure Marketplace abgerechnet. Besuche Pricing für Details.



Hosting-Optionen

Claude-Modelle in Microsoft Foundry sind in zwei Hosting-Optionen verfügbar. Du wählst die Hosting-Option aus, wenn du die Bereitstellung konfigurierst.



Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

• Ein aktives Azure-Abonnement
• Zugriff auf Foundry
• Die Azure CLI installiert (optional, für die Ressourcenverwaltung)



Ein SDK installieren

Die Client-SDKs von Anthropic unterstützen Foundry über ein plattformspezifisches Paket oder eine Client-Klasse.



Bereitstellung

Foundry verwendet eine zweistufige Hierarchie: Ressourcen enthalten deine Sicherheits- und Abrechnungskonfiguration, während Deployments (Bereitstellungen) die Modellinstanzen sind, die du über die API aufrufst. Du erstellst zunächst eine Foundry-Ressource und dann eine oder mehrere Claude-Bereitstellungen darin.



Foundry-Ressourcen bereitstellen

Erstelle eine Foundry-Ressource, die erforderlich ist, um Dienste in Azure zu nutzen und zu verwalten. Du kannst diesen Anweisungen folgen, um eine Foundry-Ressource zu erstellen. Alternativ kannst du mit dem Erstellen eines Foundry-Projekts beginnen, was das Erstellen einer Foundry-Ressource beinhaltet.

So stellst du deine Ressource bereit:

1. Navigiere zum Foundry-Portal
2. Erstelle eine neue Foundry-Ressource oder wähle eine vorhandene aus
3. Konfiguriere die Zugriffsverwaltung mit von Azure ausgestellten API-Keys oder Entra ID (ehemals Azure Active Directory) für rollenbasierte Zugriffskontrolle
4. Konfiguriere optional die Ressource als Teil eines privaten Netzwerks (Azure Virtual Network) für erhöhte Sicherheit
5. Notiere dir deinen Ressourcennamen. Du verwendest diesen als {resource} in API-Endpunkten (zum Beispiel https://{resource}.services.ai.azure.com/anthropic/v1/*)



Foundry-Bereitstellungen 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):

1. Melde dich beim Foundry-Portal an. Wähle auf der Portal-Startseite Discover in der Navigation oben rechts und dann Models im linken Bereich, um den Modellkatalog zu öffnen.
2. Suche nach einem Claude-Modell und wähle es aus (zum Beispiel claude-opus-4-8). Jedes Modell erscheint einmal im Katalog, unabhängig davon, wie viele Hosting-Optionen es unterstützt.
3. 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 für Modelle, die in beiden Hosting-Optionen verfügbar sind, automatisch als Hosted on Azure konfiguriert.
4. Überprüfe bei deiner ersten Claude-Bereitstellung die Azure Marketplace-Bedingungen, wähle eine Branche aus und wähle Agree and Proceed, um die Bedingungen zu akzeptieren und das Azure Marketplace-Angebot zu abonnieren.
5. Konfiguriere die Bereitstellung:
   • Deployment name: Standardmäßig die Modell-ID, aber du kannst sie anpassen (zum Beispiel my-claude-deployment). Der Bereitstellungsname kann nach der Erstellung nicht mehr geändert werden.
   • Region scope: Wähle Global oder, für auf Azure gehostete Modelle, Data Zone. Die Auswahl von Data Zone erstellt eine US Data Zone Standard-Bereitstellung, die die Inferenz innerhalb der Vereinigten Staaten hält und dem Setzen von inference_geo: "us" in der Claude API entspricht.
   • Model version: Erweitere Model version settings und wähle eine Version aus dem Dropdown-Menü Model version aus. Jede Hosting-Option wird als separate Modellversion aufgeführt und mit ihrer Hosting-Option gekennzeichnet (zum Beispiel Version 1 für Hosted on Anthropic, Version 2 für Hosted on Azure).
6. Wähle Deploy und warte, bis die Bereitstellung abgeschlossen ist.
7. Wähle nach der Bereitstellung Build in der Navigation oben rechts, dann Models im linken Bereich und öffne deine Bereitstellung. Die Registerkarte Details zeigt die Target URI (deine Endpunkt-URL) und den Key (deinen API-Key).



Authentifizierung

Claude in Microsoft Foundry unterstützt zwei Authentifizierungsmethoden: API-Keys und Entra ID-Token. Beide Methoden verwenden von Azure gehostete Endpunkte im Format https://{resource}.services.ai.azure.com/anthropic/v1/*.



API-Key-Authentifizierung

Nach der Bereitstellung deiner Foundry-Claude-Ressource kannst du einen API-Key aus dem Foundry-Portal abrufen:

1. Wähle im Foundry-Portal Build in der Navigation oben rechts und dann Models im linken Bereich.
2. Öffne deine Claude-Bereitstellung und wähle die Registerkarte Details.
3. Kopiere den Key-Wert (und notiere dir die Target URI für deinen Endpunkt).
4. Verwende entweder den api-key- oder x-api-key-Header in deinen Anfragen oder übergib ihn an das SDK.

Die Foundry-SDKs benötigen einen API-Key und entweder einen Ressourcennamen oder eine Basis-URL. Die C#-, Java-, PHP-, Python- und TypeScript-SDKs lesen diese automatisch aus den folgenden Umgebungsvariablen, wenn sie definiert sind:

• ANTHROPIC_FOUNDRY_API_KEY – Dein API-Key
• ANTHROPIC_FOUNDRY_RESOURCE – Dein Ressourcenname (zum Beispiel example-resource)
• ANTHROPIC_FOUNDRY_BASE_URL – Alternative zum Ressourcennamen; die vollständige Basis-URL (zum Beispiel https://example-resource.services.ai.azure.com/anthropic/)

Beispiel mit API-Key:



Microsoft Entra-Authentifizierung

Für erhöhte Sicherheit und zentralisierte Zugriffsverwaltung kannst du Entra ID-Token verwenden:

1. Aktiviere die Entra-Authentifizierung für deine Foundry-Ressource
2. Rufe ein Zugriffstoken von Entra ID ab
3. Verwende das Token im Authorization: Bearer {TOKEN}-Header

Beispiel mit Entra ID:



Korrelations-Request-IDs

Foundry fügt Request-Identifier in HTTP-Antwort-Headern für Debugging und Tracing hinzu. Wenn du den Support kontaktierst, gib sowohl den request-id- als auch den apim-request-id-Wert an, damit die Teams deine Anfrage schnell in den Anthropic- und Azure-Systemen lokalisieren und untersuchen können.



Funktionsunterstützung

Claude in Microsoft Foundry unterstützt die meisten leistungsstarken Funktionen von Claude. Du findest alle derzeit unterstützten Funktionen in der Funktionsübersicht.



Kontextfenster

Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 und Claude Sonnet 4.6 haben ein 1M-Token-Kontextfenster auf Microsoft Foundry. Andere Claude-Modelle, einschließlich Claude Sonnet 4.5, haben ein 200k-Token-Kontextfenster.



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
• Serverseitiger Fallback (der fallbacks-Parameter; verwende stattdessen das clientseitige Fallback-Muster)



Zusätzliche Funktionen, die bei Hosting auf Azure nicht unterstützt werden

Die folgenden Funktionen sind für Bereitstellungen verfügbar, die auf Anthropic gehostet werden, werden aber für Bereitstellungen, die auf Azure gehostet werden, nicht unterstützt:

• Strukturierte Ausgaben
• Serverseitige Tools (Websuche, Web-Fetch, Code-Ausführung und Tool-Suche)
• MCP-Connector
• Agent Skills
• Programmatisches Tool-Calling
• Files API

Anfragen, die diese Funktionen gegen eine auf Azure gehostete Bereitstellung verwenden, geben absichtlich einen 400 Bad Request-Fehler zurück. Claude Code erkennt auf Azure gehostete Bereitstellungen und passt seinen Funktionsumfang automatisch an.



API-Antworten

API-Antworten von Claude in Microsoft Foundry folgen dem standardmäßigen Claude API-Antwortformat. Dies umfasst das usage-Objekt in den Antwort-Bodies, das detaillierte Informationen zum Token-Verbrauch für deine Anfragen liefert. Das usage-Objekt ist über alle Plattformen hinweg konsistent (Claude API, Foundry, Claude Platform auf AWS, Amazon Bedrock und Google Cloud).

Details zu Antwort-Headern, die spezifisch für Foundry sind, findest du unter Korrelations-Request-IDs.



API-Modell-IDs und Bereitstellungen

Lebenszyklusbegriffe (Deprecated, Retired) sind in Modell-Deprecations definiert. Microsoft Foundry folgt dem Lebenszyklusplan der Claude API.

Die folgenden Claude-Modelle sind über Foundry verfügbar:

Standardmäßig entsprechen die Bereitstellungsnamen den in der vorstehenden Tabelle gezeigten Modell-IDs. Du kannst jedoch benutzerdefinierte Bereitstellungen mit anderen Namen im Foundry-Portal erstellen, um verschiedene Konfigurationen, Versionen oder Ratenlimits zu verwalten. Verwende den Bereitstellungsnamen (nicht unbedingt die Modell-ID) in deinen API-Anfragen.



Abrechnung

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 in Rechnung gestellt. CCUs sind keine vorausbezahlten Credits; es gibt kein CCU-Guthaben und keine Verpflichtung.

Für den CCU-Preis, die Umrechnungsmechanik und die Token-Raten pro Modell siehe Claude in Microsoft Foundry – Preise.



Migration zwischen Hosting-Optionen

So verschiebst du eine bestehende Bereitstellung von einer Hosting-Option zur anderen:

1. Erstelle eine neue Bereitstellung der anderen Hosting-Version des Modells (Hosted on Azure oder Hosted on Anthropic). Dies kann in derselben Foundry-Ressource oder in einer neuen erfolgen.
2. Aktualisiere deine Anwendung, um den neuen Bereitstellungsnamen im model-Parameter zu übergeben.
3. Lösche die alte Bereitstellung, sobald der Traffic verschoben wurde.

Wenn sich die neue Bereitstellung 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, damit sie darauf verweisen.



Monitoring und Logging

Azure bietet umfassende Monitoring- und Logging-Funktionen für deine Claude-Nutzung über standardmäßige Azure-Muster:

• Azure Monitor: Verfolge API-Nutzung, Latenz und Fehlerraten
• Azure Log Analytics: Frage Request-/Response-Logs ab und analysiere sie
• Cost Management: Überwache und prognostiziere Kosten im Zusammenhang mit der Claude-Nutzung

Anthropic empfiehlt, deine Aktivitäten mindestens auf rollierender 30-Tage-Basis zu protokollieren, um Nutzungsmuster zu verstehen und potenzielle 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 der Registerkarte Details deiner Bereitstellung (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

• Lösung: Deinem Azure-Konto fehlen möglicherweise die erforderlichen Berechtigungen. Stelle sicher, dass dir die entsprechende Azure RBAC-Rolle zugewiesen ist (zum Beispiel Foundry User (ehemals Azure AI User) oder Cognitive Services User).



Ratenlimitierung

Fehler: 429 Too Many Requests

• Lösung: Du hast dein Ratenlimit überschritten. Implementiere exponentielles Backoff und Wiederholungslogik in deiner Anwendung.
• Lösung: Erwäge, Erhöhungen des Ratenlimits über das Azure-Portal oder den Azure-Support anzufordern.



Ratenlimit-Header

Foundry enthält 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 den Antworten. Verwalte die Ratenlimitierung stattdessen über die Monitoring-Tools von Azure.



Modell- und Bereitstellungsfehler

Fehler: Model not found oder Deployment not found

• Lösung: Überprüfe, ob du den richtigen Bereitstellungsnamen verwendest. Wenn du keine benutzerdefinierte Bereitstellung erstellt hast, verwende die Standard-Modell-ID (zum Beispiel claude-sonnet-4-6).
• Lösung: Stelle sicher, dass das Modell/die Bereitstellung in deiner Azure-Region verfügbar ist.

Fehler: Invalid model parameter

• Lösung: Der model-Parameter sollte deinen Bereitstellungsnamen enthalten, der im Foundry-Portal angepasst werden kann. Überprüfe, ob die Bereitstellung existiert und ordnungsgemäß konfiguriert ist.



Zusätzliche Ressourcen

• Foundry-Dokumentation: ai.azure.com/catalog
• Azure-Preise: azure.microsoft.com/en-us/pricing/details/ai-foundry
• Anthropic-Preisdetails: Modellpreise
• Authentifizierungsleitfaden: Siehe Authentifizierung
• Azure-Portal: portal.azure.com