SpyBara
Go Premium

amazon-bedrock.md 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC

28 added, 28 removed.

2026
Wed 5 22:02 Tue 4 22:59 Mon 3 20:02 Sun 2 19:00

Claude Code auf Amazon Bedrock

Erfahren Sie, wie Sie Claude Code über Amazon Bedrock konfigurieren, einschließlich Setup, IAM-Konfiguration und Fehlerbehebung.

export const ContactSalesCard = ({surface}) => { const utm = content => utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}; const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true"> ; const STYLES = .cc-cs { --cs-slate: #141413; --cs-clay: #d97757; --cs-clay-deep: #c6613f; --cs-gray-000: #ffffff; --cs-gray-700: #3d3d3a; --cs-border-default: rgba(31, 30, 29, 0.15); font-family: inherit; } .dark .cc-cs { --cs-slate: #f0eee6; --cs-gray-000: #262624; --cs-gray-700: #bfbdb4; --cs-border-default: rgba(240, 238, 230, 0.14); } .cc-cs-card { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 14px 16px; margin: 0; background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default); border-radius: 8px; flex-wrap: wrap; } .cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; } .cc-cs-text strong { font-weight: 550; color: var(--cs-slate); } .cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; } .cc-cs-btn-clay { display: inline-flex; align-items: center; gap: 8px; background: var(--cs-clay-deep); color: #fff; border: none; border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; transition: background-color 0.15s; white-space: nowrap; } .cc-cs-btn-clay:hover { background: var(--cs-clay); } .cc-cs-btn-ghost { display: inline-flex; align-items: center; gap: 8px; background: transparent; color: var(--cs-gray-700); border: 0.5px solid var(--cs-border-default); border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; } .cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); } .dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); } @media (max-width: 720px) { .cc-cs-actions { width: 100%; } }; return <div className="cc-cs not-prose"> <div className="cc-cs-card"> <div className="cc-cs-text"> Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.

<div className="cc-cs-actions"> <a href={https://claude.com/pricing?${utm('view_plans')}#plans-business} className="cc-cs-btn-ghost"> View plans <a href={https://claude.com/contact-sales?${utm('contact_sales')}} className="cc-cs-btn-clay"> Contact sales {iconArrowRight()}
; };

Voraussetzungen

Bevor Sie Claude Code mit Amazon Bedrock konfigurieren, stellen Sie sicher, dass Sie über Folgendes verfügen:

Um sich mit Ihren eigenen Amazon Bedrock-Anmeldedaten anzumelden, folgen Sie Mit Amazon Bedrock anmelden unten. Um Claude Code in einem Team bereitzustellen, verwenden Sie die Schritte zum manuellen Setup und fixieren Sie Ihre Modellversionen, bevor Sie ausrollen.

Mit Bedrock anmelden

Wenn Sie AWS-Anmeldedaten haben und Claude Code über Amazon Bedrock verwenden möchten, führt Sie der Anmelde-Assistent durch den Prozess. Sie führen die AWS-seitigen Voraussetzungen einmal pro Konto durch; der Assistent kümmert sich um die Claude Code-Seite.

1

Aktivieren Sie Anthropic-Modelle in Ihrem AWS-Konto

Öffnen Sie in der Amazon Bedrock-Konsole den Modellkatalog, wählen Sie ein Anthropic-Modell aus und reichen Sie das Anwendungsfallformular ein. Der Zugriff wird unmittelbar nach der Einreichung gewährt. Siehe Anwendungsfalldetails einreichen für AWS Organizations und IAM-Konfiguration für die Berechtigungen, die Ihre Rolle benötigt.

2

Starten Sie Claude Code und wählen Sie Amazon Bedrock

Führen Sie claude aus. Wählen Sie bei der Anmeldeeingabeaufforderung 3rd-party platform und dann Amazon Bedrock.

3

Folgen Sie den Assistent-Eingabeaufforderungen

