Claude Platform auf AWS

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.



Wie die Plattformintegration funktioniert

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.

Claude Platform on AWS hat folgende betriebliche Eigenschaften: Daten befinden sich möglicherweise nicht in AWS, Inferenz kann an die primäre Cloud von Anthropic weitergeleitet werden, und Subservices können sich ohne Vorankündigung ändern. 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.



Claude Platform on AWS vs. Amazon Bedrock

Beide Angebote ermöglichen dir die Nutzung von Claude über AWS, unterscheiden sich jedoch in Architektur, API-Oberfläche und Feature-Verfügbarkeit.

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 die AWS als alleinigen Datenverarbeiter benötigen, sollten Claude in Amazon Bedrock verwenden. Bedrock läuft vollständig auf AWS-kontrollierter Infrastruktur mit AWS als betreibender Partei.

Welches Angebot nutzt du? Claude ist über mehrere unterschiedliche Produkte verfügbar:

• Claude Platform on AWS (diese Seite): Die Claude API-Plattform, abgerechnet über AWS Marketplace. Verwaltet in der Claude Console und der AWS Console.
• Claude in Amazon Bedrock: Ein AWS-nativer Service. Verwaltet in der Amazon Bedrock-Konsole und als AWS-Service-Nutzung abgerechnet.
• Claude Enterprise über AWS Marketplace bezogen: Ein claude.ai-Plan (das Claude-Chat-Produkt), keine API-Plattform. Verwaltet unter claude.ai, und das Konto- und Migrationsverhalten unterscheidet sich von dem, was diese Seite beschreibt. Siehe das Claude Help Center.
• Direkte Anthropic-Konten: Die First-Party Claude API und claude.ai-Pläne, abgerechnet von Anthropic. Verwaltet in der Claude Console und unter claude.ai.



Dein Konto einrichten

Die Einrichtung von Claude Platform on AWS erfolgt in vier Phasen: Melde dich auf der Service-Seite der AWS Console an, schließe die Einrichtung deiner Anthropic-Organisation ab, notiere deine Workspace-ID und melde dich bei der Claude Console an.



Wechsel von einer bestehenden Anthropic-Organisation

Die Anmeldung für Claude Platform on AWS stellt immer eine neue Anthropic-Organisation bereit, die mit deinem AWS-Konto verknüpft ist. Es gibt keine In-Place-Konvertierung: Eine bestehende Organisation, wie etwa eine First-Party Claude API-Organisation, kann nicht zu einer Claude Platform on AWS-Organisation werden.

Plane einen Wechsel von einer bestehenden Organisation als Umstellung auf eine neue:

• Erstelle zuerst die neue Organisation. Melde dich über die AWS Console an (siehe Dein Konto einrichten). Wenn dein Wechsel ein Private Offer beinhaltet, schließe die Anmeldung ab, bevor das Angebot angenommen wird: Rabatte gelten ab der Annahme, nicht rückwirkend. Siehe Private Offers.
• Erstelle Zugriff und Konfiguration neu. API-Keys, Workspaces und Claude Console-Einstellungen werden nicht aus einer bestehenden Organisation übernommen. Erstelle Workspaces in der neuen Organisation und stelle deine Anwendungen auf Claude Platform on AWS-Authentifizierung um.
• Aktualisiere deine Integration. Claude Platform on AWS stellt die Claude API (/v1/{endpoint}) bereit, sodass Request- und Response-Formate gegenüber der First-Party Claude API unverändert sind. Was sich ändert, ist die Basis-URL, die Authentifizierungsmethode und der erforderliche anthropic-workspace-id-Header; siehe Anfragen stellen. Einige Plattform-Features unterscheiden sich; siehe Nicht unterstützte Features.
• Stelle nach deinem eigenen Zeitplan um. Die neue Organisation ist unabhängig von deiner bestehenden, und beide können parallel Traffic bedienen. Eine harte Umstellung ist nicht nötig: Verlagere Workloads schrittweise, bis dein gesamter Traffic auf der neuen Organisation läuft.

Sobald die neue Organisation läuft, konzentrieren sich die Unterschiede auf Abrechnung und Authentifizierung, die über AWS abgewickelt werden:

