Source: https://aiprimetech.io/fr/learn/claude-code-api-key-setup/

[Accueil](/fr/) / [Apprendre](/fr/learn/) / Clé API Claude Code — ANTHROPIC_API_KEY : comment l’obtenir, la configurer et quand utiliser claude setup-token à la place 

# Clé API Claude Code — ANTHROPIC_API_KEY : comment l’obtenir, la configurer et quand utiliser claude setup-token à la place 

Claude Code a besoin d’une clé API pour fonctionner. Que vous configuriez Claude Code pour la première fois ou que vous migriez d’un compte Anthropic direct vers une passerelle à tarif fixe, la procédure consiste à générer une clé, à configurer deux variables d’environnement et à vérifier la connexion. 

## Clé API Claude Code : l’essentiel 

Une clé API Claude Code est une clé ordinaire au format Anthropic (sk-...) que Claude Code lit depuis ANTHROPIC_API_KEY. Obtenez-en une dans la Claude Console (Paramètres → Clés API, affichée une seule fois) ou dans le tableau de bord de cette passerelle (visible à tout moment), exportez-la et Claude Code démarre sans connexion via le navigateur. Avec une clé de passerelle, vous définissez également ANTHROPIC_BASE_URL sur l’hôte de la passerelle. C’est toute la configuration ; le reste de cette page présente les détails : la différence entre une clé API, le jeton OAuth obtenu via /login et une clé de session claude.ai, les étapes propres à chaque système d’exploitation et les erreurs rencontrées par les utilisateurs. 

## Qu’est-ce qu’une clé API Claude Code ? 

Une clé API Claude Code est l’identifiant d’authentification qui permet à la CLI Claude Code d’envoyer des requêtes à un fournisseur de modèles Claude. Sans elle, chaque commande que vous exécutez dans Claude Code renvoie une erreur d’authentification. La clé est une chaîne de caractères que vous stockez dans une variable d’environnement : soit ANTHROPIC_API_KEY (envoyée dans l’en-tête x-api-key), soit ANTHROPIC_AUTH_TOKEN (envoyée comme jeton Bearer). Les deux fonctionnent avec AI Prime Tech. 

Lorsque vous utilisez une passerelle comme AI Prime Tech au lieu d’Anthropic directement, la clé provient du tableau de bord de la passerelle plutôt que de la console Anthropic. Le format de la clé peut différer, mais la procédure de configuration dans Claude Code est identique : définissez la clé dans votre environnement, faites pointer l’URL de base vers la passerelle et Claude Code s’occupe du reste. Votre clé est liée au solde ou à l’abonnement de votre compte sur la passerelle, et non à la facturation Anthropic. 

Une même clé peut être utilisée simultanément sur plusieurs machines et dans plusieurs sessions Claude Code. Toutefois, si vous partagez une clé au sein d’une équipe, toute l’utilisation est comptabilisée dans les limites de débit et le solde du même compte. Pour une configuration en équipe, générez une clé distincte par développeur depuis le tableau de bord afin que le suivi de l’utilisation et la limitation du débit fonctionnent correctement pour chaque personne. 

## Clé API ou jeton OAuth — et ce qu’est une « clé de session » 

Claude Code accepte deux types d’identifiants. Une clé API (ANTHROPIC_API_KEY, ou ANTHROPIC_AUTH_TOKEN envoyée comme jeton Bearer) entraîne une facturation par jeton imputée à un solde API : c’est ce que vous utilisez avec une passerelle. Un jeton OAuth provient d’un abonnement Claude Pro ou Max : /login dans Claude Code vous connecte, et claude setup-token génère un jeton de longue durée que vous pouvez placer dans un environnement CI ou sur une machine sans interface graphique pour utiliser l’abonnement plutôt qu’un solde API. 

Une « clé de session Claude » n’est ni l’un ni l’autre : il s’agit du cookie de session du navigateur provenant de claude.ai, que certains clients non officiels extraient pour piloter l’interface de chat. Ce n’est pas un identifiant API, son utilisation enfreint les conditions d’utilisation grand public, il expire et il peut entraîner la suspension du compte. Si vous souhaitez un accès programmatique, utilisez une clé API, obtenue depuis la console Anthropic ou une passerelle comme celle-ci. 

## Étape 1 — Obtenir la clé : Claude Console ou tableau de bord de la passerelle 

Deux interfaces délivrent une clé acceptée par Claude Code. Dans la Claude Console (la plateforme Claude à l’adresse platform.claude.com), ouvrez Paramètres → Clés API, cliquez sur Créer une clé, donnez-lui un nom et copiez la valeur secrète de la clé. La console ne l’affiche qu’une seule fois, puis ne répertorie que son nom et son préfixe ; la gestion des clés consiste donc à en créer une nouvelle plutôt qu’à récupérer une ancienne. 

