Claude auf Amazon Bedrock (Legacy)

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 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 Popup-Dialog 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.



Zugriff auf Bedrock



Anthropic-Modelle abonnieren

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 Abschaltdatum eines Modells auf Amazon Bedrock siehe die Modell-Lebenszyklus-Seite von Amazon Bedrock.

Weitere Informationen zu regionalen vs. globalen Modell-IDs findest du im Abschnitt Globale vs. 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:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Authentifiziere dich, indem du entweder die untenstehenden Keys angibst oder die Standard-AWS-Credential-Provider verwendest, z. B.
    # ü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. Standardmäßig liest das SDK AWS_REGION,
    # und falls diese nicht gesetzt ist, wird us-east-1 verwendet. Beachte, dass das SDK die Region nicht aus ~/.aws/config liest.
    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 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:

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 Invocation-Logging-Dienst, mit dem Kunden die Prompts und Completions protokollieren können, die mit ihrer 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
• Erweitertes Denken
• 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)
• Agenten-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 einfache Textextraktion verfügbar
• Für volle Kontrolle ohne erzwungene Zitationen verwende die InvokeModel API



Kontextfenster

Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6 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 Anfrage-Payloads auf 20 MB. Beim Senden großer Dokumente oder vieler Bilder kannst du dieses Limit erreichen, bevor du das Token-Limit erreichst.



Globale vs. regionale Endpunkte

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

• 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 die USA, die EU, Japan und den asiatisch-pazifischen Raum
• 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.:

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"}],
)

Verwendung regionaler Endpunkte (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")

# Verwendung des regionalen US-Endpunkts (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: aws.amazon.com/bedrock/pricing
• AWS-Preisdokumentation: Bedrock-Preisleitfaden
• AWS-Blogbeitrag: Introducing Claude Sonnet 4.5 in Amazon Bedrock
• Anthropic-Preisdetails: Cloud-Plattform-Preise