• Abrechnung wechselt zu AWS Marketplace: Die Nutzung wird in Claude Consumption Units statt in vorausbezahlten Credits abgerechnet (siehe Abrechnung), und Ausgabenlimits werden auf der Billing-Seite statt auf der Limits-Seite verwaltet (siehe Ausgabenlimits). Während der Umstellung bleibt die Abrechnung getrennt: Die bestehende Organisation wird weiterhin wie bisher abgerechnet.
• Authentifizierung und Zugriff wechseln zu AWS: Anfragen authentifizieren sich mit AWS-Anmeldedaten oder mit API-Keys, die in der AWS Console generiert wurden, nicht in der Claude Console (siehe Authentifizierung). Die Organisationsmitgliedschaft wird über AWS IAM statt über die Claude Console verwaltet (siehe Verfügbare Seiten), und die Client-SDKs von Anthropic stellen plattformspezifische Client-Klassen bereit (siehe Ein SDK installieren).
• Die tägliche API-Nutzung funktioniert wie bei der First-Party Claude API, außer wo in den Feature-Einschränkungen vermerkt. Bevor du Produktions-Traffic verlagerst, überprüfe deine Ratenlimits: Neue Organisationen werden auf die Start-Stufe gesetzt, und Limit-Erhöhungen laufen über deinen Anthropic-Ansprechpartner (siehe Ratenlimits und Kontingente).

Für Claude Enterprise (claude.ai)-Organisationen, die sich anders verhalten, siehe den Angebotsvergleich.



Fehlerbehebung bei der Kontoeinrichtung

• „Sign-up failed: Failed to enable OutboundWebIdentityFederation": Wenn du dieses Banner beim ersten Absenden siehst, wähle erneut Continue. Die IAM-Aktivierung kann einen Moment dauern, bis sie wirksam wird.
• Keine Fortschrittsanzeige während der Anmeldung: Die Anmeldung dauert einige Minuten. Die Seite zeigt ein statisches Banner Sign-up in progress ohne Fortschrittsbalken, während AWS dein Konto bereitstellt.
• „Signed in as a different account" nach dem Folgen des Einrichtungslinks: Wähle Log out and continue. Die Seite authentifiziert dich erneut mit der von dir eingegebenen E-Mail-Adresse.
• „Not found"-Meldung während der Anmeldung: Diese Meldung kann kurz während der Weiterleitung erscheinen. Du kannst sie schließen.
• Usage-Seite zeigt keine Daten nach deinem ersten API-Aufruf: Nutzungsdaten können einige Minuten brauchen, bis sie in der Claude Console erscheinen.
• „Outbound web identity federation is disabled" bei deinem ersten API-Aufruf: Aktiviere die Föderation einmal pro Konto. Siehe Outbound Web Identity Federation aktivieren.



Vor dem Ausführen von API-Aufrufen

Stelle sicher, dass du Folgendes hast:

1. Ein aktives AWS-Konto mit einem Abonnement für Claude Platform on AWS (siehe Dein Konto einrichten)
2. Die AWS CLI installiert und konfiguriert
3. Outbound Web Identity Federation aktiviert in deinem AWS-Konto, ein einmaliger Einrichtungsschritt (siehe Outbound Web Identity Federation aktivieren)
4. Deine Workspace-ID (siehe Deine Workspace-ID ermitteln)
5. IAM-Berechtigung zum Aufrufen der API: die Aktion aws-external-anthropic:CreateInference für deinen Workspace, plus aws-external-anthropic:CallWithBearerToken, wenn du dich mit einem API-Key authentifizierst (siehe IAM-Richtlinien)



Outbound Web Identity Federation aktivieren

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-federation

Wenn 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-info



Deine Workspace-ID ermitteln

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 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 region

Die 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.



Authentifizierung

Claude Platform on AWS unterstützt zwei Authentifizierungsmethoden: AWS IAM mit Signature Version 4 (SigV4) Request-Signierung (primär) und API-Key-Authentifizierung. Beide verwenden dieselbe Basis-URL und dasselbe Anfrageformat.



SigV4-Authentifizierung

SigV4 ist der Enterprise-native Weg und integriert sich in deine bestehenden AWS IAM-Richtlinien, -Rollen und -Auditing. Konfiguriere AWS-Anmeldedaten mit einer beliebigen Methode, die von der AWS Default Credential Provider Chain unterstützt wird:

• Umgebungsvariablen (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN)
• Shared-Credentials-Datei (~/.aws/credentials)
• Shared-Config-Datei (~/.aws/config) einschließlich SSO und credential_process
• Web Identity (AWS_WEB_IDENTITY_TOKEN_FILE und AWS_ROLE_ARN) für IRSA und GitHub Actions
• ECS-Container-Anmeldedaten
• EC2 Instance Metadata Service (IMDS)

