Comment obtenir une clé API Anthropic (clé API Claude) en 2026 : étapes, crédits et options gratuites

Vous créez une clé API Anthropic (aussi appelée clé API Claude) dans la Claude Console : connectez-vous sur platform.claude.com, ouvrez la page des clés API, cliquez sur Create key (« Créer une clé ») et copiez la clé, qui commence par sk-ant- et ne s'affiche qu'une seule fois. L'API Claude est prépayée : il vous faut donc aussi des crédits sur la page Billing pour que les requêtes aboutissent. Il n'existe pas d'offre API gratuite permanente : la FAQ tarifaire d'Anthropic indique seulement que les nouveaux utilisateurs reçoivent une petite quantité de crédits gratuits pour tester l'API, sans préciser de montant. Des crédits API inclus plus importants accompagnent les plans Max 5x, Max 20x et Team.

Ce guide détaille chaque étape avec les noms exacts de la Console, montre comment définir la variable ANTHROPIC_API_KEY sur macOS, Linux et Windows, effectue une première requête de test, explique le coût des requêtes et liste les erreurs les plus fréquentes avec leurs solutions. Tout a été vérifié dans la documentation et le centre d'aide d'Anthropic le 17 octobre 2026.

Ce qu'il vous faut avant de commencer

• Un compte Claude Console. Il est distinct d'un abonnement au chat claude.ai. Vous pouvez vous connecter à la Console avec la même adresse e-mail, mais un plan Pro ou Max ne donne pas, à lui seul, d'accès ni de crédits API.
• Une carte de paiement, ou des crédits inclus. La FAQ tarifaire d'Anthropic indique que les principales cartes bancaires sont acceptées pour les comptes standard, et que les clients entreprise peuvent obtenir une facturation sur facture. Si vous avez Max 5x, Max 20x ou Team, vous pouvez lier une organisation Console pour recevoir des crédits mensuels au lieu de payer par carte.
• Le bon rôle dans la Console. Acheter des crédits nécessite un rôle Admin ou Billing. Si vous avez été invité dans l'organisation de quelqu'un d'autre et que le bouton Create key est grisé, votre rôle ne permet pas de créer des clés.
• Un endroit où garder le secret. Un gestionnaire de mots de passe ou de secrets. Vous ne voyez la clé qu'une seule fois.

Étape 1 : créer votre clé API dans la Claude Console

1. Allez sur platform.claude.com et connectez-vous, ou créez un compte Claude Console.
2. Ouvrez la page API keys sur platform.claude.com/settings/keys.
3. Cliquez sur Create key, nommez la clé, choisissez une expiration et réglez Linked account (« Compte lié ») sur vous-même (clé personnelle) ou sur un compte de service. Vous pouvez aussi limiter la clé à un workspace.
4. Copiez immédiatement la clé complète et stockez-la dans un gestionnaire de mots de passe ou de secrets. La Console n'affiche la clé qu'une seule fois, à sa création. Si vous la perdez, vous ne pouvez plus la consulter : il faut en créer une nouvelle.

Si le bouton Create key est désactivé, votre rôle dans l'organisation ne permet probablement pas de créer des clés. Demandez à un administrateur de l'organisation de modifier votre rôle ou de créer une clé de compte de service pour vous.

Quel type de clé choisir

La documentation d'authentification d'Anthropic explique pourquoi les clés liées à une identité sont préférables : une clé personnelle ou de compte de service cesse de fonctionner automatiquement lorsque la personne ou la charge de travail concernée est retirée, si bien que les clés ne survivent pas à leurs propriétaires. Une clé personnelle partagée agit au nom d'une seule personne et cesse de fonctionner à son départ : tout ce qui est partagé doit donc utiliser un compte de service.

Choisir une expiration

À la création d'une clé, vous choisissez une expiration prédéfinie de 3 heures, 1 jour, 7 jours ou 30 jours, une durée personnalisée, ou Never (« Jamais ») pour les clés conservées dans un gestionnaire de secrets et que vous renouvelez vous-même. Si votre organisation impose une durée d'expiration maximale, Never n'est pas proposé. L'expiration est fixée à la création et ne peut plus être modifiée. Anthropic envoie un e-mail au créateur de la clé avant l'expiration : 7 jours avant pour les clés d'une durée de vie d'au moins 14 jours, et 1 jour avant pour celles d'au moins 7 jours. Les clés plus courtes expirent sans avertissement. Une clé expirée renvoie une erreur 401 authentication_error et ne peut pas être réactivée ; il faut en créer une nouvelle.

Workspaces et en-tête de workspace

