Coûts, facturation et exploitation22 octobre 2026Flatkey Team

Clé API Anthropic (2026) : comment l’obtenir, types de clés, Claude Code et erreurs

Guide pas à pas de la clé API Anthropic en 2026 : configuration dans Console, clés personnelles et de compte de service, expiration, première requête, Claude Code, coûts et erreurs.

Clé API Anthropic (2026) : comment l’obtenir, types de clés, Claude Code et erreurs

Pour obtenir une clé API Anthropic, connectez-vous à Claude Console, ouvrez API keys, cliquez sur Create key, choisissez un nom, une expiration et un compte lié (vous-même ou un compte de service), puis copiez la clé qui commence par sk-ant-, car Console ne l’affiche qu’une seule fois. Ajoutez un moyen de paiement ou des crédits avant d’appeler l’API : l’usage est facturé au token et les nouveaux comptes ne reçoivent qu’un petit crédit d’essai gratuit, d’après la page de tarifs d’Anthropic au 22 octobre 2026. La même clé fonctionne pour tous les modèles Claude ; il n’existe pas de « clé Claude API » ni de « clé Sonnet » distincte.

Ce guide s’adresse aux développeurs qui ont besoin d’une clé pour des scripts, des agents de code comme Claude Code ou un service en production. Il couvre les types de clés de 2026 (personnelle, compte de service et ancienne clé de workspace), les règles d’expiration, l’en-tête anthropic-workspace-id qui fait échouer beaucoup de premières requêtes, du code fonctionnel, les erreurs 401/400/429 courantes et les cas où une seule clé pour plusieurs fournisseurs est plus simple.

La clé API Anthropic en 60 secondes

Étape	Où	À savoir (vérifié le 22 oct. 2026)
1. Se connecter	platform.claude.com	Les clés API se trouvent dans Claude Console, pas dans l’app de chat claude.ai
2. Ouvrir API keys	Settings → API keys	Si Create key est grisé, votre rôle ne permet pas de créer des clés
3. Créer la clé	Nom, expiration, compte lié, workspace facultatif	Préréglages : 3 heures, 1 jour, 7 jours, 30 jours, personnalisé ou Never
4. Copier une seule fois	Affichée uniquement à la création	Commence par `sk-ant-` ; une clé perdue ne peut plus être consultée
5. Ajouter la facturation	Settings → Billing	Paiement à l’usage en USD ; chaque palier a un plafond de dépenses mensuel
6. Tester	`POST https://api.anthropic.com/v1/messages`	Envoyez la clé via `Authorization: Bearer` (ou l’ancien `x-api-key`)

Source : documentation Anthropic Get your Claude API key et Authentication, vérifiée le 22 octobre 2026.

Étape par étape : créer votre clé API Anthropic

Créez un compte Console ou connectez-vous sur platform.claude.com. L’abonnement de chat Claude et l’API sont facturés séparément, même si les forfaits Max incluent un crédit API mensuel (détails plus bas et dans notre guide des tarifs de l’API Anthropic).
Ouvrez la page API keys. Si votre organisation a plusieurs workspaces, vous pouvez en sélectionner un pour y limiter la clé.
Cliquez sur Create key et remplissez trois champs : un nom explicite (par exemple ci-staging-claude), une expiration et le Linked account. Lier la clé à vous-même crée une clé personnelle ; la lier à un compte de service crée une clé pour des charges de travail partagées.
Copiez la clé immédiatement. La documentation d’Anthropic précise que la clé complète n’est affichée qu’une fois. Rangez-la dans un gestionnaire de mots de passe ou de secrets, jamais dans un dépôt Git.
Ajoutez des crédits ou une carte sur la page Billing. Sans solde, votre première requête échouera même avec une clé valide.
Exportez-la en variable d’environnement pour que les SDK la lisent automatiquement :

export ANTHROPIC_API_KEY="sk-ant-api03-..."   # macOS/Linux, current shell only
# Windows PowerShell:
# setx ANTHROPIC_API_KEY "sk-ant-api03-..."

Quel type de clé choisir ?

En 2026, Anthropic distingue trois types de clés. Choisir le mauvais est la cause la plus fréquente d’une clé qui « cesse soudain de fonctionner » quand quelqu’un quitte l’équipe.

