Claude Code sur Amazon Bedrock
Apprenez à configurer Claude Code via Amazon Bedrock, y compris la configuration, la configuration IAM et le dépannage.
Prérequis
Avant de configurer Claude Code avec Bedrock, assurez-vous d’avoir :
- Un compte AWS avec l’accès Bedrock activé
- Accès aux modèles Claude souhaités (par exemple, Claude Sonnet 4) dans Bedrock
- AWS CLI installé et configuré (optionnel - nécessaire uniquement si vous n’avez pas d’autre mécanisme pour obtenir les identifiants)
- Permissions IAM appropriées
Configuration
1. Activer l’accès aux modèles
Tout d’abord, assurez-vous d’avoir accès aux modèles Claude requis dans votre compte AWS :
- Naviguez vers la console Amazon Bedrock
- Allez dans Accès aux modèles dans la navigation de gauche
- Demandez l’accès aux modèles Claude souhaités (par exemple, Claude Sonnet 4)
- Attendez l’approbation (généralement instantanée pour la plupart des régions)
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 :
Claude Code ne prend actuellement pas en charge la gestion dynamique des identifiants (comme appeler automatiquement aws sts assume-role
). Vous devrez exécuter aws configure
, aws sso login
, ou définir les variables d’environnement AWS_
vous-même.
Option A : Configuration AWS CLI
Option B : Variables d’environnement (clé d’accès)
Option C : Variables d’environnement (profil SSO)
3. Configurer Claude Code
Définissez les variables d’environnement suivantes pour activer Bedrock :
AWS_REGION
est une variable d’environnement requise. Claude Code ne lit pas depuis le fichier de configuration .aws
pour ce paramètre.
4. Configuration des modèles
Claude Code utilise ces modèles par défaut pour Bedrock :
Type de modèle | Valeur par défaut |
---|---|
Modèle principal | us.anthropic.claude-3-7-sonnet-20250219-v1:0 |
Modèle petit/rapide | us.anthropic.claude-3-5-haiku-20241022-v1:0 |
Pour personnaliser les modèles, utilisez l’une de ces méthodes :
Configuration IAM
Créez une politique IAM avec les permissions requises pour Claude Code.
Pour plus de détails, consultez la documentation IAM Bedrock.
Nous recommandons de créer un compte AWS dédié pour Claude Code afin de simplifier le suivi des coûts et le contrôle d’accès.
Dépannage
Si vous rencontrez des problèmes de région :
- Vérifiez la disponibilité des modèles :
aws bedrock list-inference-profiles --region your-region
- Basculez vers une région prise en charge :
export AWS_REGION=us-east-1
- Considérez l’utilisation de profils d’inférence pour l’accès inter-régions
Si vous recevez une erreur “le débit à la demande n’est pas pris en charge” :
- Spécifiez le modèle comme un ID de profil d’inférence