Claude Code a besoin d’une clé standard ; une clé API d’administration est un identifiant différent, destiné à la gestion d’une organisation, et ne permet pas d’authentifier les requêtes. Ensuite, exécutez export ANTHROPIC_API_KEY=sk-ant-... dans votre shell et Claude Code l’utilise sans /login. Anthropic facture par jeton et exige qu’un moyen de paiement soit d’abord ajouté au compte. 

La solution la plus rapide est une clé de passerelle : inscrivez-vous sur aiprimetech.io, ouvrez Clés API dans le tableau de bord, cliquez sur Créer, et la clé reste visible à tout moment dans le tableau de bord. Vous pouvez la recopier, la renommer ou la révoquer quand vous le souhaitez. Elle a le même format sk- et fonctionne avec la même variable ; la seule étape supplémentaire est ANTHROPIC_BASE_URL, décrite à l’étape 2. 

À ce stade, vous avez une clé, mais aucun solde. Ajoutez un petit montant avant de tester : la page des modèles indique ce qu’un dollar permet d’obtenir pour chaque modèle. Vous pouvez aussi choisir un forfait illimité sur /plans/ si vous savez déjà que vous utiliserez Claude Code toute la journée. 

## Étape 2 — Définir les variables d’environnement 

Claude Code lit deux variables d’environnement pour configurer la passerelle : ANTHROPIC_BASE_URL et ANTHROPIC_API_KEY. Définissez ANTHROPIC_BASE_URL sur l’hôte racine de la passerelle, sans suffixe de chemin. Le SDK Anthropic ajoute automatiquement /v1/messages : si vous incluez /v1 dans l’URL de base, les requêtes atteindront /v1/v1/messages et renverront des erreurs 404. 

Sous Linux ou macOS, ajoutez ces lignes au fichier de profil de votre shell (~/.bashrc, ~/.zshrc ou ~/.profile) : export ANTHROPIC_BASE_URL="https://aiprimetech.io" et export ANTHROPIC_API_KEY="votre-clé-ici". Sous Windows, définissez-les comme variables d’environnement système via Paramètres > Système > Paramètres système avancés > Variables d’environnement, ou ajoutez-les à votre $PROFILE PowerShell. 

Pour une configuration propre à chaque projet, créez un fichier .env à la racine de votre projet avec les mêmes variables. Claude Code charge les fichiers .env depuis le répertoire de travail, et leurs valeurs sont prioritaires sur les variables système. C’est utile si vous utilisez différents fournisseurs d’API selon les projets. Veillez à ajouter .env à votre .gitignore pour éviter d’enregistrer accidentellement votre clé dans le système de gestion de versions. 

## Étape 3 — Vérifier la connexion 

Après avoir défini les variables d’environnement, ouvrez une nouvelle session de terminal pour qu’elles soient chargées, puis lancez Claude Code. Saisissez un message simple comme « Bonjour, confirme que tu peux répondre. » Si Claude vous répond, votre configuration fonctionne de bout en bout. La clé est valide, l’URL de base est correcte et la passerelle achemine votre requête vers Claude avec succès. 

Si la vérification échoue, le message d’erreur indique ce qui s’est mal passé. Une erreur 401 ou 403 signifie que la clé API est invalide ou a expiré : copiez-la à nouveau depuis le tableau de bord. Une erreur 404 signifie presque toujours que l’URL de base est incorrecte : vérifiez qu’elle ne contient pas de suffixe /v1 ajouté par erreur ni de barres obliques finales. Une erreur de connexion refusée signifie que la passerelle est inaccessible : vérifiez votre réseau, votre VPN ou les paramètres de votre pare-feu. 

Vous pouvez aussi effectuer une vérification programmatique en appelant le point de terminaison d’état de la passerelle avec curl : curl -H 'Authorization: Bearer YOUR_KEY' https://aiprimetech.io/v1/models — cette commande renvoie la liste des modèles disponibles si votre clé est valide. Si cela fonctionne, mais pas Claude Code, le problème vient du chargement de vos variables d’environnement, et non de la clé ou de la passerelle elle-même. 

## Étape 4 — Configurer les préférences de modèles 

Par défaut, Claude Code utilise ses sélections de modèles intégrées pour chaque catégorie (Sonnet, Opus, Haiku). Vous pouvez les remplacer à l’aide de variables d’environnement supplémentaires : ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL et ANTHROPIC_DEFAULT_FABLE_MODEL. Définissez-les sur les identifiants exacts des modèles pris en charge par la passerelle. 

