API Claude : créer sa clé API et envoyer sa première requête (tutoriel)

L’API Claude permet à vos propres outils de parler à Claude : un formulaire de site, un tableur, une application interne. Il vous faut pour cela une clé API, créée dans la Claude Console, et des crédits : Anthropic facture chaque requête selon le nombre de tokens utilisés.

Claude est l’IA que j’utilise pour mon propre travail. L’application interne que j’ai développée sur mesure pour Pilotech, pour gérer les prospects, les chantiers, la communication avec les salariés, l’agenda et les analyses comptables, intègre aussi de l’IA et la téléphonie. Ces fonctions ne passent pas par un abonnement à un assistant IA : elles passent par une API, avec sa propre clé et sa propre facture.

Les noms des menus et des boutons sont en anglais, tels que la documentation d’Anthropic les donne en octobre 2026. Pour savoir où l’IA a sa place dans une petite entreprise, commencez par mon guide IA pour TPE et PME.

API, clé API, token : les mots à connaître

Quatre mots reviennent à chaque étape :

• API (interface de programmation) : une porte qui permet à un logiciel d’envoyer une demande à un autre et de recevoir une réponse, sans que personne ne clique.
• API Claude : la porte d’Anthropic vers ses modèles Claude. Votre outil envoie un texte, Claude renvoie sa réponse sous forme de données exploitables.
• Clé API : une longue chaîne secrète qui identifie votre compte dans chaque requête. Qui la détient peut dépenser vos crédits.
• Token (jeton) : l’unité que l’API compte et facture, un morceau de mot. Sur les modèles actuels, un million de tokens représente environ 555 000 mots selon Anthropic ; le nombre exact dépend de la langue.

Les prix s’entendent par million de tokens, avec un tarif pour l’entrée (ce que vous envoyez : vos consignes et le texte à traiter) et un tarif plus élevé pour la sortie (ce que Claude écrit).

L’application Claude et l’API Claude se paient séparément

L’abonnement Claude Pro n’inclut pas l’usage de l’API. Les forfaits Max font exception : d’après la page des offres d’Anthropic, ils incluent de 100 à 200 $ de crédits API par mois. Si vous voulez seulement discuter, rédiger ou faire des recherches avec Claude, vous n’avez pas besoin de l’API : mon comparatif Claude ou ChatGPT porte sur les applications. L’API sert le jour où c’est un outil, et non une personne, qui pose les questions.

Étape 1 : créer votre compte sur la Claude Console

La Claude Console est le site d’Anthropic pour les développeurs, à l’adresse platform.claude.com. Connectez-vous, ou créez un compte si vous n’en avez pas. Vous y gérez vos clés, vos crédits, vos plafonds et votre consommation, et vous pouvez y tester des prompts dans le navigateur avant d’écrire du code.

Étape 2 : créer votre clé API Claude

1. Dans la Console, ouvrez la page API keys (platform.claude.com/settings/keys).
2. Cliquez sur Create key.
3. Donnez à la clé un nom qui dit où elle servira, comme formulaire-site ou devis-tableur. Le jour où vous aurez trois clés, vous saurez laquelle révoquer.
4. Choisissez l’expiration : un délai prédéfini, de 3 heures à 30 jours, un délai personnalisé ou Never (jamais). Impossible de la modifier ensuite.
5. Réglez Linked account sur vous-même pour vos tests. Pour un outil partagé, comme un formulaire de votre site, Anthropic recommande une clé de compte de service : une clé personnelle cesse de fonctionner si vous quittez l’organisation.
6. Si vous le souhaitez, choisissez un workspace (espace de travail) pour séparer vos projets.
7. Copiez la clé. Elle commence par sk-ant- et la Console ne l’affiche qu’une seule fois, à la création. Si vous la perdez, impossible de la revoir : créez-en une nouvelle.

Si le bouton Create key est grisé, votre rôle dans l’organisation ne vous permet sans doute pas de créer des clés : demandez à un administrateur. La page d’Anthropic sur les clés API détaille chaque type de clé.

Étape 3 : ranger la clé à l’abri des regards

Les bibliothèques officielles d’Anthropic lisent votre clé dans une variable d’environnement nommée ANTHROPIC_API_KEY : une valeur stockée dans les réglages de votre ordinateur, et non dans votre code. Sur Mac ou Linux, ouvrez le Terminal et tapez :

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

La variable disparaît à la fermeture de la fenêtre. Pour la garder, ajoutez la même ligne au fichier de profil de votre shell (~/.zshrc sur un Mac récent). Sur Windows, ouvrez PowerShell et tapez :

setx ANTHROPIC_API_KEY "sk-ant-..."

Ouvrez ensuite une nouvelle fenêtre : setx enregistre la variable pour les fenêtres suivantes, pas pour celle en cours.

Quatre règles, quel que soit votre projet :

