Aller au contenu
Cercle IA Tech · API Un site du réseau Cercle IA Tech

Guide

Obtenir une clé API Claude : la marche à suivre

Créer une clé API Claude dans la Claude Console, choisir son type et son expiration, la ranger, payer l'usage : les étapes de la documentation d'Anthropic.

Mis à jour le

Pour obtenir une clé API Claude, connectez-vous à la Claude Console sur platform.claude.com, ouvrez la page Clés API (platform.claude.com/settings/keys), cliquez sur Créer une clé, nommez-la, choisissez une expiration et le compte lié, puis copiez-la aussitôt : elle commence par sk-ant- et ne s'affiche qu'une seule fois. C'est la procédure décrite par la documentation d'Anthropic, lue le 15/11/2026.

Les étapes, une par une

  1. Créer un compte ou se connecter sur la Claude Console (platform.claude.com). Ce compte est distinct de l'abonnement à l'assistant Claude : voir abonnement et API.
  2. Ouvrir la page Clés API, à l'adresse platform.claude.com/settings/keys.
  3. Cliquer sur « Créer une clé », lui donner un nom parlant (par exemple le nom du projet et l'environnement : « devis-production »).
  4. Choisir l'expiration : 3 heures, 1 jour, 7 jours, 30 jours, une durée personnalisée, ou « Never » (jamais) pour une clé que vous rangez dans un gestionnaire de secrets et faites tourner vous-même. L'expiration se fixe à la création et ne se modifie plus.
  5. Définir le « Compte lié » : vous-même, ou un compte de service.
  6. Limiter la clé à un espace de travail si vous le souhaitez. Une clé non limitée oblige à envoyer l'en-tête anthropic-workspace-id à chaque requête.
  7. Copier la clé et la ranger dans un endroit sûr, comme un gestionnaire de secrets.

Si le bouton Créer une clé est grisé, votre rôle dans l'organisation ne le permet sans doute pas : un administrateur doit changer votre rôle ou créer une clé de compte de service.

Quel type de clé choisir

La documentation distingue trois types de clés :

Type Agit au nom de Cesse de fonctionner quand Usage conseillé
Clé personnelle Vous, avec vos droits Vous quittez l'organisation Votre développement, vos scripts
Clé de compte de service Un compte de service Le compte de service est archivé Tout ce qui est partagé : intégration continue, production, agents
Clé d'espace de travail Personne (elle appartient à l'espace) Elle expire, est supprimée, ou l'espace est archivé Type « hérité », à éviter pour un nouveau projet

Anthropic recommande les deux premiers types, « adossés à une identité » : ils s'arrêtent d'eux-mêmes quand la personne ou le service est retiré de l'organisation. Pour la production sur un cloud (Amazon Web Services, Google Cloud, Azure) ou dans une chaîne d'intégration continue, la documentation propose aussi la fédération d'identité (Workload Identity Federation) : le programme échange un jeton d'identité de courte durée contre un accès temporaire, sans clé statique à stocker.

Utiliser la clé

Placez la clé dans une variable d'environnement :

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

Les bibliothèques officielles (SDK) la lisent automatiquement. En HTTP direct, la clé part dans l'en-tête Authorization: Bearer <clé> ; l'ancien en-tête x-api-key reste accepté. Le premier appel montre une requête complète.

Payer l'usage

D'après le centre d'aide d'Anthropic, l'API fonctionne principalement par crédits prépayés, achetés sur la page Facturation de la Console avant l'usage. Un rechargement automatique peut racheter des crédits quand le solde passe sous un seuil que vous fixez. Les crédits expirent un an après leur achat et ne sont pas remboursables. Les organisations qui ont un accord avec l'équipe commerciale peuvent être facturées au mois. La FAQ tarifaire indique que les nouveaux utilisateurs reçoivent des crédits gratuits pour tester l'API. Tous les paiements se font en dollars américains.

Chaque organisation démarre aussi avec un plafond de dépense mensuel lié à son palier d'usage : 500 dollars au palier Start, 1 000 au palier Build, 200 000 au palier Scale (relevé le 15/11/2026). Le détail est sur la page erreur 429 et limites.

Si la clé fuit

Désactivez-la depuis la page Clés API (la désactivation est réversible) ou supprimez-la (c'est définitif), puis créez-en une autre. Les bonnes pratiques complètes sont sur la page protéger sa clé API.

Questions fréquentes

Où trouver sa clé API Claude ?

Dans la Claude Console, page Clés API (platform.claude.com/settings/keys). La clé complète, qui commence par sk-ant-, n'est affichée qu'une fois, à sa création.

J'ai perdu ma clé API Claude, comment la récupérer ?

On ne peut pas. La Console ne réaffiche jamais une clé : créez-en une nouvelle et désactivez ou supprimez l'ancienne.

La clé API Claude est-elle gratuite ?

La création de la clé ne coûte rien, mais l'usage se paie. Les crédits API sont prépayés et expirent un an après leur achat. La FAQ tarifaire d'Anthropic indique que les nouveaux utilisateurs reçoivent des crédits gratuits pour tester.

Sources

Pages consultées pour écrire cet article :

  1. https://platform.claude.com/docs/fr/get-api-key
  2. https://platform.claude.com/docs/en/manage-claude/authentication
  3. https://support.claude.com/fr/articles/8977456-comment-puis-je-payer-pour-mon-utilisation-de-l-api-claude
  4. https://platform.claude.com/docs/en/about-claude/pricing
  5. https://platform.claude.com/docs/en/api/rate-limits

À lire aussi