Obtenir une clé API Claude et savoir quand l'utiliser

Créer une clé API Claude prend environ une minute. Deux paramètres que vous choisissez lors de sa création importent plus que la clé elle-même, et la plupart des gens les sautent sans y penser.

Il y a aussi une question qui vaut la peine de se poser avant de commencer : avez-vous vraiment besoin d'une clé Anthropic, ou bien ce que vous construisez appelle-t-il plus d'un fournisseur.

TL;DR

• Les clés se créent dans la Console sur platform.claude.com, dans Paramètres du compte^[1].
• Vous choisissez une expiration quand vous créez la clé. Ce choix se fait une seule fois, à la création^[1].
• Les espaces de travail segmentent les clés et contrôlent les dépenses par cas d'usage^[1].
• L'authentification se fait via l'en-tête x-api-key, ou Authorization. Les SDK lisent ANTHROPIC_API_KEY depuis l'environnement^[1][2].
• Workbench vous permet d'essayer l'API dans le navigateur avant d'écrire du code^[1].
• Si vous appelez Claude à côté de GPT ou Gemini, une seule clé gateway suffit pour les trois au lieu d'avoir trois comptes.

Créer la clé

L'API est accessible par la Console web^[1].

1. Connectez-vous sur platform.claude.com.
2. Essayez d'abord l'API dans le navigateur avec le Workbench sur platform.claude.com/playground, qui ne demande pas de code.
3. Générez la clé dans Paramètres du compte, sur platform.claude.com/settings/keys.
4. Choisissez une expiration en la créant.
5. Placez-la optionnellement dans un espace de travail sur platform.claude.com/settings/workspaces.

Les étapes 4 et 5 sont celles qui méritent qu'on les fasse lentement.

Les deux paramètres que les gens sautent

L'expiration se choisit à la création. Vous fixez la durée de vie de chaque clé au moment où vous la faites^[1]. Une clé avec une longue durée de vie, c'est une clé que vous retrouverez dans un vieux .env l'année prochaine. Pour tout ce qui n'est pas une infrastructure de production durée, une expiration courte est le contrôle de sécurité le meilleur marché qu'il y ait.

Les espaces de travail segmentent les clés et contrôlent les dépenses par cas d'usage^[1]. C'est la fonctionnalité qui transforme « le script de quelqu'un a tourné toute la nuit » d'une mauvaise surprise de facturation en une surprise bornée. Un espace de travail par projet, ou par environnement, signifie qu'une boucle qui s'échappe consomme le budget de cet espace de travail plutôt que celui du compte.

Les deux sont des décisions qu'on prend une fois et avec lesquelles on vit. Aucune n'est modifiable sur une clé déjà en production sans la faire tourner.

Utiliser la clé

Deux en-têtes sont acceptés. Envoyez un seul^[1] :

Les SDK lisent la clé depuis l'environnement automatiquement^[2] :

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

import anthropic

client = anthropic.Anthropic()   # reads ANTHROPIC_API_KEY

resp = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize this changelog."}],
)

C'est toute l'intégration pour un setup mono-fournisseur.

Quand vous n'avez pas besoin d'une clé Anthropic

Le flux Console ci-dessus est la bonne réponse quand Claude est le seul modèle que vous appelez.

Ça cesse d'être la bonne réponse dès que votre produit appelle deux fournisseurs. À ce moment-là vous maintenez un compte Anthropic, un compte OpenAI et un projet Google Cloud, trois relations de facturation, trois ensembles de limites de débit et trois calendriers de rotation de clés, pour exécuter une seule fonctionnalité. Ajouter un quatrième modèle signifie un quatrième de tout.

Une gateway y met fin. reAPI expose Claude par un endpoint /v1/chat/completions compatible OpenAI, donc le même client et la même clé atteignent Claude, GPT et Gemini, et passer de l'un à l'autre c'est changer une chaîne de modèle :

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_REAPI_KEY",
    base_url="https://api.reapi.ai/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "Summarize this changelog."}],
    max_tokens=16000,
)

La surface native Anthropic /v1/messages est disponible aussi, donc un SDK déjà écrit contre le format Anthropic marche après changer l'URL de base.

Les tarifs sont sur reapi.ai/models, et la référence Opus actuelle est sur reapi.ai/docs/claude-opus-5.

Une chose à bien faire sur reAPI

Il y a deux identifiants différents, et les confondre c'est l'erreur la plus courante au premier appel.

Une clé gateway envoyée à un endpoint média échoue, et l'inverse aussi. Si un premier appel retourne une erreur d'authentification et la clé vous semble correcte, vérifiez lequel des deux vous tenez.

FAQ

Où puis-je obtenir une clé API Claude ?

Dans la Console sur platform.claude.com, dans Paramètres du compte sur platform.claude.com/settings/keys^[1].

Puis-je essayer l'API sans écrire du code ?

Oui. Le Workbench sur platform.claude.com/playground exécute les requêtes dans le navigateur^[1].

Comment authentifier une requête ?

Envoyez votre clé dans l'en-tête x-api-key, ou utilisez Authorization. Envoyez un seul, pas les deux^[1].

Quelle variable d'environnement les SDK lisent-ils ?

ANTHROPIC_API_KEY^[2].

Puis-je changer l'expiration d'une clé plus tard ?

L'expiration se choisit quand la clé est créée^[1]. La changer signifie créer une nouvelle clé et la faire tourner.

Comment empêcher un projet de dépenser tout le budget ?

Utilisez les espaces de travail, qui segmentent les clés et contrôlent les dépenses par cas d'usage^[1].

Ai-je besoin d'une clé Anthropic pour utiliser Claude par une gateway ?

Non. Une clé gateway remplace le compte par fournisseur quand vous appelez plusieurs modèles, et l'endpoint est compatible OpenAI.

Pourquoi ma clé reAPI retourne une erreur d'authentification ?

Probablement vous utilisez la clé gateway sur un endpoint média ou la clé média sur la gateway. C'est deux identifiants séparés créés à des endroits séparés.

Décider avant de créer

La partie mécanique de comment obtenir une clé API Claude c'est quatre clics dans la Console. La partie qui vaut la peine de réfléchir c'est les deux paramètres attachés à celle-ci, expiration et espace de travail, parce que les deux se choisissent une seule fois et aucun ne peut se changer après sans faire tourner la clé.

Et la question en dessous de tout ça c'est combien de fournisseurs votre produit va finir par appeler. Un fournisseur, une clé, et le flux Console c'est exactement bien. Trois fournisseurs et l'arithmétique change : trois comptes, trois factures, trois régimes de limite de débit, et un quatrième modèle signifie recommencer. C'est le point où une seule clé gateway cesse d'être une commodité et devient l'architecture plus simple.

Références

1. Anthropic. API overview — Console, Workbench, key creation, expiration, workspaces, and authentication headers. Retrieved July 2026 from docs.claude.com/en/api/overview
2. Anthropic. Get started — setting the API key and first request. Retrieved July 2026 from docs.claude.com/en/docs/get-started

Pour aller plus loin

• reAPI. How to use Claude Opus 5. reapi.ai/blog/how-to-use-claude-opus-5
• reAPI. How to use Claude Code. reapi.ai/blog/how-to-use-claude-code
• reAPI. Model catalog. reapi.ai/models