Wählen Sie, wie Sie sich bei AWS authentifizieren: ein AWS-Profil, das aus Ihrem ~/.aws-Verzeichnis erkannt wird, ein Amazon Bedrock API-Schlüssel, ein Zugriffsschlüssel und Geheimnis oder Anmeldedaten, die bereits in Ihrer Umgebung vorhanden sind. Der Assistent erkennt Ihre Region, überprüft, welche Claude-Modelle Ihr Konto aufrufen kann, und ermöglicht es Ihnen, diese zu fixieren. Das Ergebnis wird im env-Block Ihrer Benutzereinstellungsdatei gespeichert, sodass Sie Umgebungsvariablen nicht selbst exportieren müssen.

Nachdem Sie sich angemeldet haben, führen Sie /setup-bedrock jederzeit aus, um den Assistenten erneut zu öffnen und Ihre Anmeldedaten, Region oder Modellpins zu ändern. Der Modellpin-Schritt beginnt mit Ihren aktuell fixierten Modellen. Der Assistent schreibt in ~/.claude/settings.json oder in $CLAUDE_CONFIG_DIR/settings.json, wenn CLAUDE_CONFIG_DIR gesetzt ist.

Manuelles Setup

Um Amazon Bedrock über Umgebungsvariablen statt über den Assistenten zu konfigurieren, z. B. in CI oder einem skriptgesteuerten Enterprise-Rollout, folgen Sie den folgenden Schritten.

1. Anwendungsfalldetails einreichen

Erstmalige Benutzer von Anthropic-Modellen müssen Anwendungsfalldetails einreichen, bevor sie ein Modell aufrufen. Dies wird einmal pro AWS-Konto durchgeführt.

  1. Stellen Sie sicher, dass Sie die unten beschriebenen richtigen IAM-Berechtigungen haben
  2. Navigieren Sie zur Amazon Bedrock-Konsole
  3. Wählen Sie ein Anthropic-Modell aus dem Modellkatalog
  4. Füllen Sie das Anwendungsfallformular aus. Der Zugriff wird unmittelbar nach der Einreichung gewährt.

Wenn Sie AWS Organizations verwenden, können Sie das Formular einmal vom Verwaltungskonto aus mit der PutUseCaseForModelAccess API einreichen. Dieser Aufruf erfordert die bedrock:PutUseCaseForModelAccess IAM-Berechtigung. Die Genehmigung erstreckt sich automatisch auf untergeordnete Konten.

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)

Ersetzen Sie your-profile-name durch den Namen Ihres AWS-Profils, bevor Sie diese Befehle ausführen.

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

export AWS_PROFILE=your-profile-name

Claude Code fordert Rollenanmeldedaten aus der IAM Identity Center-Region an, die durch das Profil sso_region benannt wird, die nicht mit der Region übereinstimmen muss, in der Sie Amazon Bedrock ausführen. In v2.1.207 überschrieb die Amazon Bedrock-Region sso_region, daher schlug ein Profil, dessen IAM Identity Center-Instanz sich in einer anderen Region befindet, mit einem Session token not found or invalid-Fehler fehl.

Option D: AWS Management Console-Anmeldedaten

aws login

Erfahren Sie mehr über aws login.

Option E: Amazon Bedrock API-Schlüssel

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

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

Anmeldedaten-Caching und Auflösungs-Timeout

Claude Code löst die AWS-Standard-Anmeldedaten-Provider-Kette einmal auf und behält die aufgelösten Anmeldedaten im Speicher. Es verwendet sie erneut, bis fünf Minuten vor ihrem Ablauf, oder für eine Stunde, wenn sie kein Ablaufdatum haben, sodass ein SSO-gestütztes Profil etwa einmal pro Anmeldedaten-Lebensdauer Anmeldedaten von IAM Identity Center anfordert. Ein Anmeldedatenfehler von der API löscht den Cache, und der Wiederholungsversuch löst frische Anmeldedaten auf.

Vor v2.1.207 löste Claude Code die Kette bei jeder API-Anfrage auf, sodass ein SSO-gestütztes Profil jedes Mal frische Anmeldedaten von IAM Identity Center anforderte und in großen Bereitstellungen gedrosselt werden konnte.