Überprüfe, ob deine Anmeldedaten funktionieren:

aws sts get-caller-identity



API-Key-Authentifizierung

Für einfachere Integrationspfade (lokale Entwicklung und Skripte) kannst du dich mit einem API-Key statt mit 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.



Kurzlebige API-Keys

Für Workloads, die Anmeldedaten 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-Anmeldedaten, 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-Anmeldedaten ü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 das Minimum aus deiner angeforderten Dauer, dem Ablauf deiner AWS-Anmeldedaten 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-Anmeldedaten, 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-Anmeldedaten 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.



Anmeldedaten-Priorität

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, und C# und Java verwenden die Property- oder Builder-Idiome der jeweiligen Sprache.

1. apiKey-Konstruktorargument → x-api-key-Header
2. awsAccessKey + awsSecretAccessKey-Konstruktorargumente → AWS SigV4
3. awsProfile-Konstruktorargument → AWS SigV4 mit benanntem Profil
4. ANTHROPIC_AWS_API_KEY-Umgebungsvariable → x-api-key-Header
5. Default AWS Credential Provider Chain → AWS SigV4



Regionsauflösung

Der Client liest AWS_REGION aus der Umgebung, wenn aws_region/awsRegion nicht an den Konstruktor übergeben wird, und greift 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.



Ein SDK installieren

Die Client-SDKs von Anthropic unterstützen Claude Platform on AWS. Jedes SDK stellt eine plattformspezifische Client-Klasse bereit, die SigV4-Signierung, regionsbasierte Basis-URL-Konstruktion und den anthropic-workspace-id-Header handhabt.

pip install -U "anthropic[aws]"



Verfügbare Modelle

Die folgenden Modelle sind auf Claude Platform on AWS verfügbar:

Modell-IDs sind identisch mit der First-Party Claude API. Es gibt keine Bedrock-artigen ARNs oder anthropic.-Präfixe.

Neue Modelle werden in der Regel am selben Tag auf Claude Platform on AWS eingeführt wie auf der First-Party Claude API.



Anfragen stellen

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.

Bevor du diese Beispiele ausführst, schließe die Schritte in Vor dem Ausführen von API-Aufrufen ab.

from anthropic import AnthropicAWS

client = AnthropicAWS()

message = client.messages.create(
    model="claude-sonnet-5",
    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 eines von beiden nicht aufgelöst werden kann.

Der --aws-sigv4-Wert folgt dem Format aws:amz:<region>:<service>. Der SigV4-Service-Name 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 statt einer spezifischen Diagnose.



Kontextfenster

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.



Feature-Unterstützung

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 vermerkt):

• Feature-Zugriff: Da Anthropic beide Plattformen betreibt, werden die meisten neuen Features und Beta-Header auf Claude Platform on AWS ohne separaten Integrationsschritt verfügbar. Siehe Feature-Einschränkungen für Ausnahmen.
• Beta-Features: Übergib den Standard-anthropic-beta-Header, um auf Beta-Features zuzugreifen, genau wie bei der Claude API.
• Agent Skills: Verwende vorgefertigte und benutzerdefinierte Agent Skills mit demselben container.skills-Parameter und denselben Beta-Headern wie bei der Claude API. Alle vorgefertigten Skills (PowerPoint, Excel, Word, PDF) funktionieren sofort.
• Code-Ausführung: Führe Code in der von Anthropic verwalteten Sandbox mit dem Code-Ausführungs-Tool aus.
• Tool-Nutzung: Computer Use und alle anderen Tool-Nutzungs-Funktionen sind verfügbar.
• Erweitertes Denken: Aktiviere erweitertes Denken mit denselben Parametern wie bei der Claude API.
• Streaming: Vollständige SSE-Streaming-Unterstützung für Echtzeit-Antworten.
• Batch-Verarbeitung: Sende Batch-Anfragen für Workloads mit hohem Durchsatz.
• Prompt-Caching: Cache Tools, System-Prompts und Nachrichtenverlauf, um Latenz und Kosten zu reduzieren. Alle Prompt-Caching-Funktionen (5-Minuten-TTL, 1-Stunden-TTL und automatisches Caching) sind verfügbar.
• Files API: Lade Dateien hoch und referenziere sie über Anfragen hinweg.
• Customer-managed encryption keys (CMEK): CMEK ist nur mit AWS KMS-Keys verfügbar. Google Cloud KMS- und Azure Key Vault-Keys können nicht registriert werden. Erstelle, validiere und verknüpfe Keys in der Claude Console. Die external_keys-Admin-API-Endpunkte sind derzeit nicht verfügbar. Der Key muss sich in derselben AWS-Region befinden wie der Workspace, mit dem er verknüpft ist.
• Compliance API: Die Compliance API ist verfügbar. Der Zugriff wird über AWS IAM autorisiert.