Une clé limitée à un seul workspace ne fonctionne que dans ce workspace, et les requêtes peuvent omettre l'ID du workspace. Une clé personnelle ou de compte de service valable sur plusieurs workspaces nécessite l'en-tête anthropic-workspace-id sur chaque requête à l'API Claude. L'ID d'un workspace figure dans la colonne ID de la page Workspaces, sur platform.claude.com/settings/workspaces. Pour une première clé, la limiter à un seul workspace est le choix le plus simple.

Étape 2 : ajouter des crédits (facturation)

L'usage de l'API Claude et du playground de la Console est payé avec des crédits d'usage prépayés. Sans crédits, les requêtes échouent avec une erreur de solde de crédits.

1. Connectez-vous à la Console avec un rôle Admin ou Billing.
2. Allez dans Settings > Billing, cliquez sur Buy credits (« Acheter des crédits »), saisissez un montant et confirmez. Les crédits achetés sont disponibles immédiatement.
3. Facultatif : dans la section Credit balance, cliquez sur Set up auto-reload (recharge automatique). Indiquez un seuil dans When credit balance reaches et un montant cible dans Bring credit balance back up to. Si votre solde est déjà égal ou inférieur au seuil, vous êtes débité immédiatement pour le ramener au montant cible, taxes applicables en plus. Pour l'arrêter plus tard, cliquez sur Manage auto-reload, puis Turn off.
4. Recommandé : dans la section Spend limits de la page Billing, cliquez sur Adjust limit (ou Set limit) pour plafonner vos dépenses mensuelles. Votre propre limite ne peut pas dépasser le plafond de votre niveau.

Selon le centre d'aide d'Anthropic, les crédits achetés expirent un an après la date d'achat, cette échéance ne peut pas être prolongée, et aucun achat de crédits n'est remboursable. Les crédits expirés apparaissent dans Invoice history sur la page Billing. Anthropic ne publie pas de montant minimum d'achat dans cet article. Pour les prix par token, consultez les prix de l'API Claude.

Niveaux d'usage et plafonds de dépenses mensuels

Chaque organisation a aussi un niveau d'usage avec un plafond de dépenses mensuel. Anthropic place automatiquement les organisations dans un niveau selon leur historique d'usage et la situation de leur compte. Les nouvelles organisations peuvent démarrer dans un niveau Evaluation aux limites plus basses, qui augmentent automatiquement à mesure que l'historique se construit. Vous pouvez voir votre niveau sur la page Rate limits, sur platform.claude.com/usage/limits, et demander une hausse via Request tier increase sur la même page.

Quand votre organisation atteint le plafond de son niveau, l'usage de l'API est suspendu jusqu'à 00:00 UTC le premier jour du mois suivant, sauf si vous obtenez une limite plus élevée avant. Quand elle atteint une limite de dépenses plus basse que vous avez fixée vous-même, les requêtes échouent jusqu'à ce que vous releviez ou supprimiez cette limite. La section de dépannage ci-dessous explique comment les distinguer.

Étape 3 : définir la variable d'environnement ANTHROPIC_API_KEY

Les SDK officiels lisent ANTHROPIC_API_KEY automatiquement : vous n'avez donc pas à coller la clé dans votre code. Pour la définir dans la session de terminal en cours sur macOS, Linux ou WSL :

export ANTHROPIC_API_KEY="sk-ant-api03-..."

Cela ne dure que jusqu'à la fermeture de la fenêtre. Pour la conserver dans chaque nouveau terminal, la documentation CLI d'Anthropic ajoute la ligne à votre profil shell. Pour Zsh, le shell par défaut de macOS :

echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.zshrc
source ~/.zshrc

Pour Bash :

echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.bashrc
source ~/.bashrc

Sous Windows, définissez une variable d'environnement utilisateur, puis ouvrez un nouveau terminal pour que la modification prenne effet :

setx ANTHROPIC_API_KEY "sk-ant-api03-..."

Une clé enregistrée dans un profil shell est lisible par tout ce qui s'exécute sous votre utilisateur, et on l'oublie facilement. Si vous remettez plus tard Claude Code sur un abonnement, ou si vous renouvelez la clé, pensez à supprimer ou mettre à jour cette ligne. Pour les serveurs et la CI, utilisez le gestionnaire de secrets de votre plateforme plutôt qu'un fichier de profil.

Étape 4 : effectuer une première requête de test

Les requêtes HTTP directes envoient la clé dans l'en-tête x-api-key (la documentation d'Anthropic indique qu'un en-tête Authorization: Bearer fonctionne aussi). Cette requête, tirée de la documentation d'authentification d'Anthropic, vérifie que la clé et la facturation fonctionnent :

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