Der Cache deckt alle oben genannten Anmeldedaten-Optionen ab, außer einem Amazon Bedrock API-Schlüssel, der die Provider-Kette nicht verwendet. Um die Kette bei jeder Anfrage aufzulösen, setzen Sie stattdessen CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1.

Jede Auflösung der Kette läuft nach 60 Sekunden ab. Wenn ein Schritt in der Kette steckenbleibt, z. B. ein credential_process-Helfer, der auf Eingaben wartet, die er nicht erhalten kann, schlägt die Anfrage mit AWS default-chain credential resolve timed out fehl. Wenn Ihre Kette eine interaktive Anmeldung ausführt, die legitim länger dauert, z. B. browserbasierte SSO mit MFA über einen Wrapper wie aws-vault, erhöhen Sie das Limit in Millisekunden mit CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS. Vor v2.1.207 ließ eine steckengebliebene Anmeldedaten-Auflösung die Anfrage unbegrenzt warten.

Erweiterte Anmeldedatenkonfiguration

Claude Code unterstützt die automatische Aktualisierung von Anmeldedaten für AWS SSO und Unternehmensidentitätsanbieter. Fügen Sie diese Einstellungen zu Ihrer Claude Code-Einstellungsdatei hinzu (siehe Einstellungen für Dateispeicherorte).

Diese zwei Einstellungen haben unterschiedliche Auslösebedingungen:

Beispielkonfiguration 
{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}
Erklärung der Konfigurationseinstellungen

awsAuthRefresh: Verwenden Sie dies für Befehle, die das .aws-Verzeichnis ändern, z. B. zum Aktualisieren von Anmeldedaten, SSO-Cache oder Konfigurationsdateien. Die Ausgabe des Befehls wird dem Benutzer angezeigt, aber interaktive Eingaben werden nicht unterstützt. Dies funktioniert gut für browserbasierte SSO-Flows, bei denen die CLI eine URL oder einen Code anzeigt und Sie die Authentifizierung im Browser abschließen.

awsCredentialExport: Verwenden Sie dies nur, wenn Sie das .aws-Verzeichnis nicht ändern können und Anmeldedaten direkt zurückgeben müssen. Dieser Befehl wird ausgeführt, wenn Anmeldedaten aktualisiert werden müssen, nicht nur wenn Anmeldedaten abgelaufen sind. Die Ausgabe wird stillschweigend erfasst und nicht dem Benutzer angezeigt. Der Befehl muss JSON in diesem Format ausgeben:

{
  "Credentials": {
    "AccessKeyId": "value",
    "SecretAccessKey": "value",
    "SessionToken": "value",
    "Expiration": "2026-01-01T00:00:00Z"
  }
}

Ab Claude Code v2.1.181 wird auch die flache Ausgabe von aws configure export-credentials --format process akzeptiert, mit denselben Schlüsseln auf der obersten Ebene statt verschachtelt unter Credentials.

Expiration ist optional. Ab Claude Code v2.1.176 speichert Claude Code die Anmeldedaten im Cache, wenn der Befehl einen gültigen ISO 8601 Expiration zurückgibt, bis fünf Minuten vor dieser Zeit. Ohne ihn oder in früheren Versionen werden Anmeldedaten eine Stunde lang im Cache gespeichert.

Wenn Sie awsCredentialExport ohne awsAuthRefresh konfigurieren, verwendet Claude Code die exportierten Anmeldedaten direkt und löst die AWS-Standard-Anmeldedaten-Provider-Kette beim Start nicht erneut auf. Vor v2.1.206 löste der Start auch die Standard-Provider-Kette erneut auf, was einen Live-SSO- oder STS-Aufruf außerhalb Ihrer Proxy-Konfiguration durchführte und die erste Eingabeaufforderung in Netzwerken mit eingeschränktem Ausgang um mehrere Minuten blockieren konnte.

3. Claude Code konfigurieren

Legen Sie die folgenden Umgebungsvariablen fest, um Amazon Bedrock zu aktivieren:

# Bedrock-Integration aktivieren
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # optional, falls Ihr AWS-Profil bereits eine Region setzt

