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.
Prérequis
Avant de configurer Claude Code avec Bedrock, assurez-vous que vous disposez de :- Un compte AWS avec accès à Bedrock activé
- Accès aux modèles Claude souhaités (par exemple, Claude Sonnet 4.6) dans Bedrock
- AWS CLI installé et configuré (facultatif - nécessaire uniquement si vous n’avez pas d’autre mécanisme pour obtenir les identifiants)
- Autorisations IAM appropriées
Se connecter avec Bedrock
Si vous disposez d’identifiants AWS et souhaitez commencer à utiliser Claude Code via 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.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.
Démarrer Claude Code et choisir Bedrock
Exécutez
claude. À l’invite de connexion, sélectionnez 3rd-party platform, puis Amazon Bedrock.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 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./setup-bedrock à tout moment pour rouvrir l’assistant et modifier vos identifiants, votre région ou vos épingles de modèle.
Configuration manuelle
Pour configurer 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.- Assurez-vous que vous disposez des bonnes autorisations IAM décrites ci-dessous
- Accédez à la console Amazon Bedrock
- Sélectionnez un modèle Anthropic dans le catalogue de modèles
- Complétez le formulaire de cas d’usage. L’accès est accordé immédiatement après la soumission.
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 CLIaws login.
Option E : Clés API Bedrock
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). Lorsque Claude Code détecte que vos identifiants AWS ont expiré (soit localement en fonction de leur horodatage, soit lorsque Bedrock retourne une erreur d’identifiants), il exécutera automatiquement vos commandesawsAuthRefresh et/ou awsCredentialExport configurées pour obtenir de nouveaux identifiants avant de réessayer la demande.
Exemple de configuration
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. La sortie est capturée silencieusement et non affichée à l’utilisateur. La commande doit générer du JSON dans ce format :
3. Configurer Claude Code
Définissez les variables d’environnement suivantes pour activer Bedrock :AWS_REGIONest une variable d’environnement requise. Claude Code ne lit pas à partir du fichier de configuration.awspour ce paramètre.- Lors de l’utilisation de Bedrock, les commandes
/loginet/logoutsont désactivées car l’authentification est gérée via les identifiants AWS. - Vous pouvez utiliser des fichiers de paramètres pour les variables d’environnement comme
AWS_PROFILEque vous ne voulez pas divulguer à d’autres processus. Voir Paramètres pour plus d’informations.
4. Épingler les versions de modèle
Définissez ces variables d’environnement sur des ID de modèle Bedrock spécifiques. SansANTHROPIC_DEFAULT_OPUS_MODEL, l’alias opus sur Bedrock se résout à Opus 4.6. Définissez-le sur l’ID Opus 4.7 pour utiliser le dernier modèle :
us.). Si vous utilisez un préfixe de région différent ou des profils d’inférence d’application, ajustez en conséquence. 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-sonnet-4-5-20250929-v1:0 |
| Modèle petit/rapide | us.anthropic.claude-haiku-4-5-20251001-v1:0 |
La mise en cache des invites peut ne pas être disponible dans toutes les régions. Les écritures de cache avec un TTL d’une heure sont facturées à un taux plus élevé que les écritures de cinq minutes.
Mapper chaque version de modèle à un profil d’inférence
Les variables d’environnementANTHROPIC_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 :
/model, Claude Code appelle Bedrock avec l’ARN mappé. Les versions sans remplacement reviennent à l’ID de modèle Bedrock intégré ou à tout profil d’inférence correspondant découvert au démarrage. 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 Bedrock configuré, il vérifie que les modèles qu’il a l’intention d’utiliser sont accessibles dans votre compte. Cette vérification nécessite Claude Code v2.1.94 ou version ultérieure. 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. Le retour n’est pas persistant. Activez le modèle plus récent dans votre compte Bedrock ou épinglez une version pour rendre le choix permanent.Configuration IAM
Créez une politique IAM avec les autorisations requises pour Claude Code :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.
Créez un compte AWS dédié pour Claude Code pour simplifier le suivi des coûts et le contrôle d’accès.
Fenêtre de contexte de 1M de jetons
Claude Opus 4.7, Opus 4.6 et Sonnet 4.6 prennent en charge la fenêtre de contexte de 1M de jetons sur Amazon Bedrock. 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éfinissezANTHROPIC_BEDROCK_SERVICE_TIER sur default, flex ou priority :
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 :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 configurationawsAuthRefresh décrites précédemment sur cette page.
Mantle nécessite Claude Code v2.1.94 ou version ultérieure. Exécutez
claude --version pour vérifier.Activer Mantle
Avec les identifiants AWS déjà configurés, définissezCLAUDE_CODE_USE_MANTLE pour acheminer les demandes vers le point de terminaison Mantle :
AWS_REGION. Pour la remplacer 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 avecanthropic. et sans suffixe de version, par exemple 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 :
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 deCLAUDE_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.
/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, donc incluez chaque alias que vous souhaitez garder disponible :
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êtesx-api-key :
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ètreawsAuthRefresh 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 :- Vérifiez la disponibilité du modèle :
aws bedrock list-inference-profiles --region your-region - Basculez vers une région prise en charge :
export AWS_REGION=us-east-1 - Envisagez d’utiliser des profils d’inférence pour l’accès inter-régions
- Spécifiez le modèle comme ID de profil d’inférence
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.