SpyBara
Go Premium

amazon-bedrock.md 2026-07-15 22:00 UTC to 2026-07-16 22:59 UTC

46 added, 9 removed.

2026
Fri 17 22:00 Thu 16 22:59 Wed 15 22:00 Tue 14 23:01 Mon 13 23:57 Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01

Claude Code sur Amazon Bedrock

Découvrez comment configurer Claude Code via Amazon Bedrock, y compris la configuration, la configuration IAM et le dépannage.

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()}
; };

Prérequis

Avant de configurer Claude Code avec Amazon Bedrock, assurez-vous que vous disposez de :

Pour vous connecter avec vos propres identifiants Amazon Bedrock, suivez Se connecter avec Amazon Bedrock ci-dessous. Pour déployer Claude Code dans une équipe, utilisez les étapes de configuration manuelle et épinglez vos versions de modèle avant le déploiement.

Se connecter avec Bedrock

Si vous disposez d'identifiants AWS et souhaitez commencer à utiliser Claude Code via Amazon Bedrock, l'assistant de connexion vous guide à travers le processus. Vous complétez les prérequis côté AWS une fois par compte ; l'assistant gère le côté Claude Code.

1

Activer les modèles Anthropic dans votre compte AWS

Dans la console Amazon Bedrock, ouvrez le catalogue de modèles, sélectionnez un modèle Anthropic et soumettez le formulaire de cas d'usage. L'accès est accordé immédiatement après la soumission. Voir Soumettre les détails du cas d'usage pour AWS Organizations et Configuration IAM pour les autorisations dont votre rôle a besoin.

2

Démarrer Claude Code et choisir Amazon Bedrock

Exécutez claude. À l'invite de connexion, sélectionnez 3rd-party platform, puis Amazon Bedrock.

3

Suivre les invites de l'assistant

Choisissez comment vous vous authentifiez auprès d'AWS : un profil AWS détecté à partir de votre répertoire ~/.aws, une clé API Amazon Bedrock, une clé d'accès et un secret, ou des identifiants déjà dans votre environnement. L'assistant récupère votre région, vérifie quels modèles Claude votre compte peut invoquer, et vous permet de les épingler. Il enregistre le résultat dans le bloc env de votre fichier de paramètres utilisateur, vous n'avez donc pas besoin d'exporter les variables d'environnement vous-même.

Après vous être connecté, exécutez /setup-bedrock à tout moment pour rouvrir l'assistant et modifier vos identifiants, votre région ou vos épingles de modèle. L'étape d'épingle de modèle commence à partir de vos modèles actuellement épinglés. L'assistant écrit dans ~/.claude/settings.json, ou dans $CLAUDE_CONFIG_DIR/settings.json lorsque CLAUDE_CONFIG_DIR est défini.

Configuration manuelle

Pour configurer Amazon Bedrock via des variables d'environnement au lieu de l'assistant, par exemple dans CI ou un déploiement d'entreprise scriptés, suivez les étapes ci-dessous.

1. Soumettre les détails du cas d'usage

Les utilisateurs pour la première fois des modèles Anthropic doivent soumettre les détails du cas d'usage avant d'invoquer un modèle. Ceci est fait une fois par compte AWS.

  1. Assurez-vous que vous disposez des bonnes autorisations IAM décrites ci-dessous
  2. Accédez à la console Amazon Bedrock
  3. Sélectionnez un modèle Anthropic dans le catalogue de modèles
  4. Complétez le formulaire de cas d'usage. L'accès est accordé immédiatement après la soumission.

Si vous utilisez AWS Organizations, vous pouvez soumettre le formulaire une fois à partir du compte de gestion en utilisant l'API PutUseCaseForModelAccess. Cet appel nécessite l'autorisation IAM bedrock:PutUseCaseForModelAccess. L'approbation s'étend automatiquement aux comptes enfants.

2. Configurer les identifiants AWS

Claude Code utilise la chaîne d'identifiants par défaut du SDK AWS. Configurez vos identifiants en utilisant l'une de ces méthodes :

Option A : Configuration AWS CLI

aws configure

Option B : Variables d'environnement (clé d'accès)

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 : Variables d'environnement (profil SSO)

Remplacez your-profile-name par le nom de votre profil AWS avant d'exécuter ces commandes.

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

export AWS_PROFILE=your-profile-name