Type de clé	Agit en tant que	Cesse de fonctionner quand	À utiliser pour
Clé personnelle	Vous, avec vos rôles	Vous quittez l’organisation, ou une clé mono-workspace perd ce workspace	Développement local, vos scripts, votre propre Claude Code
Clé de compte de service	Un compte de service	Le compte de service est archivé ou retiré du workspace	Pipelines CI, services en production, agents partagés
Clé de workspace (ancienne)	Personne (appartient au workspace)	Elle expire, est désactivée/supprimée, ou le workspace est archivé	Intégrations existantes uniquement ; à migrer

Données issues de la page Authentication d’Anthropic, 22 octobre 2026. Anthropic recommande les clés personnelles ou de compte de service, car elles sont rattachées à une identité et ne peuvent pas survivre à la personne ou à la charge de travail qui les possède. Pour la production sur AWS, Google Cloud, Azure, GitHub Actions ou Kubernetes, la même page recommande Workload Identity Federation, qui remplace les clés statiques par des jetons de courte durée.

Règles d’expiration à connaître

L’expiration se choisit à la création et ne peut plus être modifiée ensuite.
Anthropic envoie un e-mail au créateur 7 jours avant l’échéance pour les clés d’une durée d’au moins 14 jours, et 1 jour avant pour celles d’au moins 7 jours ; les clés plus courtes expirent sans prévenir.
Après expiration, les requêtes renvoient 401 authentication_error, et une clé expirée ne peut pas être réactivée, seulement supprimée.
Disable est réversible ; Delete est définitif.

Une approche pratique : des clés de 30 jours pour les portables et les agents de code, et des clés de compte de service stockées dans un gestionnaire de secrets (avec rotation) pour les serveurs. Nos guides sur la gestion sécurisée des clés API pour les produits IA et la rotation des clés derrière une passerelle vont plus loin.

Testez votre clé : première requête en curl, Python et Node.js

L’identifiant de modèle ci-dessous, claude-sonnet-5-5, est le modèle Sonnet actuel dans la vue d’ensemble des modèles d’Anthropic au 22 octobre 2026.

curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Reply with the word ok if this key works."}]
  }'

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Reply with the word ok if this key works."}],
)
print(next(b.text for b in msg.content if b.type == "text"))
print("tokens:", msg.usage.input_tokens, "in /", msg.usage.output_tokens, "out")

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

const client = new Anthropic(); // reads ANTHROPIC_API_KEY
const msg = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 256,
  messages: [{ role: "user", content: "Reply with the word ok if this key works." }],
});
console.log(msg.content.find((b) => b.type === "text")?.text);

Un tel test coûte une fraction de centime : au tarif officiel de Sonnet 5.5, 2 $ par million de tokens en entrée et 10 $ par million en sortie (tarifs Anthropic, 22 octobre 2026), 30 tokens d’entrée et 5 de sortie coûtent environ 0,0001 $.

L’en-tête de workspace qui casse les premières requêtes

Si votre clé n’est pas limitée à un workspace, chaque requête doit inclure anthropic-workspace-id, sinon l’API renvoie 400 invalid_request_error avec le message « This API key is not scoped to a workspace... ». L’identifiant se trouve sur la page Workspaces de Console. La correction en Python :

client = anthropic.Anthropic(
    default_headers={"anthropic-workspace-id": "wrkspc_..."}  # only for keys not scoped to a workspace
)

Les clés créées pour un seul workspace peuvent se passer de l’en-tête, c’est pourquoi Anthropic conseille de les limiter dès la création (documentation Authentication).

Utiliser votre clé API Anthropic avec Claude Code

Claude Code peut s’authentifier avec un abonnement claude.ai, une connexion Console, un fournisseur cloud ou une clé API. Selon la documentation d’authentification de Claude Code, vérifiée le 22 octobre 2026 :

Si ANTHROPIC_API_KEY est définie, Claude Code demande au premier lancement s’il doit l’utiliser et saute la connexion par navigateur une fois que vous acceptez.
ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN et le paramètre apiKeyHelper s’appliquent à la CLI, à l’extension VS Code, à l’Agent SDK et à GitHub Actions, mais pas à Claude Desktop ni aux sessions cloud.
apiKeyHelper exécute un script qui renvoie une clé, pratique pour récupérer une clé de courte durée dans un coffre. Si le script échoue trois fois, les requêtes échouent.
Les utilisateurs Console peuvent désormais se connecter sans créer de clé API (Claude Code v2.1.242 ou ultérieur), ce qui enregistre un profil OAuth au lieu d’une clé statique. Supprimez ANTHROPIC_API_KEY avant de le faire.