• Jamais dans le code front-end. Tout visiteur peut lire le HTML et le JavaScript de votre site. La requête doit partir d’un serveur ou d’un outil d’automatisation qui détient la clé.
• Jamais dans un dépôt public. Si votre code est sur GitHub, gardez la clé dans un fichier .env listé dans .gitignore, pour qu’elle ne soit jamais envoyée.
• Jamais dans un email ou un document partagé, ni dans une conversation avec un assistant IA.
• Une clé par outil. Vous pourrez en révoquer une sans casser les autres.

Étape 4 : acheter des crédits et fixer un plafond de dépenses

D’après sa page de tarifs, Anthropic offre aux nouveaux utilisateurs une petite quantité de crédits gratuits pour tester l’API. Au-delà, vous achetez des crédits par carte sur la page Billing (platform.claude.com/settings/billing). Tous les paiements se font en dollars américains : votre banque convertit le montant en euros, à son taux de change et avec ses frais éventuels.

Fixez un plafond avant votre première requête, pas après votre première surprise :

1. Ouvrez la page Billing.
2. Dans la section Spend limits, cliquez sur Set limit (ou Adjust limit si un plafond existe déjà).
3. Saisissez un montant mensuel. Il ne peut pas dépasser le plafond de votre palier.

Quand la consommation atteint votre plafond, l’API refuse les requêtes avec un message d’erreur qui indique quand l’accès reprend. Relevez le plafond pour le rétablir plus tôt.

Le plafond de votre palier est de 500 $ par mois en Start, 1 000 $ en Build et 200 000 $ en Scale, selon la page d’Anthropic sur les limites. Une nouvelle organisation peut démarrer dans un palier Evaluation plus bas, dont les limites montent à mesure que le compte accumule un historique.

Étape 5 : envoyer votre première requête avec cURL

cURL est un outil en ligne de commande déjà installé sur macOS et sur la plupart des systèmes Linux. Une fois la clé dans la variable, collez ceci dans le Terminal :

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1000,
    "messages": [
      {"role": "user", "content": "Propose trois objets d’email pour annoncer nos nouveaux horaires d’ouverture."}
    ]
  }'

Ligne par ligne :

• https://api.anthropic.com/v1/messages : l’API Messages, l’adresse de toutes les requêtes.
• x-api-key : votre clé, lue dans la variable, pour qu’elle n’apparaisse jamais dans la commande.
• anthropic-version: 2023-06-01 : la version du format de l’API, obligatoire dans chaque requête (rien à voir avec l’âge du modèle).
• content-type : le corps de la requête est en JSON.
• model : le modèle qui répond ; Anthropic recommande de commencer par claude-opus-5-5.
• max_tokens : le nombre maximal de tokens que Claude peut produire, réflexion comprise. Au-delà, la réponse est coupée.
• messages : la conversation, ici un seul message de votre part (user).

La réponse arrive en JSON. En version abrégée :

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5-5",
  "content": [
    {"type": "text", "text": "..."}
  ],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": ..., "output_tokens": ...}
}

La réponse de Claude se trouve dans le bloc de type text. Si le modèle a réfléchi avant de répondre, un bloc de type thinking peut le précéder : ignorez-le pour l’instant. stop_reason vaut end_turn quand la réponse est complète et max_tokens quand elle a été coupée. usage donne les tokens facturés : dans le guide de démarrage d’Anthropic, une question d’une ligne a utilisé 21 tokens en entrée et sa réponse 305 tokens en sortie, soit environ 0,006 $ avec Opus 5.5.

Sur Windows, PowerShell traite différemment les guillemets et les retours à la ligne de cette commande : passez plutôt par la version Python ci-dessous.

Étape 6 : envoyer la même requête en Python

La bibliothèque Python d’Anthropic ajoute les en-têtes à votre place et relance seule les erreurs temporaires, deux fois par défaut. Si Python n’est pas installé, téléchargez-le sur python.org. Ensuite, sur Mac ou Linux, créez un dossier pour le projet et installez-y la bibliothèque :

mkdir claude-quickstart && cd claude-quickstart
python3 -m venv .venv && source .venv/bin/activate
pip install anthropic

Sur Windows, py -m pip install anthropic suffit. Créez ensuite un fichier quickstart.py :

import anthropic

client = anthropic.Anthropic()  # lit ANTHROPIC_API_KEY

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "Propose trois objets d’email pour annoncer nos nouveaux horaires d’ouverture.",
        }
    ],
)

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

print(message.usage)

Lancez-le avec python quickstart.py (py quickstart.py sur Windows). Les objets proposés par Claude s’affichent, suivis des tokens consommés. Anthropic publie le même exemple en TypeScript, Java, Go, C#, PHP et Ruby.

Quel modèle choisir, et combien coûte l’API Claude