# Optional: Region für das kleine/schnelle Modell (Bedrock und Mantle) überschreiben.
# Auf Bedrock hat dies keine Auswirkung ohne ANTHROPIC_DEFAULT_HAIKU_MODEL
# oder das veraltete ANTHROPIC_SMALL_FAST_MODEL gesetzt.
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

# Optional: Bedrock-Endpunkt-URL für benutzerdefinierte Endpunkte oder Gateways überschreiben
# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

Beachten Sie beim Aktivieren von Amazon Bedrock für Claude Code Folgendes:

4. Modellversionen fixieren

Legen Sie diese Umgebungsvariablen auf spezifische Amazon Bedrock-Modell-IDs fest.

Ohne ANTHROPIC_DEFAULT_OPUS_MODEL wird der opus-Alias auf Amazon Bedrock zu Opus 4.8 aufgelöst, und ohne ANTHROPIC_DEFAULT_SONNET_MODEL wird der sonnet-Alias zu Sonnet 4.5 aufgelöst. Dieses Beispiel fixiert jeden Alias auf eine spezifische Version:

export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

Diese Variablen verwenden Cross-Region-Inferenzprofil-IDs (mit dem us.-Präfix). Wenn Sie ein anderes Regionspräfix oder Anwendungsinferenzprofile verwenden, passen Sie entsprechend an. In AWS GovCloud-Regionen verwenden Sie das us-gov.-Präfix. Aktuelle und ältere Modell-IDs finden Sie unter Modellübersicht. Siehe Modellkonfiguration für die vollständige Liste der Umgebungsvariablen.

Claude Code verwendet diese Standardmodelle, wenn keine Fixierungsvariablen gesetzt sind:

Modelltyp Standardwert
Primäres Modell us.anthropic.claude-opus-4-8
Kleines/schnelles Modell us.anthropic.claude-sonnet-4-5-20250929-v1:0

Hintergrundaufgaben wie die Generierung von Sitzungstiteln verwenden das kleine/schnelle Modell, normalerweise ein Haiku-Klasse-Modell. Auf Amazon Bedrock verwendet Claude Code das Standard-Sonnet-Modell für Hintergrundaufgaben, da Haiku möglicherweise nicht in jedem Konto oder jeder Region aktiviert ist. Zwei Auswahlmöglichkeiten ändern, welches Modell sie trägt:

Vor v2.1.207 war das primäre Modell auf Amazon Bedrock standardmäßig Sonnet 4.5, der opus-Alias wurde zu Opus 4.6 aufgelöst, und Hintergrundaufgaben verwendeten immer das primäre Modell.

Um Modelle weiter anzupassen, verwenden Sie eine dieser Methoden:

# Verwendung der Inferenzprofil-ID
export ANTHROPIC_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

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

# Optional: Prompt Caching deaktivieren, falls erforderlich
export DISABLE_PROMPT_CACHING=1

# Optional: 1-Stunden-Prompt-Cache-TTL statt der 5-Minuten-Standard anfordern
export ENABLE_PROMPT_CACHING_1H=1

Die 1-Stunden-Cache-TTL wird mit einer höheren Rate als die 5-Minuten-Standard abgerechnet. Siehe Cache-Lebensdauer.

Jede Modellversion einem Inferenzprofil zuordnen

Die Umgebungsvariablen ANTHROPIC_DEFAULT_*_MODEL konfigurieren ein Inferenzprofil pro Modellfamilie. Wenn Ihre Organisation mehrere Versionen derselben Familie in der /model-Auswahl verfügbar machen muss, die jeweils zu ihrem eigenen Anwendungsinferenzprofil-ARN weitergeleitet werden, verwenden Sie stattdessen die modelOverrides-Einstellung in Ihrer Einstellungsdatei.

Dieses Beispiel ordnet vier Opus-Versionen unterschiedlichen ARNs zu, damit Benutzer zwischen ihnen wechseln können, ohne die Inferenzprofile Ihrer Organisation zu umgehen:

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-47-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-opus-4-5-20251101": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-45-prod",
    "claude-opus-4-1-20250805": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-41-prod"
  }
}

Wenn ein Benutzer eine dieser Versionen in /model auswählt, ruft Claude Code Amazon Bedrock mit dem zugeordneten ARN auf. Die gleiche Zuordnung gilt, wenn Sie die Anthropic-Modell-ID direkt über --model oder ANTHROPIC_MODEL übergeben. Versionen ohne Überschreibung fallen auf die integrierte Amazon Bedrock-Modell-ID oder ein beliebiges übereinstimmendes Inferenzprofil zurück, das beim Start erkannt wird. Vor v2.1.200 erreichten --model- und ANTHROPIC_MODEL-Werte Amazon Bedrock unverändert, ohne die Überschreibungszuordnung zu durchlaufen. Siehe Modell-IDs pro Version überschreiben für Details, wie Überschreibungen mit availableModels und anderen Modelleinstellungen interagieren.

Startup-Modellprüfungen

Wenn Claude Code mit konfiguriertem Amazon Bedrock startet, überprüft es, dass die Modelle, die es verwenden möchte, in Ihrem Konto zugänglich sind.

Wenn Sie eine Modellversion fixiert haben, die älter ist als der aktuelle Claude Code-Standard, und Ihr Konto die neuere Version aufrufen kann, fordert Claude Code Sie auf, die Fixierung zu aktualisieren. Das Akzeptieren schreibt die neue Modell-ID in Ihre Benutzereinstellungsdatei und startet Claude Code neu. Das Ablehnen wird bis zur nächsten Standardversionänderung beibehalten. Fixierungen, die auf einen Anwendungsinferenzprofil-ARN verweisen, werden übersprungen, da diese von Ihrem Administrator verwaltet werden.

Wenn Sie ein Modell nicht fixiert haben und der aktuelle Standard in Ihrem Konto nicht verfügbar ist, fällt Claude Code für die aktuelle Sitzung auf die vorherige Version zurück und zeigt einen Hinweis an. Es versucht zuerst frühere Versionen des Standardmodells und fällt, wenn der Standard ein Opus-Modell ist und keine Opus-Version verfügbar ist, auf das Standard-Sonnet-Modell zurück. Das Fallback wird nicht beibehalten. Aktivieren Sie das neuere Modell in Ihrem Amazon Bedrock-Konto oder fixieren Sie eine Version, um die Auswahl dauerhaft zu machen.

IAM-Konfiguration

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowModelAndInferenceProfileAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles",
        "bedrock:GetInferenceProfile"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*",
        "arn:aws:bedrock:*:*:foundation-model/*"
      ]
    },
    {
      "Sid": "AllowMarketplaceSubscription",
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ViewSubscriptions",
        "aws-marketplace:Subscribe"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:CalledViaLast": "bedrock.amazonaws.com"
        }
      }
    }
  ]
}

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

bedrock:GetInferenceProfile ermöglicht es Claude Code, eine Anwendungs-Inferenzprofil-ARN in ihr zugrunde liegendes Foundation-Modell aufzulösen, das verwendet wird, um die richtige Anforderungsform für dieses Modell auszuwählen.

Wenn dem Token diese Berechtigung fehlt, wird Claude Code automatisch wiederhergestellt, indem es einmal mit der alternativen Form erneut versucht wird, sodass Anfragen weiterhin erfolgreich sind, aber jedes neue Modell einen zusätzlichen Roundtrip hinzufügt. Die Gewährung der Berechtigung vermeidet den Wiederholungsversuch. Dies gilt am häufigsten für AWS_BEARER_TOKEN_BEDROCK-Bereitstellungen, bei denen die Richtlinie des Tokens typischerweise enger ist als eine vollständige IAM-Rolle.

Weitere Details finden Sie in der Bedrock IAM-Dokumentation.

1M Token-Kontextfenster