export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude        # approve the key when prompted
# inside Claude Code, /status shows which credential is active

Si Claude Code signale des erreurs de jeton ou de connexion, consultez notre guide des erreurs de jeton d’authentification Claude Code. Pour faire passer Claude Code par un routeur plutôt que directement par Anthropic, voyez la configuration d’un routeur API pour Claude Code.

La clé API Anthropic est-elle gratuite ?

Créer une clé est gratuit. L’utiliser ne l’est pas. La FAQ tarifaire d’Anthropic indique que les nouveaux utilisateurs reçoivent « une petite quantité de crédits gratuits pour tester l’API » ; ensuite, chaque requête est facturée au token. Une exception à connaître : sur claude.com/pricing, vérifié le 22 octobre 2026, le forfait Max 5x (100 $/mois) inclut 100 $ par mois et Max 20x 200 $ par mois de crédits API pour la Claude Platform ; Pro (20 $/mois en facturation mensuelle) n’en inclut aucun. Prix catalogue actuels par million de tokens sur la page de tarifs d’Anthropic, 22 octobre 2026 :

Modèle	ID du modèle	Entrée	Sortie	Lecture du cache
Claude Fable 5.1	`claude-fable-5-1`	$10.00	$50.00	$0.25
Claude Opus 5.5	`claude-opus-5-5`	$4.00	$20.00	$0.20
Claude Sonnet 5.5	`claude-sonnet-5-5`	$2.00	$10.00	$0.10
Claude Haiku 5.5 (prompts jusqu’à 100K)	`claude-haiku-5-5`	$0.10	$0.50	$0.01

La Batch API divise par deux les prix d’entrée et de sortie, et l’inférence limitée aux États-Unis (inference_geo: "us") applique un multiplicateur de 1,1x. Pour chiffrer une charge de travail, consultez notre guide complet des tarifs de l’API Anthropic. Si vous cherchez un modèle vraiment gratuit pour prototyper, notre comparatif des API LLM gratuites liste des options avec leurs limites réelles.

Plafonds de dépenses et limites de débit accompagnent la clé

Le palier d’usage de votre organisation détermine à la fois les limites de débit et un plafond de dépenses mensuel. D’après la page des limites d’Anthropic, vérifiée le 22 octobre 2026, les plafonds sont de 500 $ (Start), 1 000 $ (Build) et 200 000 $ (Scale) par mois ; les nouvelles organisations peuvent démarrer dans un palier Evaluation inférieur. Une fois le plafond atteint, l’API renvoie HTTP 429 jusqu’à 00:00 UTC le 1er du mois suivant, sauf si vous demandez un palier supérieur. Vous pouvez aussi fixer votre propre limite plus basse sur la page Billing, une bonne habitude pour toute clé utilisée par un agent autonome.

Erreurs courantes de clé API Anthropic et solutions

Erreur	Cause probable	Solution
`401 authentication_error`	Clé mal saisie, révoquée, désactivée ou expirée	Créez une nouvelle clé ; une clé expirée ne peut pas être réactivée
`400 invalid_request_error` mentionnant le workspace	Clé non limitée à un workspace et aucun en-tête envoyé	Ajoutez `anthropic-workspace-id` ou créez une clé limitée à un workspace
`404 not_found_error` « Workspace ... not found »	Mauvais ID de workspace, ou l’identité de la clé n’y a pas accès	Vérifiez l’ID sur la page Workspaces
`429` « reached your API usage limits »	Plafond de dépenses mensuel du palier atteint	Demandez un palier supérieur ou attendez la remise à zéro mensuelle
`429` avec `retry-after`	Requêtes ou tokens par minute dépassés	Patientez puis réessayez ; voir les limites de débit des LLM expliquées
`529 overloaded_error`	Capacité d’Anthropic, pas votre clé	Réessayez avec backoff ou basculez ; voir l’erreur API 529
Bouton Create key désactivé	Votre rôle Console ne peut pas créer de clés	Demandez à un administrateur un changement de rôle ou une clé de compte de service

