Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Claude Platform on AWS ist die von Anthropic betriebene Claude API mit AWS-Authentifizierung, IAM-Zugriffskontrolle und AWS Marketplace-Abrechnung. Anfragen erreichen die API von Anthropic direkt, sodass Sie die gleichen Modelle und Funktionen wie die Claude API nach dem gleichen Veröffentlichungsplan erhalten. Sie authentifizieren sich mit AWS-Anmeldedaten oder einem Workspace-API-Schlüssel und zahlen über AWS Marketplace. Verwenden Sie diese Anleitung, um Claude Code auf einen Workspace zu verweisen, den Sie bereits über Claude Platform on AWS bereitgestellt haben. Für das AWS-Abonnement und die Workspace-Einrichtung, die davor kommt, siehe die Claude Platform on AWS-Dokumentation.
Das Abonnement über AWS Marketplace stellt eine neue Anthropic-Organisation bereit, die mit Ihrem AWS-Konto verknüpft ist. Diese Organisation ist separat von jeder Organisation, die Sie bereits bei Anthropic haben, und Anmeldedaten werden nicht zwischen ihnen übertragen. Verwenden Sie die Workspace-ID und API-Schlüssel aus der AWS-verknüpften Organisation, nicht aus einem bereits vorhandenen Claude Console-Konto.

​
Voraussetzungen

Vor der Konfiguration von Claude Code benötigen Sie:
  • Ein aktives Claude Platform on AWS-Abonnement über AWS Marketplace
  • Einen Workspace in Ihrer AWS-verknüpften Anthropic-Organisation mit seiner Workspace-ID
  • Einen IAM-Principal mit Berechtigung zum Aufrufen des Anthropic-Dienstes oder einen API-Schlüssel, der auf den Workspace beschränkt ist
  • AWS-Anmeldedaten in Ihrer Umgebung, in ~/.aws/credentials oder von einer angehängten IAM-Rolle, wenn Sie SigV4-Authentifizierung möchten. Die AWS CLI ist nur für den SSO-Anmeldungsfluss erforderlich.

​
Einrichtung

​
1. AWS-Anmeldedaten konfigurieren

Claude Code unterstützt zwei Authentifizierungsmethoden für Claude Platform on AWS. Wählen Sie die Methode, die zu Ihrer Zugriffsverwaltung passt. Option A: AWS-Anmeldedaten mit SigV4 Claude Code signiert Anfragen mit SigV4 unter Verwendung der Standard-AWS-Anmeldekette: Umgebungsvariablen, gemeinsame Anmeldedaten in ~/.aws/credentials, IAM-Rollen, AWS SSO-Sitzungen und alle anderen Quellen, die das AWS SDK unterstützt. Für die lokale Verwendung melden Sie sich mit der AWS CLI an, bevor Sie Claude Code starten. Das folgende Beispiel verwendet ein SSO-Profil, aber jede Methode, die Anmeldedaten an den Standardorten erzeugt, funktioniert. 
aws sso login --profile my-profile
export AWS_PROFILE=my-profile
Für CI und Automatisierung geben Sie dem Runner eine IAM-Rolle mit Berechtigung zum Aufrufen des Anthropic-Dienstes und setzen Sie AWS_REGION. Die Anmeldekette nimmt die Rolle automatisch auf. Wenn Ihre SSO-Anmeldedaten während einer Sitzung ablaufen, konfigurieren Sie awsAuthRefresh, damit Claude Code Ihren Anmeldungsbefehl erneut ausführt und erneut versucht, anstatt fehlzuschlagen. Fügen Sie den Befehl zu Ihrer settings.json hinzu: 
{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}
Option B: Workspace-API-Schlüssel Ein Workspace-API-Schlüssel ist ein langlebiges Geheimnis, das nützlich ist, wenn Sie keine verbundenen AWS-Anmeldedaten verwalten möchten. Generieren Sie einen in der AWS Console unter Claude Platform on AWS → API keys und setzen Sie ihn als ANTHROPIC_AWS_API_KEY: 
export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx
Der Schlüssel wird als x-api-key gesendet und hat Vorrang vor SigV4, sodass alle AWS-Anmeldedaten in Ihrer Umgebung ignoriert werden. API-Schlüssel aus einer separaten Claude Console-Organisation funktionieren hier nicht. Behandeln Sie Workspace-API-Schlüssel wie jede andere Produktionsanmeldedaten. Der Benutzereinstellungsdatei env-Block ist eine praktische Möglichkeit, den Schlüssel auf Ihrem Computer zu beschränken, ohne ihn global zu exportieren.
Die Befehle /login und /logout ändern die Claude Platform on AWS-Authentifizierung nicht. Die Authentifizierung erfolgt über Ihre AWS-Anmeldedaten oder Ihren Workspace-API-Schlüssel, nicht über ein Claude.ai-Abonnement.

​
2. Claude Code konfigurieren

Setzen Sie die Umgebungsvariablen, die Claude Code durch Claude Platform on AWS anstelle der Standard-Anthropic API leiten. 
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export AWS_REGION=us-east-1
ANTHROPIC_AWS_WORKSPACE_ID ist erforderlich und wird bei jeder Anfrage als anthropic-workspace-id-Header gesendet. Die Basis-URL wird aus AWS_REGION als https://aws-external-anthropic.{region}.api.aws berechnet. Um die URL direkt zu überschreiben, setzen Sie ANTHROPIC_AWS_BASE_URL. Claude Platform on AWS ist optional, auch wenn AWS-Anmeldedaten in Ihrer Umgebung vorhanden sind. Bedrock und Foundry haben Vorrang beim Provider-Routing, daher heben Sie CLAUDE_CODE_USE_BEDROCK und CLAUDE_CODE_USE_FOUNDRY auf, wenn sie gesetzt sind.

