​
Voraussetzungen

Bevor Sie Claude Code mit Bedrock konfigurieren, stellen Sie sicher, dass Sie haben:

  • Ein AWS-Konto mit aktiviertem Bedrock-Zugang
  • Zugang zu gewünschten Claude-Modellen (z.B. Claude Sonnet 4) in Bedrock
  • AWS CLI installiert und konfiguriert (optional - nur erforderlich, wenn Sie keinen anderen Mechanismus zum Abrufen von Anmeldedaten haben)
  • Entsprechende IAM-Berechtigungen

​
Setup

​
1. Modellzugang aktivieren

Stellen Sie zunächst sicher, dass Sie Zugang zu den erforderlichen Claude-Modellen in Ihrem AWS-Konto haben:

  1. Navigieren Sie zur Amazon Bedrock-Konsole
  2. Gehen Sie zu Modellzugang in der linken Navigation
  3. Beantragen Sie Zugang zu gewünschten Claude-Modellen (z.B. Claude Sonnet 4)
  4. Warten Sie auf die Genehmigung (normalerweise sofort für die meisten Regionen)

​
2. AWS-Anmeldedaten konfigurieren

Claude Code verwendet die Standard-AWS-SDK-Anmeldedatenkette. Richten Sie Ihre Anmeldedaten mit einer dieser Methoden ein:

Claude Code unterstützt derzeit keine dynamische Anmeldedatenverwaltung (wie das automatische Aufrufen von aws sts assume-role). Sie müssen aws configure, aws sso login ausführen oder die AWS_-Umgebungsvariablen selbst setzen.

Option A: AWS CLI-Konfiguration

aws configure

Option B: Umgebungsvariablen (Zugriffsschlüssel)

export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token

Option C: Umgebungsvariablen (SSO-Profil)

aws sso login --profile=<your-profile-name>

export AWS_PROFILE=your-profile-name

​
3. Claude Code konfigurieren

Setzen Sie die folgenden Umgebungsvariablen, um Bedrock zu aktivieren:

# Bedrock-Integration aktivieren
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # oder Ihre bevorzugte Region

AWS_REGION ist eine erforderliche Umgebungsvariable. Claude Code liest diese Einstellung nicht aus der .aws-Konfigurationsdatei.

​
4. Modellkonfiguration

Claude Code verwendet diese Standardmodelle für Bedrock:

ModelltypStandardwert
Primärmodellus.anthropic.claude-3-7-sonnet-20250219-v1:0
Kleines/schnelles Modellus.anthropic.claude-3-5-haiku-20241022-v1:0

Um Modelle anzupassen, verwenden Sie eine dieser Methoden:

# Verwendung der Inferenzprofil-ID
export ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Verwendung der Anwendungsinferenzprofil-ARN
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

​
IAM-Konfiguration

Erstellen Sie eine IAM-Richtlinie mit den erforderlichen Berechtigungen für Claude Code.

Für Details siehe Bedrock IAM-Dokumentation.

Wir empfehlen, ein dediziertes AWS-Konto für Claude Code zu erstellen, um die Kostenverfolgung und Zugriffskontrolle zu vereinfachen.

​
Fehlerbehebung

Wenn Sie Regionsprobleme haben:

  • Überprüfen Sie die Modellverfügbarkeit: aws bedrock list-inference-profiles --region your-region
  • Wechseln Sie zu einer unterstützten Region: export AWS_REGION=us-east-1
  • Erwägen Sie die Verwendung von Inferenzprofilen für regionsübergreifenden Zugang

Wenn Sie den Fehler “on-demand throughput isn’t supported” erhalten:

​
Zusätzliche Ressourcen