Claude Sonnet 5, Opus 4.6 und später sowie Sonnet 4.6 unterstützen das 1M Token-Kontextfenster auf Amazon Bedrock. Sonnet 5 wird über den Mantle-Endpunkt bereitgestellt und läuft immer mit dem 1M-Fenster, ohne dass eine [1m]-Variante ausgewählt werden kann. Bei den anderen Modellen aktiviert Claude Code automatisch das erweiterte Kontextfenster, wenn Sie eine 1M-Modellvariante auswählen.

Der Setup-Assistent bietet eine 1M-Kontextoption, wenn er Modelle fixiert. Um es stattdessen für ein manuell fixiertes Modell zu aktivieren, hängen Sie [1m] an die Modell-ID an. Siehe Modelle für Drittanbieter-Bereitstellungen fixieren für Details.

Service-Tiers

Amazon Bedrock Service-Tiers ermöglichen es Ihnen, Kosten gegen Latenz abzuwägen. Legen Sie ANTHROPIC_BEDROCK_SERVICE_TIER auf default, flex oder priority fest:

export ANTHROPIC_BEDROCK_SERVICE_TIER=priority

Claude Code sendet dies als X-Amzn-Bedrock-Service-Tier-Header bei jeder Anfrage. Die Tier-Verfügbarkeit variiert je nach Modell und Region. Reservierte Kapazität verwendet einen bereitgestellten Durchsatz-ARN als Modell-ID statt dieser Einstellung.

AWS Guardrails

Amazon Bedrock Guardrails ermöglichen es Ihnen, Inhaltsfilterung für Claude Code zu implementieren. Erstellen Sie einen Guardrail in der Amazon Bedrock-Konsole, veröffentlichen Sie eine Version, und fügen Sie dann die Guardrail-Header zu Ihrer Einstellungsdatei hinzu. Aktivieren Sie Cross-Region-Inferenz auf Ihrem Guardrail, wenn Sie Cross-Region-Inferenzprofile verwenden.

Beispielkonfiguration:

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Amzn-Bedrock-GuardrailIdentifier: your-guardrail-id\nX-Amzn-Bedrock-GuardrailVersion: 1"
  }
}

Verwenden Sie den Mantle-Endpunkt

Mantle ist ein Amazon Bedrock-Endpunkt, der Claude-Modelle über die native Anthropic API-Form statt über die Amazon Bedrock Invoke API bereitstellt. Er verwendet die gleichen AWS-Anmeldedaten, IAM-Berechtigungen und awsAuthRefresh-Konfiguration, die weiter oben auf dieser Seite beschrieben sind.

Aktivieren Sie Mantle

Mit bereits konfigurierten AWS-Anmeldedaten legen Sie CLAUDE_CODE_USE_MANTLE fest, um Anfragen zum Mantle-Endpunkt weiterzuleiten:

export CLAUDE_CODE_USE_MANTLE=1
export AWS_REGION=us-east-1

Claude Code erstellt die Endpunkt-URL aus der AWS-Region. Ab v2.1.172 wird die Region mit der gleichen Priorität aufgelöst wie Amazon Bedrock oben; frühere Versionen verwenden nur AWS_REGION. Um die URL für einen benutzerdefinierten Endpunkt oder ein Gateway zu überschreiben, legen Sie ANTHROPIC_BEDROCK_MANTLE_BASE_URL fest.

Führen Sie /status in Claude Code aus, um zu bestätigen. Die Provider-Zeile zeigt Amazon Bedrock (Mantle), wenn Mantle aktiv ist.

Wählen Sie ein Mantle-Modell

Mantle verwendet Modell-IDs mit dem Präfix anthropic. und ohne Versionssuffix, z. B. anthropic.claude-sonnet-5 oder anthropic.claude-haiku-4-5. Die Modelle, die Ihrem Konto zur Verfügung stehen, hängen davon ab, was Ihre Organisation erhalten hat; zusätzliche Modell-IDs sind in Ihren Onboarding-Materialien von AWS aufgeführt. Wenden Sie sich an Ihr AWS-Kontoteam, um Zugriff auf zulässige Modelle anzufordern.

Legen Sie das Modell mit dem --model-Flag oder mit /model in Claude Code fest:

claude --model anthropic.claude-haiku-4-5