​
3. Modellversionen anheften

Claude Platform on AWS verwendet die gleichen Modell-IDs wie die direkte Claude API. Die Standard-Aliase opus, sonnet und haiku werden zu den neuesten Versionen aufgelöst, die in Ihrem Workspace verfügbar sind. Wenn Sie Claude Code für ein Team bereitstellen, heften Sie die Modell-IDs explizit an, damit eine neue Version nicht alle auf einmal verschiebt: 
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
Die vollständige Liste der Modell-IDs und Aliase finden Sie unter Modellübersicht. Für andere modellbezogene Variablen siehe Modellkonfiguration. Prompt Caching ist automatisch aktiviert. 1-Stunden-Cache-Schreibvorgänge werden mit einer höheren Rate als 5-Minuten-Schreibvorgänge abgerechnet. Um statt des 5-Minuten-Standards eine 1-Stunden-Cache-TTL anzufordern, setzen Sie ENABLE_PROMPT_CACHING_1H=1.

​
Agent SDK verwenden

Das Agent SDK liest die gleichen Umgebungsvariablen wie die CLI, sodass jedes Programm, das den Claude Code-Unterprozess erzeugt, Claude Platform on AWS anvisieren kann, indem es CLAUDE_CODE_USE_ANTHROPIC_AWS, ANTHROPIC_AWS_WORKSPACE_ID und entweder ANTHROPIC_AWS_API_KEY oder AWS-Anmeldedaten vor dem Aufruf exportiert. 
import { query } from "@anthropic-ai/claude-agent-sdk";

process.env.CLAUDE_CODE_USE_ANTHROPIC_AWS = "1";
process.env.ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN";
process.env.AWS_REGION = "us-east-1";

for await (const msg of query({ prompt: "What's in this repo?" })) {
  console.log(msg);
}
Dieses Beispiel basiert auf der Umgebungs-AWS-Anmeldekette für SigV4. Um sich stattdessen mit einem Workspace-API-Schlüssel zu authentifizieren, setzen Sie ANTHROPIC_AWS_API_KEY auf die gleiche Weise. Für die breitere Agent SDK-Oberfläche siehe Agent SDK-Übersicht.

​
Durch einen Unternehmens-Proxy leiten

Um Datenverkehr durch einen Proxy oder LLM-Gateway zu leiten, setzen Sie ANTHROPIC_AWS_BASE_URL auf die Adresse des Proxys. Claude Code sendet Anfragen an diese URL mit den gleichen Workspace- und Authentifizierungsheadern, sodass jedes Gateway, das sie unverändert weiterleitet, funktioniert. 
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com
Wenn Ihr Gateway Anfragen selbst signiert, setzen Sie CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1, damit Claude Code unsignierte Anfragen sendet und das Gateway SigV4-Header hinzufügt, bevor es an AWS weitergeleitet wird. Wenn das Gateway sein eigenes Token benötigt, setzen Sie es in ANTHROPIC_AUTH_TOKEN. 
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

​
Fehlerbehebung

Führen Sie /status aus, um den aufgelösten Provider und alle explizit konfigurierten Workspace-ID, Region, Basis-URL-Überschreibung und Auth-Skip-Einstellung zu sehen. Dies ist der schnellste Weg, um zu bestätigen, dass Claude Code überhaupt auf Claude Platform on AWS abzielt.

​
403 Forbidden oder AccessDenied bei jeder Anfrage

Der IAM-Principal, den Claude Code aufgelöst hat, hat wahrscheinlich keine Berechtigung zum Aufrufen des Anthropic-Dienstes in Ihrem Workspace. Überprüfen Sie die Rolle, die an Ihr AWS-Profil oder den Runner angehängt ist, der Claude Code gestartet hat, und überprüfen Sie, ob sie die aws-external-anthropic-Aktionen hat, die in der IAM-Aktionsreferenz dokumentiert sind. Wenn Sie ANTHROPIC_AWS_API_KEY setzen, hat der Schlüssel Vorrang vor SigV4 und ein veralteter Schlüssel erzeugt den gleichen Fehler. Generieren Sie den Schlüssel in der AWS Console unter Claude Platform on AWS → API keys neu oder heben Sie die Variable auf, um auf Ihre AWS-Anmeldedaten zurückzugreifen.

​
Anfragen schlagen mit einem fehlenden Workspace-Fehler fehl

ANTHROPIC_AWS_WORKSPACE_ID ist wahrscheinlich nicht gesetzt oder leer. Jede Claude Platform on AWS-Anfrage muss die Workspace-ID enthalten. Sie wird nicht durch Ihre AWS-Anmeldedaten impliziert. Finden Sie die ID unter Workspaces auf der AWS Console-Serviceseite und exportieren Sie sie, bevor Sie Claude Code starten.

​
Anfragen gehen immer noch an api.anthropic.com

CLAUDE_CODE_USE_ANTHROPIC_AWS ist wahrscheinlich nicht gesetzt oder auf einen Wert gesetzt, der nicht als wahr analysiert wird. Setzen Sie ihn auf 1 und führen Sie /status aus, um den aufgelösten Provider zu bestätigen. Wenn CLAUDE_CODE_USE_BEDROCK oder CLAUDE_CODE_USE_FOUNDRY auch gesetzt ist, haben diese Vorrang vor Claude Platform on AWS.

​
Zusätzliche Ressourcen

Das Claude Platform on AWS-Abonnement, der Workspace und die IAM-Einrichtung, die vor der Konfiguration von Claude Code kommt, werden in der Plattformdokumentation behandelt: