Claude auf Amazon Bedrock (Opus 4.6 und früher)

Der Aufruf von Claude über Bedrock unterscheidet sich geringfügig davon, wie du Claude direkt über die Claude API aufrufen würdest. Dieser Leitfaden führt dich durch die Durchführung eines API-Aufrufs an Claude auf Bedrock mit einem der Client-SDKs von Anthropic.

Beachte, dass dieser Leitfaden davon ausgeht, dass du dich bereits für ein AWS-Konto registriert und den programmatischen Zugriff konfiguriert hast.



Installiere und konfiguriere die AWS CLI

1. Installiere eine Version der AWS CLI ab Version 2.13.23 oder neuer.
2. Konfiguriere deine AWS-Anmeldedaten mit dem AWS-configure-Befehl (siehe Configure the AWS CLI) oder finde deine Anmeldedaten, indem du in deinem AWS-Dashboard zu „Command line or programmatic access" navigierst und den Anweisungen im modalen Fenster folgst.
3. Überprüfe, ob deine Anmeldedaten funktionieren:

aws sts get-caller-identity



Installiere ein SDK für den Zugriff auf Bedrock

Die Client-SDKs von Anthropic unterstützen Bedrock. Du kannst auch ein AWS SDK wie boto3 direkt verwenden.

pip install -U "anthropic[bedrock]"



Zugriff auf Bedrock



Abonniere Anthropic-Modelle

Gehe zur AWS Console > Bedrock > Model Access und beantrage Zugriff auf Anthropic-Modelle. Beachte, dass die Verfügbarkeit von Anthropic-Modellen je nach Region variiert. Siehe die AWS-Dokumentation für die neuesten Informationen.



API-Modell-IDs

Lebenszyklus-Begriffe (Deprecated, Retired) sind in Modell-Deprecations definiert. Lebenszyklus-Daten auf von Partnern betriebenen Plattformen werden vom Partner festgelegt und können vom Zeitplan der Claude API abweichen. Für das aktuelle Retirement-Datum eines Modells auf Amazon Bedrock siehe die Modell-Lebenszyklus-Seite von Amazon Bedrock.

AWS bietet neuere Claude-Modelle über Cross-Region Inference statt über On-Demand-Durchsatz an. Für diese Modelle schlägt eine Anfrage, die die Basis-Modell-ID übergibt, mit einem HTTP-400-Fehler wie dem folgenden fehl:

Invocation of model ID anthropic.claude-sonnet-4-5-20250929-v1:0 with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.

Um diese Modelle aufzurufen, übergib ein Inference-Profil anstelle der Basis-Modell-ID. Die Inference-Profil-ID ist die Basis-Modell-ID mit einem Präfix aus einer mit „Yes" markierten Spalte in der folgenden Tabelle, zum Beispiel us.anthropic.claude-sonnet-4-5-20250929-v1:0. Du kannst auch die vollständige Inference-Profil-ARN in der Form arn:aws:bedrock:{region}:{account-id}:inference-profile/{inference-profile-id} übergeben. Für die maßgebliche Liste der verfügbaren Inference-Profile von AWS siehe Supported Regions and models for inference profiles. Wie sich die Präfixe auf Routing und Preise auswirken, erfährst du im Abschnitt Globale versus regionale Endpunkte.



Verfügbare Modelle auflisten

Die folgenden Beispiele zeigen, wie du eine Liste aller über Bedrock verfügbaren Claude-Modelle ausgeben kannst:

import boto3

bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")

for summary in response["modelSummaries"]:
    print(summary["modelId"])



Anfragen stellen

Die folgenden Beispiele zeigen, wie du mit Claude auf Bedrock Text generierst:

Siehe die Client-SDKs für weitere Details und die offizielle Bedrock-Dokumentation.



Bearer-Token-Authentifizierung

Du kannst dich bei Bedrock mit Bearer-Tokens anstelle von AWS-Anmeldedaten authentifizieren. Das ist nützlich in Unternehmensumgebungen, in denen Teams Zugriff auf Bedrock benötigen, ohne AWS-Anmeldedaten, IAM-Rollen oder Berechtigungen auf Kontoebene verwalten zu müssen.

Der einfachste Ansatz ist, die Umgebungsvariable AWS_BEARER_TOKEN_BEDROCK zu setzen, die jedes SDK automatisch erkennt, wenn es Anmeldedaten aus der Umgebung auflöst.

Um ein Token programmatisch bereitzustellen:



Aktivitätsprotokollierung

