Claude auf Amazon Bedrock (bedrock-runtime)
Verwende Claude-Modelle auf dem bedrock-runtime-Endpunkt von Amazon Bedrock über die InvokeModel- und Converse-APIs.
Der Aufruf von Claude über Bedrock unterscheidet sich leicht davon, wie du Claude direkt über die Claude API aufrufen würdest. Dieser Leitfaden führt dich durch einen API-Aufruf an Claude auf Bedrock mit einem der Client-SDKs von Anthropic.
Beachte, dass dieser Leitfaden voraussetzt, dass du dich bereits für ein AWS-Konto registriert und den programmgesteuerten Zugriff konfiguriert hast.
AWS CLI installieren und konfigurieren
- Installiere eine Version der AWS CLI, die mindestens Version
2.13.23entspricht oder neuer ist. - Konfiguriere deine AWS-Anmeldedaten mit dem Befehl AWS configure (siehe AWS CLI konfigurieren) oder finde deine Anmeldedaten, indem du in deinem AWS-Dashboard zu Command line or programmatic access navigierst und den Anweisungen im modalen Fenster folgst.
- Überprüfe, ob deine Anmeldedaten funktionieren:
aws sts get-caller-identityEin SDK für den Zugriff auf Bedrock installieren
Die Client-SDKs von Anthropic unterstützen Bedrock. Du kannst auch direkt ein AWS SDK wie boto3 verwenden.
pip install -U "anthropic[bedrock]<2"Zugriff auf Bedrock
Anthropic-Modelle abonnieren
Gehe zu AWS Console > Bedrock > Modellzugriff und beantrage Zugriff auf Anthropic-Modelle. Beachte, dass die Verfügbarkeit von Anthropic-Modellen je nach Region variiert. Die neuesten Informationen findest du in der AWS-Dokumentation zur Modellverfügbarkeit nach Region.
API-Modell-IDs
Lebenszyklusbegriffe (Abgekündigt, Eingestellt) sind unter Modell-Abkündigungen definiert. Lebenszyklusdaten auf von Partnern betriebenen Plattformen werden vom Partner festgelegt und können vom Zeitplan der Claude API abweichen. Das aktuelle Einstellungsdatum eines Modells auf Amazon Bedrock findest du auf der Modell-Lebenszyklusseite von Amazon Bedrock.
AWS bietet neuere Claude-Modelle über regionsübergreifende Inferenz statt über On-Demand-Durchsatz an. Bei diesen Modellen 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 statt der Basis-Modell-ID ein Inferenzprofil. Die Inferenzprofil-ID ist die Basis-Modell-ID mit einem Präfix aus einer Spalte, die in der folgenden Tabelle mit „Ja“ markiert ist, zum Beispiel us.anthropic.claude-sonnet-4-5-20250929-v1:0. Du kannst auch den vollständigen Inferenzprofil-ARN in der Form arn:aws:bedrock:{region}:{account-id}:inference-profile/{inference-profile-id} übergeben. Die maßgebliche Liste der verfügbaren Inferenzprofile von AWS findest du unter Unterstützte Regionen und Modelle für Inferenzprofile. Wie sich die Präfixe auf Routing und Preise auswirken, erfährst du im Abschnitt Globale versus regionale Endpunkte.
| Modell | Basis-Bedrock-Modell-ID | global | us | eu | jp | apac |
|---|---|---|---|---|---|---|
| Claude Fable 5.2 | anthropic.claude-fable-5-2 | Ja | Ja | Nein | Nein | Nein |
| Claude Mythos 5.2 (eingeschränkt verfügbar(wird in neuem Tab geöffnet)) | anthropic.claude-mythos-5-2 | Ja | Ja | Nein | Nein | Nein |
| Claude Opus 4.6 | anthropic.claude-opus-4-6-v1 | Ja | Ja | Ja | Ja | Ja |
| Claude Opus 4.5 | anthropic.claude-opus-4-5-20251101-v1:0 | Ja | Ja | Ja | Nein | Nein |
| Claude Opus 4.1 (veraltet) | anthropic.claude-opus-4-1-20250805-v1:0 | Nein | Ja | Nein | Nein | Nein |
| Claude Sonnet 4.6 | anthropic.claude-sonnet-4-6 | Ja | Ja | Ja | Ja | Nein |
| Claude Sonnet 4.5 (veraltet) | anthropic.claude-sonnet-4-5-20250929-v1:0 | Ja | Ja | Ja | Ja | Nein |
| Claude Sonnet 4 (veraltet) | anthropic.claude-sonnet-4-20250514-v1:0 | Ja | Ja | Ja | Nein | Ja |
| Claude Haiku 4.5 | anthropic.claude-haiku-4-5-20251001-v1:0 | Ja | Ja | Ja | Nein | Nein |
Verfügbare Modelle auflisten
Die folgenden Beispiele zeigen, wie du eine Liste aller über Bedrock verfügbaren Claude-Modelle ausgibst:
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:
from anthropic import AnthropicBedrock
client = AnthropicBedrock(
# Authentifiziere dich, indem du entweder die folgenden Keys angibst oder die Standard-AWS-Credential-Provider verwendest, etwa
# über ~/.aws/credentials oder die Umgebungsvariablen "AWS_SECRET_ACCESS_KEY" und "AWS_ACCESS_KEY_ID".
aws_access_key="<access key>",
aws_secret_key="<secret key>",
# Temporäre Anmeldedaten können mit aws_session_token verwendet werden.
# Mehr dazu unter https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
aws_session_token="<session_token>",
# aws_region ändert die AWS-Region, an die die Anfrage gesendet wird. Fehlt sie, liest das SDK
# AWS_REGION / AWS_DEFAULT_REGION, dann die für deine boto3-Session oder dein AWS-Profil konfigurierte Region
# (einschließlich ~/.aws/config) und löst ValueError aus, wenn keine Region ermittelt werden kann.
aws_region="us-west-2",
)
message = client.messages.create(
model="global.anthropic.claude-opus-4-6-v1",
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}],
)
print(message.content)Weitere Details findest du in den Client-SDKs und in der offiziellen Bedrock-Dokumentation.
Bearer-Token-Authentifizierung
Du kannst dich bei Bedrock mit Bearer-Tokens statt mit AWS-Anmeldedaten authentifizieren. Das ist in Unternehmensumgebungen nützlich, in denen Teams Zugriff auf Bedrock benötigen, ohne AWS-Anmeldedaten, IAM-Rollen oder Berechtigungen auf Kontoebene zu verwalten.
Der einfachste Ansatz ist, die Umgebungsvariable AWS_BEARER_TOKEN_BEDROCK zu setzen, die das SDK automatisch erkennt, wenn es Anmeldedaten aus der Umgebung auflöst.
So stellst du ein Token programmgesteuert bereit:
from anthropic import AnthropicBedrock
client = AnthropicBedrock(
api_key="your-bearer-token",
aws_region="us-west-2",
)
message = client.messages.create(
model="us.anthropic.claude-sonnet-4-5-20250929-v1:0",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)Aktivitätsprotokollierung
Bedrock bietet einen Dienst zur Aufrufprotokollierung, 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 nachvollziehen und möglichen Missbrauch untersuchen zu können.
Feature-Unterstützung
Die vollständige Feature-Liste mit Verfügbarkeit auf Amazon Bedrock findest du in der Feature-Übersicht.
Wichtigste unterstützte Features
- Messages APIVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren.
- Prompt-Caching
- Nachdenken
- Tool-Nutzung, einschließlich Bash-Tool, Computer-Use-Tool, Memory-Tool und Texteditor-Tool
- Zitate
- Strukturierte Ausgaben
Nicht unterstützte Features
- Eingabequellen (URL-Quellen für Bilder und Dokumente, Files API)
- Serverseitige Tools (Codeausführung, Websuche, Webabruf, Advisor)
- Agent-Infrastruktur (Agent Skills, MCP-Connector, programmatischer Tool-Aufruf)
- API-Endpunkte (Message Batches, Models, Admin, Compliance, Usage and Cost)
- Claude Managed Agents
- Serverseitiger Fallback (der
fallbacks-Parameter; verwende stattdessen das clientseitige Fallback-Muster) - Automatisches Prompt-Caching (das
cache_control-Feld auf oberster Ebene; verwende stattdessen explizite Cache-Breakpoints)
Computer-Use- und Browser-Use-Toolsets auf Bedrock
Die Toolsets für Computer Use und Browser Use sind über die InvokeModel API für diese Modelle verfügbar:
- Claude Fable 5.2
- Claude Mythos 5.2
- Claude Fable 5.1
- Claude Fable 5
- Claude Opus 5.5
- Claude Opus 5
- Claude Opus 4.8
- Claude Sonnet 5.5
- Claude Sonnet 5
- Claude Haiku 5.5
Um eines davon zu verwenden, füge dem tools-Array einen Eintrag vom Typ computer_toolset_20260801 oder browser_toolset_20260801 hinzu. Für keines der beiden Toolsets ist ein Beta-Header erforderlich.
PDF-Unterstützung auf Bedrock
PDF-Unterstützung ist auf Bedrock sowohl über die Converse API als auch über die InvokeModel API verfügbar.
System-Nachrichten mitten in der Konversation auf Bedrock
System-Nachrichten mitten in der Konversation sind über die InvokeModel API für Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Sonnet 5.5 und Claude Haiku 5.5 verfügbar. Dieses Feature ist auf Claude Sonnet 5 nicht verfügbar. Verwende stattdessen das system-Feld auf oberster Ebene. Für die anderen Modelle in der Modelltabelle auf dieser Seite ist es nicht verfügbar.
Eine role: "system"-Nachricht kann außerdem output_config.effort setzen, um auf Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1 und Claude Opus 5.5 den Effort mitten in der Konversation zu ändern. Dies befindet sich in der Beta: Füge mid-conversation-output-config-2026-07-01 zum anthropic_beta-Array im Request-Body hinzu. Ohne diesen Wert oder auf Claude Fable 5, Claude Opus 5 oder Claude Opus 4.8 gibt die Anfrage einen 400-Fehler zurück: messages.N.output_config: Extra inputs are not permitted. Im Fehler ist N der Index der system-Nachricht in messages.
Für Nutzer der Converse API: Die Converse API akzeptiert Systemanweisungen über ihren system-Parameter auf oberster Ebene. Um Systemanweisungen mitten in der Konversation hinzuzufügen, verwende die InvokeModel API.
Kontextfenster
Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5.5, Claude Sonnet 5, Claude Sonnet 4.6 und Claude Haiku 5.5 haben auf Amazon Bedrock ein „context window“ (Kontextfenster) von 1M Token. Andere Claude-Modelle, einschließlich Sonnet 4.5 (abgekündigt) und Sonnet 4 (abgekündigt), haben ein Kontextfenster von 200k Token.
Bedrock begrenzt Request-Payloads auf 20 MB. Wenn du große Dokumente oder viele Bilder sendest, kannst du dieses Limit erreichen, bevor du das Token-Limit erreichst.
Globale versus regionale Endpunkte
Ab Claude Sonnet 4.5 und allen zukünftigen Modellen bietet Bedrock zwei Endpunkttypen an:
- Globale Endpunkte: Dynamisches Routing für maximale Verfügbarkeit
- Regionale Endpunkte: Garantiertes Datenrouting durch bestimmte geografische Regionen
Regionale Endpunkte beinhalten einen Preisaufschlag von 10 Prozent gegenüber globalen Endpunkten.
Wann welche Option verwendet werden sollte
Globale Endpunkte (empfohlen):
- Bieten maximale Verfügbarkeit und Betriebszeit
- Leiten Anfragen dynamisch an Regionen mit verfügbarer Kapazität weiter
- Haben keinen Preisaufschlag
- Eignen sich am besten für Anwendungen, bei denen die Datenresidenz flexibel ist
Regionale Endpunkte (CRIS):
- Leiten Datenverkehr durch bestimmte geografische Regionen
- Sind für Anforderungen an Datenresidenz und Compliance erforderlich
- Sind für USA, EU, Japan und Asien-Pazifik verfügbar
- Haben einen Preisaufschlag von 10 Prozent, der die Infrastrukturkosten für dedizierte regionale Kapazität widerspiegelt
Implementierung
Globale Endpunkte verwenden (Standard für Opus 4.6, Sonnet 4.6 und Sonnet 4.5 (abgekündigt)):
Die Modell-IDs für Claude Opus 4.6, Sonnet 4.6 und Sonnet 4.5 (abgekündigt) enthalten bereits das Präfix global.:
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-west-2")
message = client.messages.create(
model="global.anthropic.claude-opus-4-6-v1",
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}],
)Regionale Endpunkte verwenden (CRIS):
Um regionale Endpunkte zu verwenden, ersetze das Präfix global. durch ein regionales Präfix wie us.:
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-west-2")
# Regionalen US-Endpunkt verwenden (CRIS)
message = client.messages.create(
model="us.anthropic.claude-opus-4-6-v1", # Regional prefix
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}],
)Zusätzliche Ressourcen
- Bedrock-Preise: Amazon Bedrock-Preisseite
- AWS-Preisdokumentation: Bedrock-Preisleitfaden
- AWS-Blogbeitrag: Introducing Claude Sonnet 4.5 in Amazon Bedrock
- Anthropic-Preisdetails: Preise für Cloud-Plattformen
War diese Seite hilfreich?