Claude Code sur Amazon Bedrock

​

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 des identifiants)
• Permissions IAM appropriées

​

Configuration

​

1. Activer l’accès au modèle

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 au modèle 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 :

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

Option D : Clés API Bedrock

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

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

​

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

# Optionnel : Remplacer la région pour le modèle petit/rapide (Haiku)
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

​

4. Configuration du modèle

Claude Code utilise ces modèles par défaut pour Bedrock :

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 du profil d'inférence d'application
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

# Optionnel : Désactiver la mise en cache des prompts si nécessaire
export DISABLE_PROMPT_CACHING=1

​

Configuration IAM

Créez une politique IAM avec les permissions requises pour Claude Code :

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*"
      ]
    }
  ]
}

Pour des permissions plus restrictives, vous pouvez limiter la Ressource à des ARN de profil d’inférence spécifiques.

Pour plus de détails, consultez la documentation IAM Bedrock.

​

Dépannage

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

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

​

Ressources supplémentaires

• Documentation Bedrock
• Tarification Bedrock
• Profils d’inférence Bedrock
• Claude Code sur Amazon Bedrock : Guide de configuration rapide