Claude Code demande les identifiants de rôle à la région IAM Identity Center nommée par le sso_region du profil, qui n'a pas besoin de correspondre à la région dans laquelle vous exécutez Amazon Bedrock. {/* min-version: 2.1.208 */}Dans la v2.1.207, la région Amazon Bedrock a remplacé sso_region, donc un profil dont l'instance IAM Identity Center se trouve dans une région différente n'a pas pu s'authentifier avec une erreur Session token not found or invalid.

Option D : Identifiants de la console de gestion AWS

aws login

En savoir plus sur aws login.

Option E : Clés API Amazon Bedrock

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

Les clés API Amazon Bedrock offrent une méthode d'authentification plus simple sans avoir besoin d'identifiants AWS complets. En savoir plus sur les clés API Amazon Bedrock.

Mise en cache des identifiants et délai d'expiration de la résolution

Claude Code résout la chaîne de fournisseurs d'identifiants AWS par défaut une fois et conserve les identifiants résolus en mémoire. Il les réutilise jusqu'à cinq minutes avant leur expiration, ou pendant une heure lorsqu'ils n'ont pas d'expiration, donc un profil soutenu par SSO demande des identifiants à IAM Identity Center environ une fois par durée de vie des identifiants. Une erreur d'identifiants de l'API efface le cache, et la nouvelle tentative résout les identifiants actualisés.

Avant la v2.1.207, Claude Code résolvait la chaîne à chaque demande d'API, donc un profil soutenu par SSO demandait des identifiants actualisés à IAM Identity Center à chaque fois et pouvait être limité en débit dans les déploiements à grande échelle.

Le cache couvre toutes les options d'identifiants ci-dessus sauf une clé API Amazon Bedrock, qui n'utilise pas la chaîne de fournisseurs. Pour résoudre la chaîne à chaque demande à la place, définissez CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1.

Chaque résolution de la chaîne expire après 60 secondes. Si une étape de la chaîne s'arrête, par exemple un assistant credential_process qui attend une entrée qu'il ne peut pas recevoir, la demande échoue avec AWS default-chain credential resolve timed out. Si votre chaîne exécute une connexion interactive qui a légitimement besoin de plus de temps, comme SSO basé sur un navigateur avec MFA via un wrapper comme aws-vault, augmentez la limite en millisecondes avec CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS. Avant la v2.1.207, une résolution d'identifiants bloquée laissait la demande en attente indéfiniment.

Configuration avancée des identifiants

Claude Code prend en charge l'actualisation automatique des identifiants pour AWS SSO et les fournisseurs d'identité d'entreprise. Ajoutez ces paramètres à votre fichier de paramètres Claude Code (voir Paramètres pour les emplacements des fichiers).

Ces deux paramètres ont des conditions de déclenchement différentes :

Exemple de configuration 
{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}
Paramètres de configuration expliqués

awsAuthRefresh : Utilisez ceci pour les commandes qui modifient le répertoire .aws, comme la mise à jour des identifiants, du cache SSO ou des fichiers de configuration. La sortie de la commande s'affiche à l'utilisateur, mais l'entrée interactive n'est pas prise en charge. Cela fonctionne bien pour les flux SSO basés sur un navigateur où l'interface de ligne de commande affiche une URL ou un code et vous complétez l'authentification dans le navigateur.

awsCredentialExport : Utilisez ceci uniquement si vous ne pouvez pas modifier .aws et devez retourner directement les identifiants. Cette commande s'exécute chaque fois que les identifiants doivent être actualisés, pas seulement lorsque les identifiants ont expiré. La sortie est capturée silencieusement et non affichée à l'utilisateur. La commande doit générer du JSON dans ce format :

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

{/* min-version: 2.1.181 */}À partir de Claude Code v2.1.181, la sortie plate de aws configure export-credentials --format process est également acceptée, avec les mêmes clés au niveau supérieur au lieu d'être imbriquées sous Credentials.

Expiration est facultatif. {/* min-version: 2.1.176 */}À partir de Claude Code v2.1.176, lorsque la commande retourne une Expiration ISO 8601 valide, Claude Code met en cache les identifiants jusqu'à cinq minutes avant cette heure. Sans cela, ou sur les versions antérieures, les identifiants sont mis en cache pendant une heure.