Bedrock bietet einen Invocation-Logging-Dienst, mit dem du die Prompts und Completions protokollieren kannst, die mit deiner Nutzung verbunden sind.

Anthropic empfiehlt, deine Aktivität mindestens auf einer rollierenden 30-Tage-Basis zu protokollieren, um deine Aktivität zu verstehen und potenziellen Missbrauch zu untersuchen.



Feature-Unterstützung

Die vollständige Feature-Liste mit der Verfügbarkeit auf Amazon Bedrock findest du in der Feature-Übersicht.



Highlights der unterstützten Features

• Messages API
• Prompt-Caching
• Thinking
• Tool-Nutzung, einschließlich des Bash-Tools, Computer-Use-Tools, Memory-Tools und Texteditor-Tools
• Zitationen
• Strukturierte Ausgaben



Nicht unterstützte Features

• Eingabequellen (URL-Quellen für Bilder und Dokumente, Files API)
• Serverseitige Tools (Code-Ausführung, Websuche, Web-Fetch, Advisor)
• Agent-Infrastruktur (Agent Skills, MCP-Connector, programmatische Tool-Aufrufe)
• API-Endpunkte (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Serverseitiger Fallback (der fallbacks-Parameter; verwende stattdessen das clientseitige Fallback-Muster)



PDF-Unterstützung auf Bedrock

PDF-Unterstützung ist auf Bedrock sowohl über die Converse API als auch über die InvokeModel API verfügbar. Detaillierte Informationen zu den Fähigkeiten und Einschränkungen der PDF-Verarbeitung findest du unter Amazon Bedrock PDF-Unterstützung.

Wichtige Überlegungen für Nutzer der Converse API:

• Visuelle PDF-Analyse (Diagramme, Bilder, Layouts) erfordert aktivierte Zitationen
• Ohne Zitationen ist nur eine grundlegende Textextraktion verfügbar
• Für volle Kontrolle ohne erzwungene Zitationen verwende die InvokeModel API



Kontextfenster

Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 und Claude Sonnet 4.6 haben auf Amazon Bedrock ein Kontextfenster mit 1M Token. Andere Claude-Modelle, einschließlich Sonnet 4.5 und Sonnet 4 (deprecated), haben ein Kontextfenster mit 200k Token.

Bedrock begrenzt Request-Payloads auf 20 MB. Beim Senden großer Dokumente oder vieler Bilder kannst du dieses Limit erreichen, bevor du das Token-Limit erreichst.



Globale versus regionale Endpunkte

Beginnend mit Claude Sonnet 4.5 und allen zukünftigen Modellen bietet Bedrock zwei Endpunkt-Typen an:

• Globale Endpunkte: Dynamisches Routing für maximale Verfügbarkeit
• Regionale Endpunkte: Garantiertes Daten-Routing durch bestimmte geografische Regionen

Regionale Endpunkte beinhalten einen Preisaufschlag von 10 % gegenüber globalen Endpunkten.



Wann welche Option verwenden

Globale Endpunkte (empfohlen):

• Bieten maximale Verfügbarkeit und Betriebszeit
• Leiten Anfragen dynamisch an Regionen mit verfügbarer Kapazität weiter
• Kein Preisaufschlag
• Am besten für Anwendungen, bei denen die Datenresidenz flexibel ist

Regionale Endpunkte (CRIS):

• Leiten den Datenverkehr durch bestimmte geografische Regionen
• Erforderlich für Datenresidenz- und Compliance-Anforderungen
• Verfügbar für USA, EU, Japan und Asien-Pazifik
• Der Preisaufschlag von 10 % spiegelt die Infrastrukturkosten für dedizierte regionale Kapazität wider



Implementierung

Verwendung globaler Endpunkte (Standard für Opus 4.6, Sonnet 4.6 und Sonnet 4.5):

Die Modell-IDs für Claude Opus 4.6, Sonnet 4.6 und Sonnet 4.5 enthalten bereits das Präfix global.:

Verwendung regionaler Endpunkte (CRIS):

Um regionale Endpunkte zu verwenden, ersetze das Präfix global. durch ein regionales Präfix wie us.:



Zusätzliche Ressourcen

• Bedrock-Preise: Amazon-Bedrock-Preisseite
• AWS-Preisdokumentation: Bedrock-Preisleitfaden
• AWS-Blogbeitrag: Introducing Claude Sonnet 4.5 in Amazon Bedrock
• Anthropic-Preisdetails: Cloud-Plattform-Preise