Pour changer de modèle, il suffit de changer une ligne, la valeur model. Voici les quatre modèles actuels, aux prix d’Anthropic au moment où j’écris (octobre 2026) :

Les prix de Haiku valent pour les prompts jusqu’à 100 000 tokens ; au-delà, ils passent à 0,50 $ et 2,50 $.

Pour estimer un coût, multipliez. Mettons qu’une requête envoie 500 tokens (l’email d’un client et vos consignes) et en reçoive 300 (un brouillon de réponse). Avec Opus 5.5, cela donne 500 × 4 $ / 1 000 000 + 300 × 20 $ / 1 000 000 = 0,008 $, soit environ 8 $ pour mille réponses. Les mêmes mille réponses coûtent environ 0,20 $ avec Haiku 5.5 et 20 $ avec Fable 5.1. Sur Opus 5.5 et Fable 5.1, la réflexion est toujours active : le modèle décide combien de temps il raisonne avant de répondre, et ce raisonnement est facturé comme des tokens de sortie. Vérifiez usage sur de vraies requêtes avant de vous fier à une estimation.

Dans mon travail, Claude, et Fable 5.1 en particulier, s’est montré extrêmement précis. Fable coûte deux fois et demie plus cher qu’Opus 5.5 : commencez avec Opus 5.5, puis passez la ligne model à claude-fable-5-1 pour les requêtes où une erreur vous coûterait plus que la différence.

Deux réductions à connaître dès le départ :

• La Batch API divise par deux le prix de l’entrée et de la sortie pour les requêtes qui peuvent attendre : vous envoyez un lot, puis vous récupérez les résultats plus tard. Réécrire une centaine de fiches produits pendant la nuit en est l’exemple type.
• Le prompt caching (mise en cache) garde en mémoire les consignes que vous renvoyez à chaque requête. Leur écriture en cache coûte un peu plus qu’une entrée normale ; leur relecture coûte 5 % du prix normal de l’entrée sur Opus 5.5 et Sonnet 5.5.

Les erreurs courantes et comment les corriger

Les erreurs arrivent en JSON, avec un type et un message qui indique en général le problème. Les plus courantes :

Chaque réponse porte aussi un identifiant de requête, request_id dans une erreur. Si vous contactez le support d’Anthropic au sujet d’une requête, indiquez cet identifiant.

Suivre sa consommation dans la Console

Deux pages de la Console montrent où part l’argent :

• Usage (platform.claude.com/usage) : des graphiques des tokens et des requêtes, avec votre marge sous les limites de débit. Regardez-la après le premier vrai jour d’utilisation, puis une fois par mois.
• Rate limits (platform.claude.com/usage/limits) : votre palier, vos limites par modèle et le bouton Request tier increase.

Un pic que vous ne savez pas expliquer mérite un coup d’œil le jour même : un outil qui répète la même requête, ou une clé entre de mauvaises mains, continue de dépenser jusqu’à ce que quelqu’un l’arrête.

Que construire ensuite, et quand faire appel à un développeur

Pour envoyer une première requête, vous n’avez besoin ni de moi ni d’un développeur : si les commandes ci-dessus ont fonctionné, c’est fait. La suite utile, c’est une tâche que vous faites déjà tous les jours, pas dix idées à la fois :

• Répondre plus vite aux prospects. Les alertes et les rappels viennent d’abord ; un brouillon de réponse peut suivre. Mon tutoriel pour automatiser le suivi des prospects met en place les alertes gratuitement.
• Donner des consignes permanentes à Claude. Un prompt system contient ce qui vaut pour chaque requête : votre ton, le vouvoiement, la conduite à tenir quand une information manque.
• Créer un petit outil interne, comme un calculateur de devis. Mon guide pour créer une application avec l’IA dit ce qui est réaliste sans développeur. Vérifiez ensuite qui peut lire ses données.
• Comparer avec OpenAI, dont les étapes se ressemblent beaucoup : voyez mon tutoriel sur l’API ChatGPT (OpenAI).

Avant d’envoyer des données clients via l’API, vérifiez ce que permet le RGPD dans mon guide ChatGPT et RGPD : quelles données clients confier à une IA. L’API a ses propres conditions, mais vos obligations envers vos clients restent les mêmes.

Faites appel à un développeur quand l’intégration se trouve sur votre site, traite des données personnelles, encaisse des paiements ou tourne sans surveillance. Je développe des logiciels pour mon propre usage, pas pour les vendre, et je connais la satisfaction de construire l’outil dont on a besoin. Un outil dont dépend toute une équipe, c’est autre chose : quand j’ai apporté à Pilotech plus de prospects que son équipe ne pouvait en traiter, le client m’a demandé une application pour tout voir clairement et ne jamais oublier de rappeler un prospect. Je raconte ce projet dans mon article CRM sur mesure.