Siehe die Vergleichstabelle für Unterschiede in der Feature-Verfügbarkeit gegenüber Amazon Bedrock.



Claude Managed Agents

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:

• Reauthentifizierung autonomer Sessions: Eine Session kann bis zu 6 Stunden autonom laufen, ohne User-Events. Nach 6 Stunden erfordert die Session eine Reauthentifizierung, bevor sie fortgesetzt wird. Um zu reauthentifizieren, sende ein beliebiges User-Role-Event an die Session (siehe Events und Streaming). First-Party Claude Managed Agents hat kein Laufzeitlimit für autonome Sessions.



Nicht unterstützte Features

Die folgenden Funktionen sind derzeit auf Claude Platform on AWS nicht verfügbar:

• HIPAA-Readiness: Das HIPAA-ready-Programm von Anthropic ist nicht verfügbar. Siehe API und Datenaufbewahrung.

• Admin API: Workspace-Endpunkte (Erstellen, Abrufen, Auflisten, Aktualisieren und Archivieren unter /v1/organizations/workspaces) sind verfügbar. Andere Admin-API-Endpunkte (Organisationsmitglieder, Workspace-Mitglieder, Einladungen, API-Keys, Nutzungsberichte, Kostenberichte, Ratenlimit-Berichte und externe Keys) sind derzeit nicht verfügbar. Verwalte CMEK-Keys stattdessen in der Claude Console. Sieh dir Nutzungs- und Kostendaten stattdessen in der Claude Console an. AWS IAM verwaltet die Organisationsmitgliedschaft.
• Workspace-Mitgliederverwaltung: Das Hinzufügen oder Entfernen von Benutzern zu einzelnen Workspaces ist nicht verfügbar. AWS IAM-Richtlinien auf Workspace-ARNs steuern den Zugriff.
• Claude Code-Workspace und Analytics API: Der Claude Code-Workspace mit automatischen Ratenlimits ist nicht verfügbar. Claude Code-Nutzung erscheint in der allgemeinen Nutzungsansicht statt auf einem dedizierten Bildschirm.
• OAuth-Authentifizierung: Nicht unterstützt. Verwende SigV4- oder API-Key-Authentifizierung.
• Fast Mode: Nicht verfügbar auf Claude Platform on AWS.
• OpenAI-kompatible API-Endpunkte: Nicht verfügbar auf Claude Platform on AWS.
• MCP-Tunnel: Nur MCP-Server, die über das öffentliche Internet erreichbar sind, werden unterstützt.



Datenresidenz

Claude Platform on AWS unterstützt die folgenden Inferenz-Geografien:

• US: Inferenz bleibt innerhalb von US-Rechenzentren. Ein Preismultiplikator von 1,1x gilt.
• Global: Inferenz kann an jedes von Anthropic betriebene Rechenzentrum weltweit weitergeleitet werden. Standardpreise gelten.

Setze die Inferenz-Geografie pro Anfrage mit dem Parameter inference_geo:

from anthropic import AnthropicAWS