Führen Sie Mantle neben der Invoke API aus

Die Modelle, die Ihnen auf Mantle zur Verfügung stehen, enthalten möglicherweise nicht alle Modelle, die Sie heute verwenden. Das Setzen von CLAUDE_CODE_USE_BEDROCK und CLAUDE_CODE_USE_MANTLE ermöglicht es Claude Code, beide Endpunkte aus derselben Sitzung aufzurufen. Modell-IDs, die dem Mantle-Format entsprechen, werden zu Mantle weitergeleitet, und alle anderen Modell-IDs gehen zur Amazon Bedrock Invoke API.

export CLAUDE_CODE_USE_BEDROCK=1
export CLAUDE_CODE_USE_MANTLE=1

Um ein Mantle-Modell in der /model-Auswahl anzuzeigen, listen Sie seine ID in availableModels in Ihrer Einstellungsdatei auf. Diese Einstellung beschränkt die Auswahl auch auf die aufgelisteten Einträge. Das Auflisten von anthropic.claude-haiku-4-5 entfernt den bloßen haiku-Alias aus der Auswahl, daher sollten Sie auch Versionspräfixe oder vollständige IDs für die Versionen auflisten, die Sie auswählbar halten möchten. Die Mantle-ID und der haiku-Alias werden zum gleichen Modell-Familie aufgelöst, daher behält die Zusammenführung nur den spezifischeren Eintrag. Siehe Merge-Verhalten:

{
  "availableModels": ["opus", "sonnet", "claude-haiku-4-5", "anthropic.claude-haiku-4-5"]
}

Einträge mit dem anthropic.-Präfix werden als benutzerdefinierte Auswahl-Optionen hinzugefügt und zu Mantle weitergeleitet. Ersetzen Sie anthropic.claude-haiku-4-5 durch die Modell-ID, die Ihr Konto erhalten hat. Siehe Modellauswahl einschränken für Details, wie availableModels mit anderen Modelleinstellungen interagiert.

Wenn beide Provider aktiv sind, zeigt /status Amazon Bedrock + Amazon Bedrock (Mantle) an.

Leiten Sie Mantle durch ein Gateway weiter

Wenn Ihre Organisation Modellverkehr durch ein zentralisiertes LLM-Gateway leitet, das AWS-Anmeldedaten serverseitig injiziert, deaktivieren Sie die clientseitige Authentifizierung, damit Claude Code Anfragen ohne SigV4-Signaturen oder x-api-key-Header sendet:

export CLAUDE_CODE_USE_MANTLE=1
export CLAUDE_CODE_SKIP_MANTLE_AUTH=1
export ANTHROPIC_BEDROCK_MANTLE_BASE_URL=https://your-gateway.example.com

Mantle-Umgebungsvariablen

Diese Variablen sind spezifisch für den Mantle-Endpunkt. Siehe Umgebungsvariablen für die vollständige Liste.

Variable Zweck
CLAUDE_CODE_USE_MANTLE Aktivieren Sie den Mantle-Endpunkt. Legen Sie auf 1 oder true fest.
ANTHROPIC_BEDROCK_MANTLE_BASE_URL Überschreiben Sie die Standard-Mantle-Endpunkt-URL
CLAUDE_CODE_SKIP_MANTLE_AUTH Überspringen Sie die clientseitige Authentifizierung für Proxy-Setups
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION Überschreiben Sie die AWS-Region für das Haiku-Klasse-Modell (gemeinsam mit Amazon Bedrock)

Fehlerbehebung

Authentifizierungsschleife mit SSO und Unternehmens-Proxys

Wenn Browser-Registerkarten wiederholt geöffnet werden, wenn Sie AWS SSO verwenden, entfernen Sie die awsAuthRefresh-Einstellung aus Ihrer Einstellungsdatei. Dies kann auftreten, wenn Unternehmens-VPNs oder TLS-Inspektions-Proxys den SSO-Browser-Flow unterbrechen. Claude Code behandelt die unterbrochene Verbindung als Authentifizierungsfehler, führt awsAuthRefresh erneut aus und schleift sich endlos.

