Claude Code auf Amazon Bedrock

​

Voraussetzungen

Bevor Sie Claude Code mit Bedrock konfigurieren, stellen Sie sicher, dass Sie Folgendes 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:

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

Option D: Bedrock-API-Schlüssel

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

Bedrock-API-Schlüssel bieten eine einfachere Authentifizierungsmethode ohne vollständige AWS-Anmeldedaten zu benötigen. Erfahren Sie mehr über Bedrock-API-Schlüssel.

​

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

# Optional: Region für das kleine/schnelle Modell (Haiku) überschreiben
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

​

4. Modellkonfiguration

Claude Code verwendet diese Standardmodelle für Bedrock:

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'

# Optional: Prompt-Caching bei Bedarf deaktivieren
export DISABLE_PROMPT_CACHING=1

​

IAM-Konfiguration

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*"
      ]
    }
  ]
}

Für restriktivere Berechtigungen können Sie die Ressource auf spezifische Inferenzprofil-ARNs beschränken.

Für Details siehe Bedrock IAM-Dokumentation.

​

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:

• Geben Sie das Modell als Inferenzprofil-ID an

​

Zusätzliche Ressourcen

• Bedrock-Dokumentation
• Bedrock-Preise
• Bedrock-Inferenzprofile
• Claude Code auf Amazon Bedrock: Schnellstart-Anleitung