Passer au contenu principal

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.

Claude Platform on AWS est l’API Claude exploitée par Anthropic avec l’authentification AWS, le contrôle d’accès IAM et la facturation AWS Marketplace. Les requêtes atteignent directement l’API d’Anthropic, vous bénéficiez donc des mêmes modèles et fonctionnalités que l’API Claude selon le même calendrier de publication. Vous vous authentifiez avec les identifiants AWS ou une clé API d’espace de travail, et vous payez via AWS Marketplace. Utilisez ce guide pour pointer Claude Code vers un espace de travail que vous avez déjà provisionné via Claude Platform on AWS. Pour l’abonnement AWS et la configuration de l’espace de travail qui précèdent cela, consultez la documentation Claude Platform on AWS.
L’abonnement via AWS Marketplace provisionne une nouvelle organisation Anthropic liée à votre compte AWS. Cette organisation est distincte de toute organisation que vous avez déjà avec Anthropic, et les identifiants ne se transfèrent pas entre elles. Utilisez l’ID d’espace de travail et les clés API de l’organisation liée à AWS, et non d’un compte Claude Console préexistant.

​
Prérequis

Avant de configurer Claude Code, vous avez besoin de :
  • Un abonnement actif à Claude Platform on AWS via AWS Marketplace
  • Un espace de travail dans votre organisation Anthropic liée à AWS, avec son ID d’espace de travail
  • Un principal IAM avec la permission d’invoquer le service Anthropic, ou une clé API limitée à l’espace de travail
  • Des identifiants AWS dans votre environnement, dans ~/.aws/credentials, ou à partir d’un rôle IAM attaché si vous souhaitez l’authentification SigV4. L’AWS CLI n’est requis que pour le flux de connexion SSO.

​
Configuration

​
1. Configurez les identifiants AWS

Claude Code prend en charge deux méthodes d’authentification pour Claude Platform on AWS. Choisissez la méthode qui correspond à la façon dont votre équipe gère l’accès. Option A : Identifiants AWS avec SigV4 Claude Code signe les requêtes avec SigV4 en utilisant la chaîne d’identifiants AWS standard : variables d’environnement, identifiants partagés dans ~/.aws/credentials, rôles IAM, sessions AWS SSO et toute autre source que le SDK AWS prend en charge. Pour une utilisation locale, connectez-vous avec l’AWS CLI avant de démarrer Claude Code. L’exemple ci-dessous utilise un profil SSO, mais toute méthode qui produit des identifiants aux emplacements standard fonctionne. 
aws sso login --profile my-profile
export AWS_PROFILE=my-profile
Pour l’intégration continue et l’automatisation, donnez au runner un rôle IAM avec la permission d’invoquer le service Anthropic et définissez AWS_REGION. La chaîne d’identifiants récupère automatiquement le rôle. Si vos identifiants SSO expirent en cours de session, configurez awsAuthRefresh pour que Claude Code réexécute votre commande de connexion et réessaie au lieu d’échouer. Ajoutez la commande à votre settings.json : 
{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}
Option B : Clé API d’espace de travail Une clé API d’espace de travail est un secret de longue durée, utile lorsque vous ne souhaitez pas gérer les identifiants AWS fédérés. Générez-en une dans la console AWS sous Claude Platform on AWS → API keys et définissez-la comme ANTHROPIC_AWS_API_KEY : 
export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx
La clé est envoyée en tant que x-api-key et prend la priorité sur SigV4, donc tous les identifiants AWS dans votre environnement sont ignorés. Les clés API d’une organisation Claude Console distincte ne fonctionneront pas ici. Traitez les clés API d’espace de travail comme toute autre identifiant de production. Le bloc env du fichier de paramètres utilisateur est un moyen pratique de limiter la clé à votre machine sans l’exporter globalement.
Les commandes /login et /logout ne modifient pas l’authentification Claude Platform on AWS. L’authentification s’effectue via vos identifiants AWS ou votre clé API d’espace de travail, et non via un abonnement Claude.ai.

​
2. Configurez Claude Code

Définissez les variables d’environnement qui acheminent Claude Code via Claude Platform on AWS au lieu de l’API Anthropic par défaut. 
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export AWS_REGION=us-east-1
ANTHROPIC_AWS_WORKSPACE_ID est obligatoire et est envoyé à chaque requête en tant qu’en-tête anthropic-workspace-id. L’URL de base est calculée à partir de AWS_REGION comme https://aws-external-anthropic.{region}.api.aws. Pour remplacer l’URL directement, définissez ANTHROPIC_AWS_BASE_URL. Claude Platform on AWS est optionnel même lorsque des identifiants AWS sont présents dans votre environnement. Bedrock et Foundry prennent la priorité dans l’acheminement des fournisseurs, donc désactivez CLAUDE_CODE_USE_BEDROCK et CLAUDE_CODE_USE_FOUNDRY s’ils sont définis.

