Obtenir votre clé API Claude

Les « API keys » (clés API) pour l'API Claude (également appelées clés API Anthropic) se trouvent dans la Claude Console. Pour consulter vos clés existantes ou en créer une nouvelle, rendez-vous sur Settings → API keys.

Choisir un type de clé

Lorsque vous créez une clé, vous choisissez son type, qui détermine ce que la clé peut faire, où elle fonctionne et quand elle cesse de fonctionner. Une clé personnelle agit en votre nom et cesse de fonctionner si vous quittez une organisation. Une clé de compte de service représente un compte de service qui peut être utilisé par des charges de travail telles que des pipelines CI, des services de production ou des agents. Utilisez une clé personnelle pour votre propre développement, et une clé de compte de service pour tout ce qui est partagé.

Vous pouvez également créer une clé d'espace de travail, une clé héritée sans propriétaire : elle appartient à l'espace de travail dans lequel vous la créez et continue de fonctionner après le départ de son créateur. Il est préférable d'utiliser une clé personnelle ou une clé de compte de service, car celles-ci cessent automatiquement de fonctionner lorsque le compte associé est retiré de l'organisation.

Créer une clé API

1. 1

   Connectez-vous à la Claude Console

   Rendez-vous sur platform.claude.com et connectez-vous, ou créez un compte si vous n'en avez pas encore.

2. 2

   Ouvrez la page des clés API

   Rendez-vous sur Settings → API keys.

3. 3

   Créez une clé

   Cliquez sur Create key, nommez la clé, choisissez une expiration et définissez Linked account sur vous-même ou sur un compte de service. Vous pouvez également choisir un espace de travail auquel restreindre la portée de la clé.

4. 4

   Copiez et conservez la clé

   La Console n'affiche la clé complète, qui commence par sk-ant-, qu'une seule fois, lors de sa création. Copiez-la et conservez-la dans un endroit sûr, tel qu'un gestionnaire de secrets. Si vous perdez une clé, vous ne pouvez plus la consulter dans la Console. Créez plutôt une nouvelle clé.

Si le bouton Create key de la page des clés API est désactivé, il est possible que votre rôle ne vous autorise pas à y 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.

Utiliser votre clé API

Définissez la clé comme variable d'environnement :

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

Les SDK clients lisent automatiquement ANTHROPIC_API_KEY. Les requêtes HTTP directes envoient la clé dans l'en-tête x-api-key. Si votre clé API fonctionne sur plusieurs espaces de travail, vous devez également envoyer l'en-tête anthropic-workspace-id avec chaque requête à l'API Claude, comme indiqué dans Sélectionner un espace de travail. Pour l'Admin API, consultez Clés API et Admin API.

Pour effectuer votre première requête, suivez le Démarrage rapide, et consultez Authentification pour une vue d'ensemble complète, y compris les identifiants de courte durée avec Workload Identity Federation.

Clés API et Admin API

L'Admin API comprend des points de terminaison permettant de gérer par programmation les clés API de votre organisation, tels que Récupérer une clé API et Lister les clés API. Ces points de terminaison sont destinés aux administrateurs d'organisation qui automatisent la gestion des clés. Ils acceptent une clé Admin API, un jeton OAuth avec la portée org:admin, ou une clé personnelle ou de compte de service qui n'est pas restreinte à un espace de travail spécifique ; les clés d'espace de travail n'y fonctionnent pas. Ils ne renvoient jamais la valeur secrète d'une clé, seulement un indice partiellement masqué.