Lorsque vous configurez awsCredentialExport sans awsAuthRefresh, Claude Code utilise les identifiants exportés directement et ne ré-résout pas la chaîne de fournisseurs d'identifiants AWS par défaut au démarrage. Avant la v2.1.206, le démarrage ré-résolvait également la chaîne de fournisseurs par défaut, ce qui effectuait un appel SSO ou STS en direct en dehors de votre configuration de proxy et pouvait bloquer la première invite pendant plusieurs minutes sur les réseaux avec une sortie restreinte.

3. Configurer Claude Code

Définissez les variables d'environnement suivantes pour activer Amazon Bedrock :

# Enable Bedrock integration
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # optional if your AWS profile already sets a region

# Optional: Override the AWS region for the small/fast model (Bedrock and Mantle).
# On Bedrock, has no effect without ANTHROPIC_DEFAULT_HAIKU_MODEL
# or the deprecated ANTHROPIC_SMALL_FAST_MODEL set.
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

# Optional: Override the Bedrock endpoint URL for custom endpoints or gateways
# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

Lors de l'activation d'Amazon Bedrock pour Claude Code, gardez à l'esprit les points suivants :

4. Épingler les versions de modèle

Définissez ces variables d'environnement sur des ID de modèle Amazon Bedrock spécifiques.

Sans ANTHROPIC_DEFAULT_OPUS_MODEL, l'alias opus sur Amazon Bedrock se résout à Opus 4.8, et sans ANTHROPIC_DEFAULT_SONNET_MODEL, l'alias sonnet se résout à Sonnet 4.5. Cet exemple épingle chaque alias à une version spécifique :

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'

Ces variables utilisent des ID de profil d'inférence inter-régions (avec le préfixe us.). Si vous utilisez un préfixe de région différent ou des profils d'inférence d'application, ajustez en conséquence. Dans les régions AWS GovCloud, utilisez le préfixe us-gov.. Pour les ID de modèle actuels et hérités, voir Aperçu des modèles. Voir Configuration du modèle pour la liste complète des variables d'environnement.

Claude Code utilise ces modèles par défaut lorsqu'aucune variable d'épinglage n'est définie :

Type de modèle Valeur par défaut
Modèle principal us.anthropic.claude-opus-4-8
Modèle petit/rapide us.anthropic.claude-sonnet-4-5-20250929-v1:0

Les tâches de fond telles que la génération de titre de session utilisent le modèle petit/rapide, normalement un modèle de classe Haiku. Sur Amazon Bedrock, Claude Code utilise le modèle Sonnet par défaut pour les tâches de fond car Haiku peut ne pas être activé dans tous les comptes ou régions. Deux sélections changent quel modèle les porte :

{/* min-version: 2.1.207 */}Avant la v2.1.207, le modèle principal sur Amazon Bedrock était par défaut Sonnet 4.5, l'alias opus se résolvait à Opus 4.6, et les tâches de fond utilisaient toujours le modèle principal.

Pour personnaliser davantage les modèles, utilisez l'une de ces méthodes :

# Using inference profile ID
export ANTHROPIC_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

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

# Optional: Disable prompt caching if needed
export DISABLE_PROMPT_CACHING=1

# Optional: Request 1-hour prompt cache TTL instead of the 5-minute default
export ENABLE_PROMPT_CACHING_1H=1

Le TTL du cache d'une heure est facturé à un taux plus élevé que la valeur par défaut de cinq minutes. Voir durée de vie du cache.

Mapper chaque version de modèle à un profil d'inférence

Les variables d'environnement ANTHROPIC_DEFAULT_*_MODEL configurent un profil d'inférence par famille de modèles. Si votre organisation doit exposer plusieurs versions de la même famille dans le sélecteur /model, chacune acheminée vers son propre ARN de profil d'inférence d'application, utilisez plutôt le paramètre modelOverrides dans votre fichier de paramètres.

Cet exemple mappe quatre versions d'Opus à des ARN distincts afin que les utilisateurs puissent basculer entre elles sans contourner les profils d'inférence de votre organisation :

{
  "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"
  }
}

