Claude Platform on AWS bietet dir das vollständige Anthropic-Plattformerlebnis, einschließlich der Messages API, Agent Skills, Code-Ausführung und Beta-Features, zugänglich über dein AWS-Konto. Im Gegensatz zu Amazon Bedrock, bei dem AWS den Inferenz-Stack betreibt, wird Claude Platform on AWS von Anthropic betrieben. AWS stellt die Authentifizierungsschicht (SigV4 oder API-Key), IAM-basierte Zugriffskontrolle und die Abrechnungsintegration über AWS Marketplace bereit.
Die Anthropic SDKs unterstützen Claude Platform on AWS.
Claude-Modelle laufen auf von Anthropic verwalteter Infrastruktur. Dies ist eine kommerzielle Integration für Abrechnung und Zugriff über AWS. Anthropic ist der Datenverarbeiter für Inferenz-Eingaben und -Ausgaben; AWS verarbeitet Abrechnungs- und Identitätsmetadaten im Rahmen des Marketplace-Modells. Kunden, die Claude über Claude Platform on AWS nutzen, unterliegen den Datennutzungsbedingungen von Anthropic. Anthropic bietet weiterhin seine branchenführenden Sicherheits- und Datenzusagen.
Beachte die folgenden betrieblichen Merkmale: Daten befinden sich möglicherweise nicht in AWS; Inferenz kann an die primäre Cloud von Anthropic weitergeleitet werden; und Subservices können ohne Vorankündigung im Hintergrund verlagert werden. Setze den Parameter inference_geo pro Anfrage, um die Inferenz an eine bestimmte Geografie zu binden.
Claude Platform on AWS folgt derselben Datenaufbewahrungsrichtlinie wie die First-Party Claude API. Zero Data Retention (ZDR) ist auf Anfrage verfügbar. Kontaktiere deinen Anthropic-Ansprechpartner, um es für deine Organisation zu aktivieren.
Beide Angebote ermöglichen dir die Nutzung von Claude über AWS, unterscheiden sich jedoch erheblich in Architektur, API-Oberfläche und Feature-Verfügbarkeit.
| Aspekt | Claude Platform on AWS | Claude in Amazon Bedrock | Amazon Bedrock (Legacy) |
|---|---|---|---|
| Wer betreibt den Stack | Anthropic | AWS | AWS |
| API-Oberfläche | Claude API (/v1/{endpoint}) | Messages API unter /anthropic/v1/messages | Bedrock Converse / InvokeModel |
| Feature-Verfügbarkeit | In der Regel am selben Tag wie die Claude API (siehe Feature-Einschränkungen) | Gemäß Amazon Bedrock-Release-Zeitplan | Gemäß Amazon Bedrock-Release-Zeitplan |
| Agent Skills | Verfügbar (Beta) | Nicht verfügbar (erfordert Code-Ausführung) | Nicht verfügbar |
| Beta-Features | Durchreichen mit anthropic-beta-Headern (siehe Feature-Einschränkungen) | anthropic-beta-Header nicht unterstützt | anthropic-beta-Header nicht unterstützt |
| Authentifizierung | AWS IAM / SigV4 oder API-Key | AWS IAM / SigV4 | AWS IAM / SigV4 oder Bearer-Token (nur C#-, Go- und Java-SDKs) |
| Abrechnung | AWS Marketplace | AWS (nativer Service) | AWS (nativer Service) |
| Basis-URL | aws-external-anthropic.{region}.api.aws | bedrock-mantle.{region}.api.aws | bedrock-runtime.{region}.amazonaws.com |
| SDK-Client | Plattformspezifische Client-Klasse (zum Beispiel AnthropicAWS in Python), in Beta | AnthropicBedrockMantle | AnthropicBedrock / Bedrock SDK |
| Konsole | Claude Console (platform.claude.com, Zugriff über die AWS Console) | Bedrock Console | Bedrock Console |
| Ratenlimits und Kontingente | Von Anthropic verwaltet | Von AWS verwaltet | Von AWS verwaltet |
| Inferenz-Datenverarbeiter | Anthropic | AWS | AWS |
Wenn du von AWS betriebenes Claude benötigst, siehe Claude in Amazon Bedrock. Claude Platform on AWS verwendet einen separaten Kapazitätspool, getrennt sowohl von der First-Party Claude API als auch von Amazon Bedrock. Du kannst Workloads auf mehr als einer Plattform ausführen und zwischen ihnen ein Failover durchführen.
AWS PrivateLink wird unterstützt, um deine VPC mit dem Claude Platform on AWS-Endpunkt zu verbinden.
Wann du Bedrock wählen solltest: Organisationen in regulierten Branchen, die FedRAMP High, IL4, IL5 oder HIPAA-Ready-Compliance benötigen oder bei denen AWS der alleinige Datenverarbeiter sein muss, sollten Claude in Amazon Bedrock verwenden. Bedrock läuft vollständig auf von AWS kontrollierter Infrastruktur mit AWS als betreibender Partei.
Die Einrichtung von Claude Platform on AWS erfolgt in vier Phasen: Registrierung auf der Service-Seite der AWS Console, Abschluss der Einrichtung deiner Anthropic-Organisation, Notieren deiner Workspace-ID und Anmeldung bei der Claude Console.
Die Registrierung über die AWS Console erstellt eine neue Anthropic-Organisation, die mit deinem AWS-Konto verknüpft ist. Diese Organisation ist getrennt von allen bestehenden Organisationen, die dein Unternehmen bei Anthropic hat, einschließlich Claude Enterprise-Organisationen, die über AWS Marketplace erworben wurden. API-Keys, Workspaces und Claude Console-Einstellungen aus einer First-Party-Anthropic-Organisation werden nicht übernommen.
Wenn du ein bestehendes Amazon Bedrock Private Offer hast, kontaktiere deinen Anthropic- oder AWS-Ansprechpartner vor der Registrierung, damit dein Rabatt ab deiner ersten Anfrage gilt. Rabatte können nicht rückwirkend auf Nutzung angewendet werden, die vor der Annahme deines Private Offers angefallen ist. Siehe Private Offers.
In der AWS Console registrieren
Die Seite zeigt ein Banner Sign-up in progress an. Bleibe auf der Seite. Die Registrierung dauert einige Minuten, während AWS das AWS Marketplace-Abonnement für dich abwickelt, und leitet dich dann automatisch weiter.
Wenn deine Organisation ein Private Offer von Anthropic hat, sucht die Konsole danach und fordert dich auf, es in AWS Marketplace zu akzeptieren. Siehe Private Offers für Details.
Wenn du Claude Platform on AWS verwendest, werden deine Inhalte (wie Prompts und Completions) von Anthropic außerhalb von AWS verarbeitet. Siehe Anthropics Datennutzungsrichtlinien für Details dazu, wie Inhalte und Metadaten verarbeitet und gespeichert werden.
Deine Anthropic-Organisation einrichten
Nach Abschluss der Registrierung wirst du zu platform.claude.com/partner-signup weitergeleitet.
Der Abschluss der Einrichtung erstellt deine Anthropic-Organisation und akzeptiert Anthropics Commercial Terms of Service und Usage Policy. Die Service-Seite in der AWS Console zeigt nun eine linke Navigation mit Home, API keys, Quickstart und Workspaces.
Deinen Workspace erstellen und seine ID notieren
Nach Abschluss der Einrichtung fordert dich die AWS Console auf, einen Workspace zu erstellen. Siehe Workspaces für Details zur Regionsbindung, IAM-Ressourcen-Scoping und zum Erstellen zusätzlicher Workspaces.
Du findest die Workspace-ID unter Workspaces auf der Service-Seite Claude Platform on AWS in der AWS Console oder in der Claude Console. Workspace-IDs verwenden das Format wrkspc_ gefolgt von einem alphanumerischen Bezeichner.
Bei der Claude Console anmelden
Der Zugriff auf die Claude Console ist über AWS IAM föderiert:
aws-external-anthropic:AssumeConsole an. Siehe IAM-Aktionen für Claude Platform on AWS.platform.claude.com weiter.Wenn du über die AWS Console angemeldet bist, ist die Claude Console auf deine Claude Platform on AWS-Organisation beschränkt. Ein Indikator Account managed by AWS erscheint unten links in der Seitenleiste der Claude Console.
Stelle sicher, dass du Folgendes hast:
Das Claude Platform on AWS-Gateway ruft serverseitig sts:GetWebIdentityToken auf, um ein JWT zu erstellen, das es an Anthropic weiterleitet. Diese STS-Funktion ist in jedem AWS-Konto standardmäßig deaktiviert. Aktiviere sie einmal pro Konto:
aws iam enable-outbound-web-identity-federationWenn die Antwort [ERROR] (FeatureEnabled) ... already enabled lautet, ist die Einstellung für dein Konto bereits aktiviert und du kannst fortfahren. Überprüfe und rufe die Issuer-URL deines Kontos ab:
aws iam get-outbound-web-identity-federation-infoOhne diesen Schritt gibt jede Anfrage "Outbound web identity federation is disabled for your account" zurück. Dies ist der häufigste Einrichtungsfehler.
Du erstellst einen Workspace über die AWS Console, nachdem du die Kontoeinrichtung abgeschlossen hast (siehe Dein Konto einrichten). Workspaces sind an eine einzelne AWS-Region gebunden. Du findest die Workspace-ID in der Claude Console unter Workspaces oder im Abschnitt Workspaces der Service-Seite in der AWS Console.
Setze die Umgebungsvariablen ANTHROPIC_AWS_WORKSPACE_ID und AWS_REGION, damit die SDK-Clients sie automatisch lesen:
export ANTHROPIC_AWS_WORKSPACE_ID='wrkspc_01AbCdEf23GhIj'
export AWS_REGION='us-west-2' # Your workspace's AWS regionDie Region ist erforderlich. Der SDK-Client löst einen Fehler aus, wenn keine Region gesetzt ist. Übergib aws_region/awsRegion an den Konstruktor oder setze AWS_REGION (oder AWS_DEFAULT_REGION). Alle kommerziellen AWS-Regionen werden unterstützt.
Claude Platform on AWS unterstützt zwei Authentifizierungsmethoden: AWS IAM mit SigV4-Request-Signing (primär) und API-Key-Authentifizierung. Beide verwenden dieselbe Basis-URL und dasselbe Anfrageformat.
SigV4 ist der Enterprise-native Weg und integriert sich in deine bestehenden AWS IAM-Richtlinien, -Rollen und -Audits. Konfiguriere AWS-Anmeldeinformationen mit einer beliebigen Methode, die von der AWS Default Credential Provider Chain unterstützt wird:
AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN)~/.aws/credentials)~/.aws/config) einschließlich SSO und credential_processAWS_WEB_IDENTITY_TOKEN_FILE und AWS_ROLE_ARN) für IRSA und GitHub ActionsÜberprüfe, ob deine Anmeldeinformationen funktionieren:
aws sts get-caller-identityFür einfachere Integrationspfade (lokale Entwicklung und Skripte) kannst du dich mit einem API-Key anstelle von SigV4 authentifizieren. Setze die Umgebungsvariable ANTHROPIC_AWS_API_KEY oder übergib apiKey an den SDK-Konstruktor.
Generiere API-Keys in der AWS Console unter Claude Platform on AWS → API keys. Wähle Generate a key und kopiere dann den Key-Wert. Gewähre die IAM-Aktion aws-external-anthropic:CallWithBearerToken den Principals, die die API-Key-Authentifizierung verwenden dürfen.
API-Keys für Claude Platform on AWS werden in der AWS Console verwaltet, nicht in der Claude Console. Keys, die in der Standard-Claude Console (für First-Party-API-Zugriff) erstellt wurden, funktionieren nicht mit dem Claude Platform on AWS-Endpunkt.
Für Workloads, die Anmeldeinformationen an einen separaten Prozess übergeben müssen (wie ein LLM-Gateway, eine Serverless-Funktion oder ein Tool, das Bearer-Token-Authentifizierung, aber nicht SigV4 unterstützt), generiere einen kurzlebigen API-Key aus deinen AWS-Anmeldeinformationen, anstatt einen langlebigen Key in der AWS Console bereitzustellen.
AWS veröffentlicht Token-Generator-Bibliotheken für JavaScript, Python und Java. Jede Bibliothek liest deine AWS-Anmeldeinformationen über die Standard-Provider-Chain und gibt ein zeitlich begrenztes Token zurück, das mit dem x-api-key-Header funktioniert. Die Token-Lebensdauer beträgt standardmäßig 12 Stunden und ist auf den kleineren Wert aus deiner angeforderten Dauer, dem Ablauf deiner AWS-Anmeldeinformationen und 12 Stunden begrenzt. Siehe die verlinkten Repository-READMEs für Installation und vollständige Konfigurationsoptionen.
Übergib das generierte Token an das SDK auf dieselbe Weise, wie du einen in der AWS Console generierten API-Key übergeben würdest:
from token_generator_for_aws_external_anthropic import TokenGenerator
from anthropic import AnthropicAWS
token = TokenGenerator(region="us-west-2").get_token()
client = AnthropicAWS(api_key=token, aws_region="us-west-2")Wenn du das Token lokal generieren kannst, verfügt dein Prozess bereits über SigV4-Anmeldeinformationen, und SigV4-Authentifizierung ist in der Regel die einfachere Wahl. Verwende kurzlebige Keys, wenn der Prozess, der API-Aufrufe durchführt, vom Prozess getrennt ist, der die AWS-Anmeldeinformationen hält.
Das SDK aktualisiert kurzlebige Keys nicht automatisch. Wenn ein Token abläuft, generiere ein neues und erstelle einen neuen Client. Der Principal, der das Token verwendet, benötigt weiterhin die IAM-Aktion aws-external-anthropic:CallWithBearerToken.
Der plattformspezifische Client löst die Authentifizierung in der folgenden Reihenfolge auf. Argumentnamen variieren je nach Sprachkonvention (TypeScript und PHP verwenden camelCase wie gezeigt; Python und Ruby verwenden snake_case; Go verwendet PascalCase mit großgeschriebenen Akronymen; C# und Java verwenden die Property- oder Builder-Idiome der jeweiligen Sprache).
apiKey-Konstruktorargument → x-api-key-HeaderawsAccessKey + awsSecretAccessKey-Konstruktorargumente → AWS SigV4awsProfile-Konstruktorargument → AWS SigV4 mit benanntem ProfilANTHROPIC_AWS_API_KEY-Umgebungsvariable → x-api-key-HeaderDer Client liest AWS_REGION aus der Umgebung, wenn aws_region/awsRegion nicht an den Konstruktor übergeben wird, und fällt zur Kompatibilität mit den Standard-AWS-SDKs auf AWS_DEFAULT_REGION zurück. Die Region ist erforderlich; es gibt keinen Fallback-Standardwert. Im Gegensatz zu AnthropicBedrock, das auf us-east-1 zurückfällt, löst der AnthropicAWS/AnthropicAws-Client einen Fehler aus, wenn weder das Konstruktorargument noch die Umgebungsvariable gesetzt ist.
Anthropics Client-SDKs unterstützen Claude Platform on AWS. Jedes SDK bietet eine plattformspezifische Client-Klasse, die SigV4-Signing, regionsbasierte Basis-URL-Konstruktion und den anthropic-workspace-id-Header handhabt.
SDK-Clients für Claude Platform on AWS sind in Beta.
Die folgenden Modelle sind auf Claude Platform on AWS verfügbar:
| Modell | Modell-ID |
|---|---|
| Claude Fable 5 | claude-fable-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 Sonnet 4.6 | claude-sonnet-4-6 |
| Claude Opus 4.5 | claude-opus-4-5 |
| Claude Sonnet 4.5 | claude-sonnet-4-5 |
| Claude Haiku 4.5 | claude-haiku-4-5 |
Modell-IDs sind identisch mit der First-Party Claude API. Es gibt keine Bedrock-artigen ARNs oder anthropic.-Präfixe.
Neue Modelle werden auf Claude Platform on AWS gleichzeitig mit der First-Party Claude API veröffentlicht.
Du führst ein Upgrade auf ein neueres Claude-Modell durch? Führe in Claude Code /claude-api migrate aus, um Modell-ID-Austausche und Breaking-Parameter-Änderungen in deiner gesamten Codebasis anzuwenden. Der Skill erkennt, auf welche Cloud-Plattform dein Code abzielt, und passt Modell-ID-Formate und Feature-Änderungen für diese Plattform an. Siehe Migration zu einem neueren Claude-Modell.
Claude Platform on AWS verwendet dieselben API-Endpunkte wie die First-Party Claude API. Die Unterschiede sind die Basis-URL, die Authentifizierungsmethode und ein erforderlicher anthropic-workspace-id-Header, der angibt, auf welchen Workspace die Anfrage abzielt.
from anthropic import AnthropicAWS
client = AnthropicAWS()
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message)Der Client liest AWS_REGION (oder AWS_DEFAULT_REGION) und ANTHROPIC_AWS_WORKSPACE_ID aus der Umgebung. Du kannst beide überschreiben, indem du aws_region / awsRegion oder workspace_id / workspaceId an den Konstruktor übergibst. Sowohl Region als auch Workspace-ID sind erforderlich. Der Konstruktor löst einen Fehler aus, wenn die Workspace-ID nicht aufgelöst werden kann; eine fehlende Region löst ebenfalls einen Fehler aus.
Der x-amz-security-token-Header (cURL) ist nur für temporäre Anmeldeinformationen wie IAM-Rollen, SSO oder STS erforderlich. Lass ihn weg, wenn du langfristige IAM-Benutzer-Anmeldeinformationen verwendest. Die SDK-Clients handhaben dies automatisch basierend auf der Anmeldeinformationsquelle.
Der --aws-sigv4-Wert folgt dem Format aws:amz:<region>:<service>. Der SigV4-Servicename ist aws-external-anthropic, und die Region muss mit der Region in deiner Endpunkt-URL übereinstimmen. Eine Nichtübereinstimmung in einem der beiden erzeugt einen generischen Signaturablehnungsfehler anstelle einer spezifischen Diagnose.
Die Größen des „context window" (Kontextfenster) auf Claude Platform on AWS sind identisch mit der First-Party Claude API. Siehe Kontextfenster für modellspezifische Limits.
Claude Platform on AWS verwendet Claude API-Endpunkte direkt, was bedeutet, dass du vollständige Feature-Parität mit der First-Party Claude API erhältst (außer wo in den Feature-Einschränkungen angegeben):
anthropic-beta-Header, um auf Beta-Features zuzugreifen, genau wie bei der Claude API.container.skills-Parameter und denselben Beta-Headern wie bei der Claude API. Alle vorgefertigten Skills (PowerPoint, Excel, Word, PDF) funktionieren sofort.external_keys-Admin-API-Endpunkte sind derzeit nicht verfügbar. Der Schlüssel muss sich in derselben AWS-Region befinden wie der Workspace, mit dem er verknüpft ist.Siehe die Vergleichstabelle für Unterschiede in der Feature-Verfügbarkeit gegenüber Amazon Bedrock.
Claude Managed Agents ist auf Claude Platform on AWS verfügbar, einschließlich Agents, Environments, Sessions, Credential Vaults, Memory Stores, Webhooks, Multiagent-Orchestrierung und selbst gehosteten Sandboxes.
Das Session-Verhalten auf Claude Platform on AWS unterscheidet sich in einem Punkt von First-Party Claude Managed Agents:
Die folgenden Funktionen sind derzeit nicht auf Claude Platform on AWS verfügbar:
/v1/organizations/workspaces) sind verfügbar. Andere Admin-API-Endpunkte (Organisationsmitglieder, Workspace-Mitglieder, Einladungen, API-Keys, Nutzungsberichte, Kostenberichte, Ratenlimit-Berichte und externe Schlüssel) sind derzeit nicht verfügbar. Verwalte CMEK-Schlüssel stattdessen in der Claude Console. Sieh dir Nutzungs- und Kostendaten stattdessen in der Claude Console an. AWS IAM verwaltet die Organisationsmitgliedschaft.GET /v1/environments/{id}/work, der ausstehende Arbeit für eine selbst gehostete Sandbox auflistet, ist derzeit nicht verfügbar. Die anderen Work-Endpunkte (poll, ack, heartbeat, stop, post results, per-item get und stats) funktionieren normal.Claude Platform on AWS unterstützt die folgenden Inferenz-Geografien:
Die AWS-Region, an die dein Workspace gebunden ist, steuert, welchen Gateway-Endpunkt du aufrufst und wo AWS-seitige Ressourcen (IAM, CloudTrail, Abrechnung) zugeordnet sind. Sie bestimmt nicht, wo die Modellinferenz ausgeführt wird. Um die Inferenz an eine bestimmte Geografie zu binden, setze inference_geo bei jeder Anfrage oder konfiguriere einen Workspace-Standardwert.
Setze die Inferenz-Geografie pro Anfrage mit dem inference_geo-Parameter:
Der inference_geo-Parameter wird auf Claude Opus 4.6, Claude Sonnet 4.6 und späteren Modellen unterstützt. Anfragen mit inference_geo auf Claude Opus 4.5, Claude Sonnet 4.5 oder Claude Haiku 4.5 geben einen 400-Fehler zurück. Siehe Datenresidenz für Details zur Modellverfügbarkeit.
from anthropic import AnthropicAWS
client = AnthropicAWS()
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
inference_geo="us",
messages=[{"role": "user", "content": "Hello!"}],
)
print(message)Wenn du inference_geo weglässt, verwendet die Anfrage die default_inference_geo des Workspaces, falls eine konfiguriert ist, andernfalls global.
Inferenz-Geografie-Kontrollen auf Workspace-Ebene (allowed_inference_geos und default_inference_geo) sind ebenfalls auf Claude Platform on AWS verfügbar. Siehe Einschränkungen auf Workspace-Ebene.
Inferenz- und Ressourcenanfragen auf Claude Platform on AWS zielen auf einen Workspace ab. Du übergibst die ID des Workspaces im anthropic-workspace-id-Header bei diesen API-Aufrufen. Workspace-IDs verwenden das getaggte Format wrkspc_ gefolgt von einem alphanumerischen Bezeichner (zum Beispiel wrkspc_01AbCdEf23GhIj). Siehe Deine Workspace-ID abrufen, falls du sie noch nicht hast.
Workspaces sind an eine einzelne AWS-Region gebunden. Ein in us-west-2 erstellter Workspace kann nur über den us-west-2-Endpunkt aufgerufen werden. Nutzung, Kontingente, Kosten, Dateien, Batches und Skills werden alle pro Workspace aggregiert, was dir regionsspezifische Aufschlüsselungen in der Claude Console liefert.
Workspaces dienen auch als primäre IAM-Ressource für Claude Platform on AWS. Du gewährst oder verweigerst den Zugriff auf bestimmte Workspaces über AWS IAM-Richtlinien unter Verwendung der Workspace-ARN. Das Ressourcensegment der ARN ist dieselbe wrkspc_-präfixierte ID, die du im anthropic-workspace-id-Header übergibst:
arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}Zum Beispiel:
arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIjSiehe IAM-Richtlinien für Richtlinienbeispiele.
Erstelle zusätzliche Workspaces, benenne einen Workspace um oder archiviere einen Workspace über die Seite Workspaces in der AWS Console oder mit den Workspace-Endpunkten der Admin API. Ein neuer Workspace ist an die AWS-Region des Endpunkts gebunden, den du zum Erstellen aufrufst (siehe Workspace-Scoping). Die Workspaces-Seite in der Claude Console ist schreibgeschützt.
Claude Platform on AWS verwendet die Standard-Claude Console unter platform.claude.com. Wenn du dich über die AWS Console anmeldest, erscheint ein Indikator Account managed by AWS unten links in der Seitenleiste der Claude Console, und die Konsole ist auf deine Claude Platform on AWS-Organisation beschränkt. Sie bietet Nutzungsanalysen, Kostenaufschlüsselungen, Ratenlimit-Sichtbarkeit, Workspace-Sichtbarkeit und Seiten zur Verwaltung von Dateien, Agent Skills, Batch-Jobs und Claude Managed Agents-Ressourcen (Agents, Sessions, Environments, Credential Vaults, Memory Stores und Webhooks).
Der Zugriff auf die Claude Console ist über AWS IAM föderiert. Siehe Dein Konto einrichten für den vollständigen Ablauf der ersten Anmeldung. Kurz zusammengefasst:
aws-external-anthropic:AssumeConsole an. Siehe IAM-Aktionen für Claude Platform on AWS.platform.claude.com weiter.Zwei Claude Console-Rollen sind verfügbar: Admin und Developer. Die Admin-Rolle gewährt Zugriff auf alle Claude Console-Seiten und -Einstellungen, die für Claude Platform on AWS verfügbar sind. Die Developer-Rolle gewährt Lesezugriff auf Nutzungs-, Kosten-, Ratenlimit- und Workspace-Informationen. Kontaktiere deinen Anthropic-Ansprechpartner, um einem Principal die Admin- oder Developer-Rolle zuzuweisen.
Die Spalte Über AWS-Gateway gibt an, ob die Seite Daten über das AWS-Gateway liest und schreibt (und daher durch IAM-Aktionen gesteuert wird). Seiten, die mit Nein gekennzeichnet sind, lesen Metadaten auf Organisationsebene direkt von Anthropic und umgehen die IAM-Aktionsprüfungen.
| Seite | Verfügbar | Über AWS-Gateway | Hinweise |
|---|---|---|---|
| Usage | Ja | Nein | Zeigt die Token-Nutzung nach Modell, Workspace und Dimension an. Es kann einige Minuten dauern, bis Daten nach einer Anfrage erscheinen. |
| Cost | Ja | Nein | Zeigt Kostenaufschlüsselungen nach Modell und Workspace an. AWS Cost Explorer zeigt die aggregierte Claude Consumption Unit (CCU)-Position an. |
| Limits | Ja | Nein | Zeigt Ratenlimits an (schreibgeschützt). |
| Workspaces | Ja | Nein | Zeigt Workspaces pro Region an (schreibgeschützt). |
| Files | Ja | Ja | Hochgeladene Dateien anzeigen und verwalten. |
| Skills | Ja | Ja | Agent Skills anzeigen und verwalten. |
| Batches | Ja | Ja | Batch-Verarbeitungsjobs anzeigen und verwalten. |
| Agents | Ja | Ja | Agent-Definitionen anzeigen und verwalten. |
| Sessions | Ja | Ja | Agent-Sessions und Ereignisverlauf anzeigen. |
| Environments | Ja | Ja | Cloud-Sandbox-Konfigurationen für Sessions anzeigen und verwalten. |
| Credential vaults | Ja | Ja | Credential Vaults für die Session-Authentifizierung anzeigen und verwalten. |
| Memory stores | Ja | Ja | Persistenten Agent-Speicher anzeigen und verwalten. |
| Webhooks | Ja | Ja | Webhook-Endpunkte unter Settings → Webhooks anzeigen und verwalten. |
| API keys | Nein | N/A | Verwalte API-Keys in der AWS Console (Claude Platform on AWS → API keys). Siehe API-Key-Authentifizierung. |
| Members | Nein | N/A | Nicht anwendbar. AWS IAM verwaltet den Zugriff. |
| Billing | Nein | N/A | Nicht anwendbar. AWS Marketplace verwaltet Abrechnung und Rechnungsstellung. Kostenaufschlüsselungen findest du auf der Cost-Seite. |
| Claude Code | Nein | N/A | Claude Code-Nutzung findest du auf der Usage-Seite. |
Die Claude Console unterstützt keinen Organisationswechsel für Claude Platform on AWS. Um auf eine andere Organisation zuzugreifen, melde dich ab und authentifiziere dich erneut über die AWS Console mit der IAM-Rolle für das AWS-Konto dieser Organisation.
Claude Platform on AWS weist bei der Anmeldung Ratenlimits der Stufe 1 zu. Anthropic verwaltet Ratenlimits direkt, nicht über AWS-Kontingentsysteme.
Im Gegensatz zur First-Party-Claude-API gibt es keine automatische Stufenerhöhung. Wenn du höhere Limits benötigst, wende dich an deinen Anthropic-Ansprechpartner. Details zu den Stufen und Limits pro Modell findest du unter Ratenlimits.
Claude Platform on AWS rechnet über AWS Marketplace ab. Die Nutzung wird in „Claude Consumption Units" (Claude-Verbrauchseinheiten), oder CCUs, angegeben, stündlich gemessen und monatlich nachträglich auf deiner AWS-Rechnung abgerechnet. CCUs sind keine vorausbezahlten Credits; es gibt kein CCU-Guthaben und keine Verpflichtung.
Informationen zum CCU-Preis, zur Umrechnungsmechanik, zur Anwendung von Rabatten und zu den Token-Preisen pro Modell findest du unter Claude Platform on AWS – Preise.
AWS CloudTrail kann alle Anfragen an Claude Platform on AWS erfassen. Workspace-, Vault- und Webhook-Operationen werden standardmäßig als Management-Events protokolliert. Inferenz-, Batch-, Datei-, Skill-, Modell-, Benutzerprofil- und Claude-Managed-Agents-Operationen (außer Vaults und Webhooks) werden als Data-Events klassifiziert und erfordern eine explizite Konfiguration des Data-Event-Loggings, was zusätzliche CloudTrail-Gebühren verursacht. Die vollständige Klassifizierung der Event-Typen findest du in der IAM-Aktionsreferenz und Konfigurationsdetails in der AWS CloudTrail-Dokumentation.
Jede Antwort enthält zwei Request-IDs in den Response-Headern:
x-amzn-requestid): Die primäre ID, indiziert in CloudTrail. Verwende diese, wenn du Anfragen über AWS-Tools untersuchst oder den AWS-Support kontaktierst.request-id): Die sekundäre ID. Verwende diese, wenn du den Anthropic-Support kontaktierst.from anthropic import AnthropicAWS
client = AnthropicAWS()
response = client.messages.with_raw_response.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(response.headers.get("x-amzn-requestid")) # AWS request ID
print(response.headers.get("request-id")) # Anthropic request ID
message = response.parse()
print(message.content)Anthropic empfiehlt, deine Aktivitäten mindestens auf rollierender 30-Tage-Basis zu protokollieren, um Nutzungsmuster zu verstehen und mögliche Probleme zu untersuchen.
AWS CloudTrail wird innerhalb deines AWS-Kontos konfiguriert. Das Aktivieren des Loggings gewährt AWS oder Anthropic keinen Zugriff auf deine Inhalte über das hinaus, was für die Abrechnung und den Betrieb des Dienstes erforderlich ist.
Wenn du derzeit Claude auf Bedrock verwendest, erfordert die Migration zu Claude Platform on AWS Änderungen in deiner gesamten Integration. Die SigV4-Signierung wird weiterhin unterstützt, aber der Signierungskontext, die Basis-URL, das API-Format, die Modell-IDs, der SDK-Client und das Paket, das Streaming-Format, die Request-Header und die Regionsverfügbarkeit ändern sich alle. Die folgende Tabelle fasst die Unterschiede zusammen.
Der Migrationsaufwand hängt davon ab, von welcher Bedrock-Integration du kommst. Die folgende Tabelle zeigt sowohl die aktuelle Bedrock-Integration (Messages API unter bedrock-mantle.{region}.api.aws) als auch die Legacy-InvokeModel-Integration.
| Aspekt | Von Claude in Amazon Bedrock | Von Amazon Bedrock (Legacy) | Zu Claude Platform on AWS |
|---|---|---|---|
| Basis-URL | bedrock-mantle.{region}.api.aws | bedrock-runtime.{region}.amazonaws.com | aws-external-anthropic.{region}.api.aws |
| API-Format | Messages API unter /anthropic/v1/messages | Bedrock Converse / InvokeModel | Claude API (/v1/{endpoint}) |
| Modell-IDs | anthropic.claude-opus-4-6 | anthropic.claude-opus-4-6-v1 (mit optionalem us./global.-Präfix) | claude-opus-4-6 |
| SDK-Client | AnthropicBedrockMantle | AnthropicBedrock / Bedrock SDK | Plattformspezifischer Client (siehe SDK installieren), in Beta |
| SDK-Paket | anthropic[bedrock], @anthropic-ai/bedrock-sdk und andere | anthropic[bedrock], @anthropic-ai/bedrock-sdk oder AWS SDK | anthropic[aws], @anthropic-ai/aws-sdk und andere (siehe SDK installieren) |
| SigV4-Servicename | bedrock-mantle | bedrock | aws-external-anthropic |
| Streaming-Format | SSE | AWS EventStream | SSE (wie Claude API) |
| Workspace-Header | Nicht anwendbar | Nicht anwendbar | anthropic-workspace-id erforderlich |
| Regionsverfügbarkeit | Siehe Amazon Bedrock-Regionen | Siehe Amazon Bedrock-Regionen | Alle kommerziellen AWS-Regionen |
Wenn du die aktuelle Bedrock-Integration verwendest, entspricht das Request-Body-Format bereits der Messages API; die Änderungen betreffen die Basis-URL, den SigV4-Servicenamen, die Modell-IDs und das Hinzufügen des anthropic-workspace-id-Headers. Wenn du die Legacy-InvokeModel- oder Converse-API verwendest, musst du außerdem die Request- und Response-Strukturen in das Messages-API-Format umschreiben. Siehe Claude auf Amazon Bedrock (Legacy) für die Zuordnung der Request-Strukturen.
anthropic-beta-Header (siehe Feature-Einschränkungen)Aktiviere zuerst die Outbound Web Identity Federation. Wenn dein AWS-Konto Claude Platform on AWS bisher nicht verwendet hat, musst du die Outbound Web Identity Federation aktivieren – einmal pro Konto –, bevor du Anfragen stellst. Ohne diesen Schritt schlagen alle Anfragen mit einem Federation-Fehler fehl (siehe Outbound Web Identity Federation aktivieren für den genauen Fehler und die Behebung). Dieser Schritt ist für Bedrock nicht erforderlich.
Zero Data Retention (ZDR) ist bei Claude Platform on AWS Opt-in. Bei Bedrock ist AWS der Datenverarbeiter und Anthropic speichert keine Inferenz-Eingaben oder -Ausgaben; Anthropics ZDR-Programm gilt dort nicht. Bei Claude Platform on AWS verarbeitet Anthropic Inferenzdaten als unabhängiger Datenverarbeiter, und ZDR folgt dem Modell der First-Party-Claude-API: Es ist auf Anfrage über deinen Anthropic-Ansprechpartner verfügbar. Bestätige die ZDR-Registrierung, bevor du Produktions-Workloads migrierst, die von Garantien zur Datenspeicherung abhängen.
Claude Platform on AWS ist für die Zugriffskontrolle in AWS IAM integriert. Du gewährst oder verweigerst den Zugriff auf bestimmte API-Aktionen für bestimmte Workspaces mithilfe der standardmäßigen IAM-Richtliniensyntax.
Der SigV4-Servicename und IAM-Aktions-Namespace ist aws-external-anthropic. Aktionen folgen dem Muster aws-external-anthropic:<Action> (zum Beispiel aws-external-anthropic:CreateInference).
Die folgende Richtlinie erlaubt Echtzeit-Inferenz und blockiert gleichzeitig die Batch-Verarbeitung:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-external-anthropic:CreateInference",
"aws-external-anthropic:CountTokens",
"aws-external-anthropic:GetModel",
"aws-external-anthropic:ListModels",
"aws-external-anthropic:GetWorkspace"
],
"Resource": "arn:aws:aws-external-anthropic:*:*:workspace/*"
},
{
"Effect": "Allow",
"Action": "aws-external-anthropic:ListWorkspaces",
"Resource": "*"
},
{
"Effect": "Deny",
"Action": [
"aws-external-anthropic:CreateBatchInference",
"aws-external-anthropic:GetBatchInference",
"aws-external-anthropic:ListBatchInferences"
],
"Resource": "*"
}
]
}Die Aktion GetBatchInference autorisiert sowohl die Batch-Metadaten-Route als auch die Batch-Ergebnis-Route. Wenn du sie verweigerst, werden beide Lesevorgänge blockiert. Eine reine Deny-Richtlinie, die für ZDR-sensible Workloads geeignet ist, findest du unter Feature-Sperrung für einen ZDR-sensiblen Workspace.
ListWorkspaces ist kontobezogen und erscheint daher in einem separaten Allow-Statement mit "Resource": "*". Die Angabe einer Workspace-ARN bei einer kontobezogenen Aktion hat keine Wirkung (siehe Provisioning-Automatisierung).
Diese Richtlinie setzt AWS-SigV4-Authentifizierung voraus. Wenn sich der Principal mit einem API-Key authentifiziert, füge außerdem aws-external-anthropic:CallWithBearerToken zum Allow-Statement mit "Resource": "*" hinzu. CallWithBearerToken ist eine routenlose Aktion auf Authentifizierungsebene, die nicht an eine Workspace-ARN gebunden ist. Siehe Workspace-Isolation pro Kunde für das Zwei-Statement-Muster.
AWS stellt fünf verwaltete Richtlinien bereit (AnthropicFullAccess, AnthropicReadOnlyAccess, AnthropicInferenceAccess, AnthropicLimitedAccess und AnthropicSelfHostedEnvironmentAccess) für gängige Zugriffsmuster. Die Aktionen, die jede Richtlinie gewährt, die vollständige Liste der IAM-Aktionen, die Route-zu-Aktion-Zuordnung und zusätzliche Richtlinienbeispiele findest du unter IAM-Aktionen für Claude Platform on AWS.
Was this page helpful?