Un appel réussi renvoie du JSON avec un tableau content contenant la réponse de Claude. Une erreur renvoie un corps JSON avec un type d'erreur comme authentication_error ; consultez le tableau de dépannage plus bas.

Python

Installez le SDK officiel :

pip install anthropic

Puis appelez l'API. Voici l'exemple de démarrage rapide de la documentation d'Anthropic ; le client récupère ANTHROPIC_API_KEY tout seul :

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What should I search for to find the latest developments in renewable energy?",
        }
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

TypeScript ou JavaScript

npm install @anthropic-ai/sdk

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

const message = await client.messages.create({
  model: "claude-opus-5-5",
  max_tokens: 1000,
  messages: [
    {
      role: "user",
      content: "What should I search for to find the latest developments in renewable energy?"
    }
  ]
});

for (const block of message.content) {
  if (block.type === "text") {
    console.log(block.text);
  }
}

Les SDK officiels relancent deux fois par défaut les échecs temporaires (erreurs de connexion, limites de débit et erreurs 5xx) avec un délai exponentiel, et respectent l'en-tête retry-after lorsqu'il est présent.

Ce que coûteront vos premières requêtes

Vous payez par million de tokens (MTok), avec des prix distincts pour l'entrée et la sortie. Voici les prix standard de la page tarifaire d'Anthropic pour trois modèles actuels :

Exemple chiffré : une petite application envoie 1 000 requêtes par jour, chacune avec 2 000 tokens en entrée et 500 tokens en sortie. Cela fait 2 millions de tokens en entrée et 0,5 million de tokens en sortie par jour.

• Opus 5.5 : 2 × 4 $ + 0,5 × 20 $ = 8 $ + 10 $ = 18 $ par jour
• Sonnet 5.5 : 2 × 2 $ + 0,5 × 10 $ = 4 $ + 5 $ = 9 $ par jour
• Haiku 5.5 : 2 × 0,10 $ + 0,5 × 0,50 $ = 0,20 $ + 0,25 $ = 0,45 $ par jour

Deux remises officielles réduisent encore ce coût : la Message Batches API coûte 50 % moins cher pour les tâches qui n'exigent pas de réponse immédiate, et le prompt caching rend le contexte répété bien moins cher (les lectures en cache sur Sonnet 5.5 coûtent 0,10 $ / MTok au lieu de 2 $). Le tableau complet, avec les prix d'écriture en cache et les anciens modèles, figure sur notre page prix de l'API Claude.

Existe-t-il une clé API Anthropic gratuite ?

Seulement une petite. La FAQ tarifaire d'Anthropic indique que les nouveaux utilisateurs reçoivent une petite quantité de crédits gratuits pour tester l'API ; elle n'en publie pas le montant, et il n'existe pas d'offre gratuite permanente. Pour des essais entreprise prolongés, la FAQ renvoie vers l'équipe commerciale d'Anthropic. Les sites qui distribuent une clé API Claude gratuite sont généralement des revendeurs ou des proxys, pas Anthropic, et vos prompts transiteraient par un tiers. Voici les moyens officiels d'obtenir des crédits API Claude sans les acheter directement :

Exemple de crédits Team tiré de la documentation d'Anthropic : une équipe avec trois sièges Standard et deux sièges Premium reçoit 3 × 20 $ + 2 × 100 $ = 260 $ par mois. Ajouter un siège Premium porte le crédit du mois suivant à 360 $, et la réserve ne dépasse jamais 500 $. Les crédits inclus sont consommés avant les crédits achetés, et une organisation liée à un plan éligible passe au moins au niveau Start (ou au moins Build si ses crédits mensuels dépassent 200 $).

Les crédits API mensuels des plans Max et Team couvrent l'API Claude, Managed Agents, l'Agent SDK et le playground, mais pas Claude Code ni l'usage supplémentaire dans les applications Claude, ni Claude sur Bedrock, Google Cloud ou Microsoft Foundry. Les plans Free, Pro et Enterprise n'en bénéficient pas. Chaque plan est lié à une seule organisation Console, et vous ne pouvez pas modifier ce lien vous-même : choisissez donc l'organisation dans laquelle vous allez développer. Comparez les plans sur les prix de Claude.

Si vous comparez les fournisseurs, notre guide des clés API IA gratuites liste les API qui ont de vraies offres gratuites, et le guide de la clé API Gemini couvre celle de Google, qui dispose bien d'une offre gratuite. Pour des options plus larges, consultez comment obtenir des crédits IA gratuits.

Utiliser votre clé API avec Claude Code

