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 :

  1. Naviguez vers la console Amazon Bedrock
  2. Allez dans Accès aux modèles dans la navigation de gauche
  3. Demandez l’accès aux modèles Claude souhaités (par exemple, Claude Sonnet 4)
  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

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)

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

export AWS_PROFILE=your-profile-name

3. Configurer Claude Code

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

# Activer l'intégration Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # ou votre région préférée

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èleValeur par défaut
Modèle principalus.anthropic.claude-3-7-sonnet-20250219-v1:0
Modèle petit/rapideus.anthropic.claude-3-5-haiku-20241022-v1:0

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

# Utilisation de l'ID de profil d'inférence
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'

# Utilisation de l'ARN de profil d'inférence d'application
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

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” :

Ressources supplémentaires