Lorsqu'un utilisateur sélectionne l'une de ces versions dans /model, Claude Code appelle Amazon Bedrock avec l'ARN mappé. {/* min-version: 2.1.200 */}Le même mappage s'applique lorsque vous transmettez directement l'ID de modèle Anthropic via --model ou ANTHROPIC_MODEL. Les versions sans remplacement reviennent à l'ID de modèle Amazon Bedrock intégré ou à tout profil d'inférence correspondant découvert au démarrage. Avant la v2.1.200, les valeurs --model et ANTHROPIC_MODEL atteignaient Amazon Bedrock telles quelles sans passer par la carte de remplacement. Voir Remplacer les ID de modèle par version pour plus de détails sur la façon dont les remplacements interagissent avec availableModels et d'autres paramètres de modèle.

Vérifications du modèle au démarrage

Lorsque Claude Code démarre avec Amazon Bedrock configuré, il vérifie que les modèles qu'il a l'intention d'utiliser sont accessibles dans votre compte.

Si vous avez épinglé une version de modèle plus ancienne que la valeur par défaut actuelle de Claude Code, et que votre compte peut invoquer la version plus récente, Claude Code vous invite à mettre à jour l'épingle. L'acceptation écrit le nouvel ID de modèle dans votre fichier de paramètres utilisateur et redémarre Claude Code. Le refus est mémorisé jusqu'au prochain changement de version par défaut. Les épingles qui pointent vers un ARN de profil d'inférence d'application sont ignorées, car celles-ci sont gérées par votre administrateur.

Si vous n'avez pas épinglé un modèle et que la valeur par défaut actuelle n'est pas disponible dans votre compte, Claude Code revient à la version précédente pour la session actuelle et affiche un avis. Il essaie d'abord les versions antérieures du modèle par défaut et, lorsque la valeur par défaut est un modèle Opus et qu'aucune version Opus n'est disponible, revient au modèle Sonnet par défaut. Le retour n'est pas persistant. Activez le modèle plus récent dans votre compte Amazon Bedrock ou épinglez une version pour rendre le choix permanent.

Configuration IAM

Créez une politique IAM avec les autorisations requises pour 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"
        }
      }
    }
  ]
}

Pour des autorisations plus restrictives, vous pouvez limiter la ressource à des ARN de profil d'inférence spécifiques.

bedrock:GetInferenceProfile permet à Claude Code de résoudre un ARN de profil d'inférence d'application vers son modèle de fondation de support, qui est utilisé pour sélectionner la forme de requête correcte pour ce modèle.

Si le jeton ne dispose pas de cette autorisation, Claude Code se rétablit automatiquement en réessayant une fois avec la forme alternative, de sorte que les requêtes réussissent toujours mais chaque nouveau modèle ajoute un aller-retour supplémentaire. L'octroi de l'autorisation évite la nouvelle tentative. Cela s'applique le plus souvent aux déploiements AWS_BEARER_TOKEN_BEDROCK, où la politique du jeton est généralement plus étroite qu'un rôle IAM complet.

Pour plus de détails, voir Documentation IAM Bedrock.

Fenêtre de contexte de 1M de jetons

Claude Sonnet 5, Opus 4.6 et versions ultérieures, ainsi que Sonnet 4.6, prennent en charge la fenêtre de contexte de 1M de jetons sur Amazon Bedrock. Sonnet 5 est servi via le point de terminaison Mantle et s'exécute toujours avec la fenêtre 1M, sans variante [1m] à sélectionner. Pour les autres modèles, Claude Code active automatiquement la fenêtre de contexte étendue lorsque vous sélectionnez une variante de modèle 1M.

L'assistant de configuration offre une option de contexte 1M lorsqu'il épingle les modèles. Pour l'activer pour un modèle épinglé manuellement à la place, ajoutez [1m] à l'ID du modèle. Voir Épingler les modèles pour les déploiements tiers pour plus de détails.

Niveaux de service

Les niveaux de service Amazon Bedrock vous permettent de faire un compromis entre le coût et la latence. Définissez ANTHROPIC_BEDROCK_SERVICE_TIER sur default, flex ou priority :

export ANTHROPIC_BEDROCK_SERVICE_TIER=priority

Claude Code envoie ceci comme en-tête X-Amzn-Bedrock-Service-Tier sur chaque demande. La disponibilité des niveaux varie selon le modèle et la région. La capacité réservée utilise un ARN de débit provisionné comme ID de modèle au lieu de ce paramètre.

Garde-fous AWS