​
3. Épinglez les versions de modèle

Claude Platform on AWS utilise les mêmes ID de modèle que l’API Claude directe. Les alias par défaut opus, sonnet et haiku se résolvent aux dernières versions disponibles dans votre espace de travail. Si vous déployez Claude Code pour une équipe, épinglez explicitement les ID de modèle pour qu’une nouvelle version ne déplace pas tout le monde à la fois : 
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
Pour la liste complète des ID de modèle et des alias, consultez Aperçu des modèles. Pour d’autres variables liées aux modèles, consultez Configuration du modèle. La mise en cache des invites est activée automatiquement. Les écritures en cache d’1 heure sont facturées à un taux plus élevé que les écritures de 5 minutes. Pour demander un TTL de cache d’1 heure au lieu de la valeur par défaut de 5 minutes, définissez ENABLE_PROMPT_CACHING_1H=1.

​
Utilisez le SDK Agent

Le SDK Agent lit les mêmes variables d’environnement que l’interface de ligne de commande, donc tout programme qui lance le sous-processus Claude Code peut cibler Claude Platform on AWS en exportant CLAUDE_CODE_USE_ANTHROPIC_AWS, ANTHROPIC_AWS_WORKSPACE_ID et soit ANTHROPIC_AWS_API_KEY soit les identifiants AWS avant l’appel. 
import { query } from "@anthropic-ai/claude-agent-sdk";

process.env.CLAUDE_CODE_USE_ANTHROPIC_AWS = "1";
process.env.ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN";
process.env.AWS_REGION = "us-east-1";

for await (const msg of query({ prompt: "What's in this repo?" })) {
  console.log(msg);
}
Cet exemple s’appuie sur la chaîne d’identifiants AWS ambiante pour SigV4. Pour vous authentifier avec une clé API d’espace de travail à la place, définissez ANTHROPIC_AWS_API_KEY de la même manière. Pour la surface plus large du SDK Agent, consultez Aperçu du SDK Agent.

​
Acheminez via un proxy d’entreprise

Pour acheminer le trafic via un proxy ou une passerelle LLM, définissez ANTHROPIC_AWS_BASE_URL sur l’adresse du proxy. Claude Code envoie les requêtes à cette URL avec les mêmes en-têtes d’espace de travail et d’authentification, donc toute passerelle qui les transfère inchangés fonctionne. 
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com
Si votre passerelle signe elle-même les requêtes, définissez CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1 pour que Claude Code envoie des requêtes non signées et laisse la passerelle ajouter les en-têtes SigV4 avant de les transférer à AWS. Si la passerelle nécessite son propre jeton, définissez-le dans ANTHROPIC_AUTH_TOKEN. 
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

​
Dépannage

Exécutez /status pour voir le fournisseur résolu et tout ID d’espace de travail explicitement configuré, région, remplacement d’URL de base et paramètre d’authentification ignorée. C’est le moyen le plus rapide de confirmer que Claude Code cible Claude Platform on AWS.

​
403 Forbidden ou AccessDenied à chaque requête

Le principal IAM que Claude Code a résolu manque probablement de la permission d’invoquer le service Anthropic dans votre espace de travail. Vérifiez le rôle attaché à votre profil AWS ou au runner qui a démarré Claude Code, et vérifiez qu’il dispose des actions aws-external-anthropic documentées dans la référence des actions IAM. Si vous avez défini ANTHROPIC_AWS_API_KEY, la clé prend la priorité sur SigV4 et une clé obsolète produit la même erreur. Régénérez la clé dans la console AWS sous Claude Platform on AWS → API keys ou désactivez la variable pour revenir à vos identifiants AWS.

​
Les requêtes échouent avec une erreur d’espace de travail manquant

ANTHROPIC_AWS_WORKSPACE_ID est probablement non défini ou vide. Chaque requête Claude Platform on AWS doit inclure l’ID d’espace de travail. Il n’est pas implicite par vos identifiants AWS. Trouvez l’ID sous Workspaces sur la page du service de la console AWS et exportez-le avant de démarrer Claude Code.

​
Les requêtes vont toujours à api.anthropic.com

CLAUDE_CODE_USE_ANTHROPIC_AWS est probablement non défini ou défini sur une valeur qui ne s’analyse pas comme vraie. Définissez-le sur 1 et exécutez /status pour confirmer le fournisseur résolu. Si CLAUDE_CODE_USE_BEDROCK ou CLAUDE_CODE_USE_FOUNDRY est également défini, ceux-ci prennent la priorité sur Claude Platform on AWS.

​
Ressources supplémentaires

L’abonnement Claude Platform on AWS, la configuration de l’espace de travail et d’IAM qui précèdent la configuration de Claude Code sont couverts dans la documentation de la plateforme :