Pour la plupart des développeurs, définir ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 et ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6 suffit. Claude Code utilise Sonnet par défaut pour la plupart des interactions et fait appel à Opus lorsque vous le sélectionnez via la commande /model ou lorsque le mode plan passe à un modèle plus puissant. La passerelle prend en charge toutes les versions actuelles des modèles Claude. 

Activez la découverte des modèles de la passerelle en définissant CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1. Cela indique à Claude Code d’interroger la passerelle pour connaître les modèles disponibles au lieu d’utiliser une liste codée en dur. Définissez également CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 pour empêcher l’envoi de requêtes de télémétrie à la passerelle : cela réduit le bruit et améliore légèrement la latence des requêtes. 

## Résoudre les erreurs d’authentification courantes 

Le problème le plus fréquent est que les variables d’environnement ne sont pas chargées. Après les avoir définies dans votre fichier de profil, vous devez ouvrir un nouveau terminal : les terminaux existants utilisent l’ancien environnement. Sous Windows, vous devrez peut-être redémarrer entièrement votre application de terminal, et pas simplement ouvrir un nouvel onglet. Vérifiez avec echo $ANTHROPIC_BASE_URL (bash/zsh) ou echo $env:ANTHROPIC_BASE_URL (PowerShell). 

Si vous obtenez des erreurs « modèle introuvable » malgré une connexion valide, l’identifiant du modèle ne correspond pas à ce que propose la passerelle. Les identifiants de modèles sont sensibles à la casse et propres à chaque version. Consultez le tableau de bord ou le point de terminaison /v1/models pour connaître les identifiants exacts pris en charge. Les erreurs courantes consistent à utiliser « claude-3-opus » au lieu de « claude-opus-4-6 » ou à ajouter des espaces superflus dans la valeur de la variable d’environnement. 

Vérifiez votre solde dans le tableau de bord. Pour continuer sans interruption, ajoutez du crédit à l’usage ou passez à un forfait illimité — 1 jour ($9) ou 1 semaine ($39) pour accéder à tous les modèles à prix fixe, sans facturation par token. 

Copier

```
# Add to ~/.bashrc or ~/.zshrc:
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_API_KEY="your-key-from-dashboard"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Verify connection:
# $ source ~/.bashrc && claude
# Or test the gateway directly:
# $ curl -H "x-api-key: $ANTHROPIC_API_KEY" https://aiprimetech.io/v1/models
```

## Questions fréquentes 

 ANTHROPIC_API_KEY — comment l’obtenir ?

Créez une clé dans la console Claude (Paramètres → Clés API → Créer une clé ; copiez la valeur secrète de la clé lorsqu’elle s’affiche, une seule fois) ou créez-en une ici dans le tableau de bord de la passerelle, où elle reste visible. Exportez-la sous ANTHROPIC_API_KEY ; avec une clé de passerelle, définissez également ANTHROPIC_BASE_URL. Ai-je besoin d’une clé distincte pour Claude Code et les autres outils ?

Non. La même clé API fonctionne avec Claude Code, Cursor, Cline, Aider et tout autre outil utilisant l’API Messages d’Anthropic ou un point de terminaison compatible avec OpenAI. Une seule clé, plusieurs outils. Une clé de session Claude est-elle la même chose qu’une clé API ?

Non. Une clé de session est le cookie de navigateur claude.ai utilisé par des clients non officiels ; une clé API est l’identifiant attendu par l’API et Claude Code. Seule la clé API est prise en charge, facturée et stable. Comment obtenir un ANTHROPIC_API_KEY ?

Depuis la console d’Anthropic (facturation au tarif catalogue sur votre compte Anthropic) ou depuis le tableau de bord de cette passerelle (facturation sur des crédits achetés à un prix inférieur à leur valeur nominale, ou sur un forfait illimité). Dans les deux cas, renseignez la variable d’environnement ANTHROPIC_API_KEY. Que fait claude setup-token fait-il ?

Il crée un token OAuth de longue durée pour un abonnement Claude afin que Claude Code puisse fonctionner en CI ou sans interface, sans connexion interactive. Il utilise le quota de l’abonnement, et non les crédits API ; avec une passerelle, vous utilisez plutôt une clé API. ANTHROPIC_BASE_URL doit-il inclure /v1 ?

Non. Définissez uniquement l’adresse racine de l’hôte : https://aiprimetech.io — le SDK Anthropic ajoute automatiquement /v1/messages. Inclure /v1 entraîne un chemin doublé qui renvoie des erreurs 404. Puis-je utiliser la même clé sur plusieurs machines ?

Oui. Une seule clé fonctionne simultanément sur tous vos appareils. Toute l’utilisation est comptabilisée dans le solde et les limites de débit du même compte. Pour les équipes, générez une clé distincte par développeur afin de suivre leur utilisation séparément.  