Les garde-fous Amazon Bedrock vous permettent de mettre en œuvre le filtrage du contenu pour Claude Code. Créez un garde-fou dans la console Amazon Bedrock, publiez une version, puis ajoutez les en-têtes du garde-fou à votre fichier de paramètres. Activez l'inférence inter-régions sur votre garde-fou si vous utilisez des profils d'inférence inter-régions.

Exemple de configuration :

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

Utiliser le point de terminaison Mantle

Mantle est un point de terminaison Amazon Bedrock qui sert les modèles Claude via la forme API Anthropic native plutôt que l'API Invoke Bedrock. Il utilise les mêmes identifiants AWS, autorisations IAM et configuration awsAuthRefresh décrites précédemment sur cette page.

Activer Mantle

Avec les identifiants AWS déjà configurés, définissez CLAUDE_CODE_USE_MANTLE pour acheminer les demandes vers le point de terminaison Mantle :

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

Claude Code construit l'URL du point de terminaison à partir de la région AWS. {/* min-version: 2.1.172 */}À partir de la v2.1.172, la région est résolue avec la même priorité que Bedrock ci-dessus ; les versions antérieures utilisent uniquement AWS_REGION. Pour remplacer l'URL pour un point de terminaison personnalisé ou une passerelle, définissez ANTHROPIC_BEDROCK_MANTLE_BASE_URL.

Exécutez /status dans Claude Code pour confirmer. La ligne du fournisseur affiche Amazon Bedrock (Mantle) lorsque Mantle est actif.

Sélectionner un modèle Mantle

Mantle utilise des ID de modèle préfixés avec anthropic. et sans suffixe de version, par exemple anthropic.claude-sonnet-5 ou anthropic.claude-haiku-4-5. Les modèles disponibles pour votre compte dépendent de ce que votre organisation a reçu ; les ID de modèle supplémentaires sont répertoriés dans vos documents d'intégration d'AWS. Contactez votre équipe de compte AWS pour demander l'accès aux modèles autorisés.

Définissez le modèle avec l'indicateur --model ou avec /model dans Claude Code :

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

Exécuter Mantle aux côtés de l'API Invoke

Les modèles disponibles pour vous sur Mantle peuvent ne pas inclure tous les modèles que vous utilisez aujourd'hui. La définition de CLAUDE_CODE_USE_BEDROCK et CLAUDE_CODE_USE_MANTLE permet à Claude Code d'appeler les deux points de terminaison à partir de la même session. Les ID de modèle qui correspondent au format Mantle sont acheminés vers Mantle, et tous les autres ID de modèle vont à l'API Invoke Bedrock.

export CLAUDE_CODE_USE_BEDROCK=1
export CLAUDE_CODE_USE_MANTLE=1

Pour afficher un modèle Mantle dans le sélecteur /model, répertoriez son ID dans availableModels dans votre fichier de paramètres. Ce paramètre restreint également le sélecteur aux entrées répertoriées. Répertorier anthropic.claude-haiku-4-5 supprime l'alias haiku nu du sélecteur, donc répertoriez également les préfixes de version ou les ID complets pour les versions que vous souhaitez garder sélectionnables. L'ID Mantle et l'alias haiku se résolvent à la même famille de modèles, donc la fusion conserve uniquement l'entrée plus spécifique. Voir Comportement de fusion :

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

Les entrées avec le préfixe anthropic. sont ajoutées en tant qu'options de sélecteur personnalisées et acheminées vers Mantle. Remplacez anthropic.claude-haiku-4-5 par l'ID de modèle que votre compte a reçu. Voir Restreindre la sélection du modèle pour savoir comment availableModels interagit avec d'autres paramètres de modèle.

Lorsque les deux fournisseurs sont actifs, /status affiche Amazon Bedrock + Amazon Bedrock (Mantle).

Acheminer Mantle via une passerelle

Si votre organisation achemine le trafic du modèle via une passerelle LLM centralisée qui injecte les identifiants AWS côté serveur, désactivez l'authentification côté client afin que Claude Code envoie les demandes sans signatures SigV4 ou en-têtes x-api-key :

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

Variables d'environnement Mantle

Ces variables sont spécifiques au point de terminaison Mantle. Voir Variables d'environnement pour la liste complète.