client = AnthropicAWS()
message = client.messages.create(
    model="claude-sonnet-5",
    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-Steuerungen 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.



Workspaces

Inferenz- und Ressourcenanfragen auf Claude Platform on AWS zielen auf einen Workspace ab. Du übergibst die ID des Workspace im Header anthropic-workspace-id 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.



Workspace-Scoping

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 in der Claude Console Aufschlüsselungen pro Region 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 des Workspace-ARN. Das Ressourcensegment des ARN ist dieselbe ID mit dem Präfix wrkspc_, die du im Header anthropic-workspace-id ü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_01AbCdEf23GhIj

Siehe IAM-Richtlinien für Richtlinienbeispiele.



Workspaces verwalten

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.



Verwendung der Claude Console

Claude Platform on AWS verwendet die standardmäßige Claude Console unter platform.claude.com. Wenn du dich über die AWS Console anmeldest, erscheint unten links in der Seitenleiste der Claude Console ein Indikator Account managed by AWS, und die Console ist auf deine Claude Platform on AWS-Organisation beschränkt. Sie bietet Nutzungsanalysen, Kostenaufschlüsselungen, Einblick in Ratenlimits, Workspace-Übersicht sowie Seiten zur Verwaltung von Dateien, Agent Skills, Batch-Jobs und Claude Managed Agents-Ressourcen (Agents, Sessions, Environments, Credential Vaults, Memory Stores und Webhooks).



Anmelden

Der Zugriff auf die Claude Console erfolgt föderiert über AWS IAM. Siehe Dein Konto einrichten für den vollständigen Ablauf der erstmaligen Anmeldung. Kurz gefasst:

1. Nimm eine IAM-Rolle mit der Berechtigung aws-external-anthropic:AssumeConsole an. Siehe IAM-Aktionen für Claude Platform on AWS.
2. Navigiere zur Seite Claude Platform on AWS in der AWS Console.
3. Wähle Open Claude Console. Die AWS Console stellt ein JWT aus und leitet dich zu platform.claude.com weiter.
4. Bei der ersten Anmeldung wirst du nach einer E-Mail-Adresse gefragt. Gib deine geschäftliche E-Mail-Adresse ein. Die Plattform stellt deinen Claude Console-Benutzer just-in-time bereit.

Es stehen zwei Claude Console-Rollen zur Verfügung: 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.



Verfügbare Seiten

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 markiert sind, lesen Metadaten auf Organisationsebene direkt von Anthropic und umgehen IAM-Aktionsprüfungen.



Organisationen wechseln

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.



Ratenlimits und Kontingente

Organisationen auf Claude Platform on AWS werden in den Start-Tier eingestuft. Anthropic verwaltet Ratenlimits direkt, nicht über AWS-Kontingentsysteme.

Organisationen auf Claude Platform on AWS wechseln nicht automatisch zwischen Nutzungs-Tiers. Die nutzungsbasierte Tier-Hochstufung gilt für First-Party-Claude-API-Organisationen, nicht für Organisationen, die über AWS Marketplace abgerechnet werden. Der Self-Service-Ablauf Request rate limit increase in der Claude Console ist ebenfalls nicht verfügbar: Die Limits-Seite verweist dich stattdessen an deinen Anthropic-Ansprechpartner.

Um höhere Limits anzufordern, kontaktiere deinen Anthropic-Ansprechpartner oder den Support. Füge deiner Anfrage Folgendes bei:

• Die Modelle, für die du eine Erhöhung benötigst
• Spitzenwerte für Input-Token pro Minute und Output-Token pro Minute für jedes Modell (keine Tagessummen)
• Den ungefähren Anteil deines Inputs, der aus gecachtem oder wiederholtem Kontext besteht (Cache-Lesevorgänge zählen bei den meisten Modellen nicht zu den Input-Token-Limits; siehe Cache-bewusstes ITPM)

Nutzungs-Tiers sind feste Stufen: Jeder Tier kombiniert Ratenlimits mit einer monatlichen Ausgabenobergrenze, und der Wechsel zu einem höheren Tier erhöht beides. Für Tier-Details und modellspezifische Limits siehe Ratenlimits.



Abrechnung

Claude Platform on AWS rechnet über AWS Marketplace ab. Die Nutzung wird in Claude Consumption Units (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.

Für den CCU-Preis, die Umrechnungsmechanik, die Anwendung von Rabatten und die Token-Preise pro Modell siehe Claude Platform on AWS-Preise.



Ausgabenlimits

Die Nutzungs-Tiers Start, Build und Scale haben jeweils eine monatliche Ausgabenobergrenze; siehe die Ausgabenobergrenzen pro Tier für aktuelle Werte. Die Ausgabenobergrenze und die Ratenlimits gehören zum selben Tier. Um die Obergrenze zu erhöhen, fordere also eine Tier-Erhöhung über deinen Anthropic-Ansprechpartner oder den Support an (siehe Ratenlimits und Kontingente).

Du kannst auch dein eigenes monatliches Ausgabenlimit festlegen, um die Ausgaben deiner Organisation zu begrenzen:

• Ausgabenlimit der Organisation: Gehe zu Settings > Billing in der Claude Console, um ein monatliches Ausgabenlimit festzulegen. Auf Claude Platform on AWS werden Ausgabenlimits auf der Billing-Seite und nicht auf der Limits-Seite verwaltet.
• Workspace-Ausgabenlimits: Lege monatliche Ausgabenlimits für einzelne Workspaces in den Limit-Einstellungen des jeweiligen Workspace fest.

Die von dir festgelegten Ausgabenlimits sind weiche Limits: Die Ausgaben werden zu Listenpreisen berechnet und es kann etwa zwei Stunden dauern, bis die aktuelle Nutzung widergespiegelt wird.



Monitoring und Logging

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. Siehe die IAM-Aktionsreferenz für die vollständige Event-Typ-Klassifizierung und die AWS CloudTrail-Dokumentation für Konfigurationsdetails.



Request-IDs

Jede Antwort enthält zwei Request-IDs in den Response-Headern:

• AWS-Request-ID (x-amzn-requestid): Die primäre ID, indiziert in CloudTrail. Verwende diese, wenn du Anfragen über AWS-Tools untersuchst oder den AWS-Support kontaktierst.
• Anthropic-Request-ID (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-5",
    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 Probleme zu untersuchen.



Migration von Amazon Bedrock

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. Claude Platform on AWS stellt außerdem eine neue Anthropic-Organisation bereit. Die folgende Tabelle fasst die Unterschiede zusammen.



Was sich ändert

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.

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 Headers anthropic-workspace-id. 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 (Opus 4.6 und früher) für die Zuordnung der Request-Struktur.



Was du gewinnst

• In der Regel Zugriff auf neue Modelle und Features am selben Tag (siehe Feature-Einschränkungen)
• Agent Skills für die Dokumentenerstellung (PowerPoint, Excel, Word, PDF)
• Code-Ausführung in Anthropics verwalteter Sandbox
• Beta-Features über den Header anthropic-beta (siehe Feature-Einschränkungen)
• Claude Console für Kontingentübersicht und Nutzungsanalysen
• Direkter Anthropic-Support
• API-Key-Authentifizierung als Alternative zu SigV4 (siehe API-Key-Authentifizierung)



Was gleich bleibt

• AWS-IAM-Authentifizierung (SigV4)
• AWS als rechnungsstellende Partei. Der Abrechnungskanal wechselt vom nativen AWS-Service zu AWS Marketplace (siehe Kommerzielle Überlegungen).
• AWS-Commitment-Abbau



Migrationsfallen



Kommerzielle Überlegungen

• Anthropic-Nutzungsbedingungen: Die Nutzung von Claude Platform on AWS erfordert die Annahme der Commercial Terms of Service und der Usage Policy von Anthropic. Wenn deine Organisation diese noch nicht akzeptiert hat (zum Beispiel, wenn du Claude nur über Bedrock verwendet hast), wirst du während der Kontoeinrichtung dazu aufgefordert. Siehe Dein Konto einrichten.
• Rabatte und Private Offers: Ausgehandelte Rabatte und AWS Marketplace Private Offers werden nicht automatisch zwischen Bedrock und Claude Platform on AWS übertragen. Arbeite mit deinem Anthropic-Ansprechpartner zusammen, um kommerzielle Bedingungen für Claude Platform on AWS einzurichten.



IAM-Richtlinien

Claude Platform on AWS integriert sich mit AWS IAM für die Zugriffskontrolle. Du gewährst oder verweigerst den Zugriff auf bestimmte API-Aktionen für bestimmte Workspaces mit 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).



Beispiel: Batch-Inferenz verweigern

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. Das Verweigern blockiert beide Lesevorgänge. Für eine reine Deny-Richtlinie, die für ZDR-sensible Workloads geeignet ist, siehe Feature-Lockdown für einen ZDR-sensiblen Workspace.



Verwaltete Richtlinien

AWS stellt fünf verwaltete Richtlinien (AnthropicFullAccess, AnthropicReadOnlyAccess, AnthropicInferenceAccess, AnthropicLimitedAccess und AnthropicSelfHostedEnvironmentAccess) für gängige Zugriffsmuster bereit. Für die Aktionen, die jede Richtlinie gewährt, die vollständige Liste der IAM-Aktionen, die Route-zu-Aktion-Zuordnung und zusätzliche Richtlinienbeispiele siehe IAM-Aktionen für Claude Platform on AWS.



Nächste Schritte



Zusätzliche Ressourcen