Commencez à utiliser Claude en quelques minutes

Obtenez une clé API — aucun compte Anthropic ni inscription sur liste d’attente requis.[Obtenir votre clé API](/register) 

AI Prime Tech est une passerelle API indépendante. Elle n’est ni affiliée à Anthropic, ni approuvée par Anthropic, ni revendeuse d’Anthropic. Claude et les noms de modèles associés sont des marques de leurs propriétaires respectifs.    

## Autres guides sur l’API Claude

[Comment obtenir une clé API Claude](/fr/learn/how-to-get-a-claude-api-key/)[Comprendre la tarification de l’API Claude](/fr/learn/claude-api-pricing-explained/)[La façon la moins chère d’utiliser l’API Claude](/fr/learn/cheapest-way-to-use-claude-api/)[Cursor illimité avec l’API Claude](/learn/use-claude-api-with-cursor/)[Accès illimité à Claude Code](/fr/learn/use-claude-api-with-claude-code/)[Passerelle API Claude ou accès direct à Anthropic](/fr/learn/claude-api-vs-anthropic-direct/)[Utiliser Claude via une API compatible avec OpenAI](/fr/learn/openai-compatible-claude-api/)[Comprendre les modèles Claude : comparaison de Claude Opus, Sonnet, Haiku et Fable — tous les modèles de l’API Claude, noms des modèles Anthropic et prix (2026)](/fr/learn/claude-api-models-compared/)[Payer l’API Claude en cryptomonnaies](/fr/learn/claude-api-with-crypto-payment/)[Accéder à l’API Claude sans liste d’attente](/fr/learn/claude-api-without-waitlist/)[Comment réduire la consommation de tokens de Claude](/fr/learn/how-to-reduce-claude-token-usage/)[Cline illimité avec l’API Claude](/fr/learn/use-claude-api-with-cline/)[Roo Code illimité avec l’API Claude](/fr/learn/use-claude-api-with-roo-code/)[Claude illimité dans les IDE JetBrains](/fr/learn/use-claude-api-with-jetbrains/)[Utiliser Aider sans limites avec l’API Claude](/fr/learn/use-claude-api-with-aider/)[Claude illimité dans VS Code](/fr/learn/use-claude-api-with-vscode/)[Utiliser OpenCode sans limites avec l’API Claude](/fr/learn/use-claude-api-with-opencode/)[Exécuter un agent Hermes sans limites sur Claude](/fr/learn/run-hermes-agent-with-claude-api/)[Utiliser OpenClaw sans limites avec Claude](/fr/learn/run-openclaw-with-claude-api/)[Ce que signifie une API compatible avec Anthropic](/fr/learn/anthropic-compatible-api/)[Coûts de l’API Claude Code — Tarifs et moyens de les réduire](/fr/learn/claude-code-api-costs/)[Les erreurs de l’API Claude expliquées : erreur serveur 500, surcharge 529, limite de débit 429, requête incorrecte 400 — et le correctif pour chacune](/fr/learn/claude-api-errors-troubleshooting/)[Comment acheter des crédits pour l’API Claude — et pourquoi un crédit Claude vaut mieux que toute offre d’« achat de compte Claude »](/fr/learn/buy-claude-api-credits/)[API Claude gratuite : existe-t-il une clé API Claude gratuite, et qu’est-ce qui est réellement gratuit en 2026 ?](/fr/learn/claude-api-free-trial/)[API Claude ou abonnement Claude Pro/Max — Que choisir](/fr/learn/claude-api-vs-subscription/)[Exécuter la CLI Codex sur Claude](/fr/learn/use-claude-api-with-codex/)[Connecter Claude à n8n](/fr/learn/use-claude-api-with-n8n/)[Router LiteLLM vers Claude](/fr/learn/use-claude-api-with-litellm/)[Utiliser Claude dans Kilo Code](/fr/learn/use-claude-api-with-kilo-code/)[Intégrer Claude à GitHub Copilot](/fr/learn/use-claude-api-with-github-copilot/)[Connecter Zed à Claude via la passerelle](/fr/learn/use-claude-api-with-zed/)[Connecter Cherry Studio à Claude](/fr/learn/use-claude-api-with-cherry-studio/)[Configurer LangChain pour utiliser Claude via la passerelle](/fr/learn/use-claude-api-with-langchain/)[Utiliser Factory Droid avec Claude](/fr/learn/use-claude-api-with-factory-droid/)[L’API de Claude Code expliquée](/fr/learn/claude-code-api/)[Intégrer l’API Claude à votre application](/fr/learn/claude-api-integration/)[Comment utiliser Claude sans limites — et pourquoi il n’existe pas de « Claude Code piraté »](/fr/learn/get-unlimited-claude-usage/)