Variable Objectif
CLAUDE_CODE_USE_MANTLE Activer le point de terminaison Mantle. Définissez sur 1 ou true.
ANTHROPIC_BEDROCK_MANTLE_BASE_URL Remplacer l'URL du point de terminaison Mantle par défaut
CLAUDE_CODE_SKIP_MANTLE_AUTH Ignorer l'authentification côté client pour les configurations de proxy
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION Remplacer la région AWS pour le modèle de classe Haiku (partagé avec Bedrock)

Dépannage

Boucle d'authentification avec SSO et proxies d'entreprise

Si des onglets de navigateur s'ouvrent à plusieurs reprises lors de l'utilisation d'AWS SSO, supprimez le paramètre awsAuthRefresh de votre fichier de paramètres. Cela peut se produire lorsque les VPN d'entreprise ou les proxies d'inspection TLS interrompent le flux SSO du navigateur. Claude Code traite la connexion interrompue comme un échec d'authentification, réexécute awsAuthRefresh et boucle indéfiniment.

Si votre environnement réseau interfère avec les flux SSO automatiques basés sur un navigateur, utilisez aws sso login manuellement avant de démarrer Claude Code au lieu de vous fier à awsAuthRefresh.

Problèmes de région

Si vous rencontrez des problèmes de région :

Si vous recevez une erreur « on-demand throughput isn't supported » :

Claude Code utilise l'API Bedrock Invoke et ne prend pas en charge l'API Converse.

Erreurs de streaming derrière une passerelle ou un proxy

Si les demandes de streaming échouent avec une erreur qui commence par Bedrock streaming response has content-type, une passerelle ou un proxy entre Claude Code et Amazon Bedrock transforme la réponse de streaming. Amazon Bedrock diffuse les réponses dans un format d'événement binaire event-stream avec le content-type application/vnd.amazon.eventstream, et Claude Code rejette une réponse de streaming réussie qui signale un content-type différent au lieu de décoder un corps qu'il ne peut pas lire. L'erreur nomme le content-type qu'il a reçu, généralement text/event-stream provenant d'une intégration Amazon API Gateway et Lambda qui réemet le flux sous forme d'événements envoyés par le serveur.

Avant v2.1.208, la même mauvaise configuration s'affichait comme API Error: Truncated event message received après que la réponse entière ait été mise en mémoire tampon.

Pour corriger cela, configurez la passerelle pour transmettre le corps de la réponse InvokeModelWithResponseStream et son en-tête Content-Type sans modification. Si la passerelle réécrit uniquement l'en-tête et transmet le corps binaire intact, définissez CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 pour ignorer la vérification jusqu'à ce que la passerelle soit corrigée. Avec la vérification désactivée, un corps de réponse qui a été transformé échoue avec Truncated event message received à nouveau.

Comptages de jetons zéro dans /context

La commande /context compte les jetons pour chaque groupe d'outils en envoyant les schémas d'outils à l'API count-tokens de Bedrock. {/* min-version: 2.1.196 */}Sur les versions de Claude Code antérieures à v2.1.196, Bedrock a rejeté cette demande car les schémas contenaient des champs que son API count-tokens n'accepte pas, donc chaque groupe d'outils affichait 0 jetons. Les autres lignes de la ventilation, telles que les messages et les fichiers de mémoire, ne sont pas affectées.

Mettez à jour vers v2.1.196 ou une version ultérieure.

Erreurs du point de terminaison Mantle

Si /status n'affiche pas Amazon Bedrock (Mantle) après avoir défini CLAUDE_CODE_USE_MANTLE, la variable n'atteint pas le processus. Confirmez qu'elle est exportée dans le shell où vous avez lancé claude, ou définissez-la dans le bloc env de votre fichier de paramètres.

Un 403 du point de terminaison Mantle avec des identifiants valides signifie que votre compte AWS n'a pas reçu l'accès au modèle que vous avez demandé. Contactez votre équipe de compte AWS pour demander l'accès.

Un 400 qui nomme l'ID du modèle signifie que ce modèle n'est pas servi sur Mantle. Mantle a sa propre gamme de modèles distincte du catalogue Bedrock standard, donc les ID de profil d'inférence tels que us.anthropic.claude-sonnet-4-6 ne fonctionneront pas. Utilisez un ID au format Mantle, ou activez les deux points de terminaison afin que Claude Code achemine chaque demande vers le point de terminaison où le modèle est disponible.

Ressources supplémentaires