Wenn Ihre Netzwerkumgebung automatische browserbasierte SSO-Flows beeinträchtigt, verwenden Sie aws sso login manuell, bevor Sie Claude Code starten, anstatt sich auf awsAuthRefresh zu verlassen.

Regionsprobleme

Wenn Sie auf Regionsprobleme stoßen:

Wenn Sie einen Fehler „on-demand throughput isn't supported" erhalten:

Claude Code verwendet die Amazon Bedrock Invoke API und unterstützt die Converse API nicht.

Streaming-Fehler hinter einem Gateway oder Proxy

Wenn Streaming-Anfragen mit einem Fehler fehlschlagen, der mit Bedrock streaming response has content-type beginnt, transformiert ein Gateway oder Proxy zwischen Claude Code und Amazon Bedrock die Streaming-Antwort. Amazon Bedrock streamt Antworten in einem binären Event-Stream-Format mit dem Content-Type application/vnd.amazon.eventstream, und Claude Code lehnt eine erfolgreiche Streaming-Antwort ab, die einen anderen Content-Type meldet, anstatt einen Body zu dekodieren, den es nicht lesen kann. Der Fehler nennt den Content-Type, den es erhalten hat, häufig text/event-stream von einer Amazon API Gateway- und Lambda-Integration, die den Stream als Server-Sent Events erneut aussendet.

Vor v2.1.208 zeigte sich die gleiche Fehlkonfiguration als API Error: Truncated event message received, nachdem die gesamte Antwort gepuffert worden war.

Um dies zu beheben, konfigurieren Sie das Gateway so, dass es den InvokeModelWithResponseStream-Antwortkörper und seinen Content-Type-Header unverändert durchleitet. Wenn das Gateway nur den Header umschreibt und den binären Body intakt durchleitet, setzen Sie CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1, um die Überprüfung zu überspringen, bis das Gateway repariert ist. Mit deaktivierter Überprüfung schlägt ein Antwortkörper, der transformiert wurde, erneut mit Truncated event message received fehl.

Null-Token-Zählungen in /context

Der /context-Befehl zählt Token für jede Tool-Gruppe, indem die Tool-Schemas an die Amazon Bedrock-API zum Zählen von Tokens gesendet werden. Bei Claude Code-Versionen vor v2.1.196 lehnte Amazon Bedrock diese Anfrage ab, da die Schemas Felder enthielten, die die API zum Zählen von Tokens nicht akzeptiert, sodass jede Tool-Gruppe 0 Tokens anzeigte. Andere Zeilen in der Aufschlüsselung, wie Nachrichten und Speicherdateien, sind nicht betroffen.

Aktualisieren Sie auf v2.1.196 oder später.

Mantle-Endpunkt-Fehler

Wenn /status nach dem Setzen von CLAUDE_CODE_USE_MANTLE nicht Amazon Bedrock (Mantle) anzeigt, erreicht die Variable den Prozess nicht. Bestätigen Sie, dass sie in der Shell exportiert wird, in der Sie claude gestartet haben, oder legen Sie sie im env-Block Ihrer Einstellungsdatei fest.

Ein 403 vom Mantle-Endpunkt mit gültigen Anmeldedaten bedeutet, dass Ihrem AWS-Konto kein Zugriff auf das angeforderte Modell gewährt wurde. Wenden Sie sich an Ihr AWS-Kontoteam, um Zugriff anzufordern.

Ein 400, das die Modell-ID nennt, bedeutet, dass dieses Modell nicht auf Mantle bereitgestellt wird. Mantle hat sein eigenes Modell-Lineup, das vom Standard-Amazon Bedrock-Katalog getrennt ist, daher funktionieren Inferenzprofil-IDs wie us.anthropic.claude-sonnet-4-6 nicht. Verwenden Sie eine Mantle-Format-ID, oder aktivieren Sie beide Endpunkte, damit Claude Code jede Anfrage zum Endpunkt weiterleitet, wo das Modell verfügbar ist.

Zusätzliche Ressourcen