Sources : documentation Anthropic Authentication, limites de débit et erreurs, vérifiée le 22 octobre 2026.

Protéger la clé

Ne collez jamais la clé dans du code front-end, une app mobile ou un notebook public. Pour les apps iOS et macOS qui doivent appeler Claude directement, Anthropic propose App Attest, qui émet des jetons d’appareil valables 1 heure.
Utilisez une clé par environnement et par agent pour pouvoir en révoquer une sans casser les autres.
Définissez une expiration, même longue, pour qu’une clé divulguée ait une durée de vie limitée.
Activez l’analyse des secrets en CI ; notre guide d’analyse des secrets d’API IA montre une configuration.
Surveillez l’usage dans Console et fixez une limite de dépenses inférieure au plafond de votre palier.

Quand une seule clé pour plusieurs modèles est plus simple

Une clé Anthropic ne donne accès qu’à Claude. Si votre produit ou votre agent de code appelle aussi GPT, Gemini, DeepSeek, Qwen ou Kimi, vous finissez par gérer cinq clés, cinq soldes et cinq jeux de limites. Une API unifiée comme Flatkey émet une seule clé pour tous. Le 22 octobre 2026, les pages modèles de Flatkey affichaient Claude Sonnet 5.5 à 1,60 $ en entrée / 8,00 $ en sortie par million de tokens et Claude Opus 5.5 à 3,20 $ / 16,00 $, contre des prix catalogue Anthropic de 2 $ / 10 $ et 4 $ / 20 $. Le SDK Anthropic fonctionne en changeant la base URL, selon le guide du SDK Anthropic de Flatkey :

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Summarize this changelog in 3 bullets."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Gardez une clé Anthropic directe si vous avez besoin des fonctions propres à Anthropic dès leur sortie, de Workload Identity Federation, de contrôles de résidence des données ou d’un contrat entreprise. Pour une comparaison plus large, lisez Flatkey ou comptes fournisseurs directs et une clé API pour plusieurs modèles d’IA.

FAQ

Comment obtenir une clé API Anthropic ?

Connectez-vous à Claude Console sur platform.claude.com, allez dans Settings → API keys, cliquez sur Create key, définissez un nom, une expiration et un compte lié, puis copiez la clé sk-ant- affichée une seule fois. Ajoutez des crédits sur la page Billing avant d’envoyer des requêtes.

Les clés API Anthropic sont-elles gratuites ?

La clé est gratuite à créer et les nouveaux comptes reçoivent un petit crédit d’essai, mais l’usage de l’API est ensuite facturé au token. Au 22 octobre 2026, il n’existe pas de palier gratuit permanent pour l’API Claude.

Une clé Claude API est-elle la même chose qu’une clé API Anthropic ?

Oui. La documentation d’Anthropic indique que les clés de l’API Claude sont aussi appelées clés API Anthropic. Une seule clé fonctionne pour tous les modèles Claude auxquels votre organisation a accès.

Où retrouver ma clé API Anthropic existante ?

Sur platform.claude.com/settings/keys, vous voyez le nom, l’indice et l’expiration de chaque clé, mais pas le secret complet. Si vous l’avez perdue, créez-en une nouvelle et supprimez l’ancienne.

Un abonnement Claude Pro ou Max inclut-il des crédits API ?

Pro, non. Les forfaits Max affichent des crédits API mensuels sur claude.com/pricing au 22 octobre 2026 (100 $/mois sur Max 5x, 200 $/mois sur Max 20x). Au-delà, l’usage de l’API via une clé Console est facturé au token, séparément de l’abonnement de chat.

Pourquoi ma clé API Anthropic renvoie-t-elle 401 ?

La clé est mal saisie, désactivée, supprimée ou expirée. Une clé expirée ne peut pas être réactivée ; créez-en une nouvelle. Si l’erreur mentionne un workspace, il s’agit en fait d’un 400 dû à l’absence de l’en-tête anthropic-workspace-id.

Comment utiliser ma clé API Anthropic avec Claude Code ?

Définissez ANTHROPIC_API_KEY dans votre shell, lancez claude et approuvez la clé quand on vous le demande. Utilisez /status dans Claude Code pour vérifier quel identifiant est actif.