Claude Code peut utiliser la même clé. Si ANTHROPIC_API_KEY est définie, Claude Code vous demande une fois s'il doit l'utiliser et, si vous acceptez, la clé prend le pas sur votre connexion Pro ou Max. L'usage est alors facturé sur vos crédits API plutôt que sur votre abonnement. En mode non interactif (option -p), la clé est toujours utilisée lorsqu'elle est définie. Si vous vous connectez plutôt à Claude Code avec un compte Console, Anthropic indique qu'un workspace « Claude Code » est créé automatiquement dans la Console pour le suivi des coûts.

Pour revenir à votre abonnement, supprimez la variable dans votre shell (et retirez-la de votre profil shell pour qu'elle ne revienne pas) :

unset ANTHROPIC_API_KEY

Lancez ensuite Claude Code et vérifiez quelle connexion est active avec cette commande dans la session :

/status

N'oubliez pas que les crédits API mensuels Max et Team ne paient pas Claude Code. Si une organisation Console ne détient que ces crédits, Claude Code affiche le message Credit balance too low (« solde de crédits insuffisant »). Consultez les prix de Claude Code pour savoir quelle option coûte le moins cher, et comment installer Claude Code pour la configuration.

Résoudre les erreurs de clé API

L'API Claude renvoie une erreur JSON avec un statut HTTP et un type d'erreur. Voici celles que l'on rencontre le plus souvent lors de la configuration d'une nouvelle clé, avec la solution indiquée par la documentation d'Anthropic.

La clé fonctionne avec curl mais pas dans mon application

• Votre application a été lancée depuis un shell ou un service qui n'a jamais chargé la variable. Les variables d'environnement définies dans un terminal n'atteignent pas les programmes lancés ailleurs, comme un IDE ouvert depuis le Dock ou un service systemd. Définissez la variable là où le programme démarre, ou transmettez la clé depuis votre gestionnaire de secrets.
• Sous Windows, une variable définie avec setx n'apparaît que dans les terminaux ouverts ensuite. Fermez et rouvrez le terminal ou l'éditeur.
• Vérifiez qu'une ancienne clé n'écrase pas la nouvelle, par exemple une ligne obsolète dans votre profil shell ou un fichier .env chargé par votre framework.

J'ai perdu ma clé ou je pense qu'elle a fuité

La Console ne peut jamais réafficher le secret d'une clé, et Anthropic précise que l'Admin API ne peut pas non plus récupérer une clé perdue ; elle ne renvoie qu'un indice partiellement masqué. Créez une nouvelle clé, basculez vos applications dessus, puis désactivez ou supprimez l'ancienne sur la page API keys. Disable (désactiver) est réversible (vous pouvez réactiver la clé), tandis que Delete (supprimer) est définitif.

Le bouton Create key est grisé

Votre rôle dans cette organisation ne permet pas de créer des clés. Demandez à un administrateur de l'organisation de modifier votre rôle ou de créer une clé de compte de service pour votre charge de travail. Si vous avez rejoint l'organisation uniquement pour utiliser Claude Code, le rôle Claude Code ne permet de créer que des clés Claude Code.

Je suis limité en débit sur un compte tout neuf

Les nouvelles organisations peuvent démarrer dans le niveau Evaluation, dont les limites sont inférieures à celles du niveau Start standard tant que l'historique du compte se construit. Anthropic indique que ces limites augmentent automatiquement. Anthropic précise aussi qu'une hausse brutale de l'usage peut déclencher des erreurs 429 dues aux limites d'accélération : augmentez donc le trafic progressivement.

Conseils de sécurité pour les clés API

• Ne commitez jamais une clé dans Git et ne la collez jamais dans du code côté client, comme une application web ou mobile. Chargez-la depuis une variable d'environnement ou un gestionnaire de secrets sur un serveur que vous contrôlez.
• Choisissez une expiration à la création de la clé, et utilisez des clés de compte de service pour les systèmes partagés ou en production.
• Donnez à chaque projet son propre workspace avec une limite de dépenses, pour qu'une clé qui fuite ne puisse pas vider tout votre solde.
• Définissez une limite de dépenses d'organisation sur la page Billing, inférieure au plafond de votre niveau.
• Renouvelez vos clés régulièrement. Pour les charges de travail cloud, Anthropic prend aussi en charge Workload Identity Federation, qui remplace les clés longue durée par des jetons de courte durée émis par un fournisseur d'identité que vous utilisez déjà.
• Si une clé fuite, créez-en une nouvelle dans la Console, basculez vos applications dessus, et désactivez ou supprimez l'ancienne. Les clés perdues ne peuvent pas être récupérées.