API Claude, Console et Workbench, ton premier appel programmatique en 10 minutes

Tu connais déjà claude.ai, la fenêtre de discussion dans ton navigateur. Mais il existe une seconde porte vers Claude, pensée pour les programmes, et c'est elle qu'on ouvre dans ce chapitre.

Cette porte s'appelle l'API (qu'on appelle aussi interface de programmation, c'est le canal qui permet à un programme externe de parler à Claude), et elle te permet d'intégrer Claude dans tes propres scripts et applications.

En 10 minutes de lecture, tu sais créer ton compte développeur sur la Console Anthropic, générer ta première clé d'accès, tester un prompt sans coder dans le Workbench, et envoyer ton premier appel HTTP. Ce guide s'adresse à toute personne qui a déjà utilisé Claude dans son navigateur et qui veut passer à l'intégration programmatique.

Tu lis le chapitre 65 d'un manuel de 67 chapitres disponible sur claude-pour-les-debutants.fr.

Console vs Claude.ai

Pour bien démarrer, tu peux faire la distinction entre les deux portails d'Anthropic.

✦ Tu vas sur claude.ai pour discuter avec Claude dans une interface chat (compte Pro ou Max, paiement mensuel forfaitaire).

✦ Tu vas sur platform.claude.com (l'ancienne URL console.claude.com redirige vers la nouvelle) pour utiliser l'API, gérer tes clés d'accès, et payer à l'usage.

Tu peux résumer la différence avec ce tableau (les tokens sont en gros les unités de comptage de texte qu'Anthropic facture, environ 4 caractères par token).

Console (platform.claude.com)	Claude.ai
Tu utilises l'API et tu paies à l'usage	Tu chats et tu paies un forfait mensuel
Tu testes des prompts dans le Workbench	Tu discutes normalement
Tu gères ton organisation et tes workspaces	Tu as un compte personnel
Tu génères des clés d'accès et des tokens	Pas de clé technique nécessaire
Tu monitores la consommation de tokens	Pas de visibilité usage technique

→ Tu peux avoir les deux comptes en parallèle. Le Console est le portail des développeurs.

Le texte part de ton application vers Claude par le tuyau de l'API et la réponse revient

Les URLs principales à connaître

Pour t'y retrouver dans le Console, tu peux marquer ces 6 URLs.

▸ Tu te connectes sur https://platform.claude.com.

▸ Tu génères et tu gères tes clés d'accès sur https://platform.claude.com/settings/keys.

▸ Tu testes des prompts dans le Workbench sur https://platform.claude.com/workbench.

▸ Tu organises tes clés par projet via les Workspaces sur https://platform.claude.com/settings/workspaces.

▸ Tu règles tes limites de dépense et de débit sur https://platform.claude.com/settings/limits.

▸ Tu monitores ta consommation de tokens en temps réel sur https://platform.claude.com/usage.

↳ Tu utilises le même login Anthropic que pour claude.ai si tu en as déjà un.

Créer ton premier compte développeur

Pour t'inscrire au Console, tu peux suivre ces 5 étapes en 3 minutes.

Étape 1, tu vas sur platform.claude.com et tu cliques Sign up (ou Login si tu utilises déjà claude.ai avec le même email).

Étape 2, tu confirmes ton email via le lien de vérification.

Étape 3, tu ajoutes un moyen de paiement (carte bancaire) à la demande d'Anthropic. Tu commences sans dépense immédiate.

Étape 4, tu peux créer un Workspace par projet pour segmenter la consommation et les budgets (utile si tu factures tes clients).

Étape 5, tu cliques sur Get API key dans le menu Settings.

→ Tu obtiens accès à tous les modèles Claude (Opus, Sonnet, Haiku) et à toutes les fonctionnalités beta (computer use, dreams, vaults).

Générer ta première clé d'accès

Pour générer ta première clé, tu peux passer par l'écran API Keys du Console.

Étape 1, tu cliques Create Key sur platform.claude.com/settings/keys.

Étape 2, tu donnes un nom descriptif à la clé (par exemple script-newsletter-perso).

Étape 3, tu choisis le workspace auquel la clé est rattachée (utile pour cap les budgets).

Étape 4, tu cliques Generate. Tu vois la clé une seule fois à l'écran.

Étape 5, tu copies la clé immédiatement et tu la mets dans un gestionnaire de mots de passe (1Password, Bitwarden) ou dans une variable d'environnement sécurisée sur ton ordinateur.

⚠️ Tu ne vois la clé qu'une seule fois pour des raisons de sécurité. Si tu la perds, tu dois en générer une nouvelle et révoquer l'ancienne.

Tester un prompt sans coder avec le Workbench

Pour valider qu'un prompt fonctionne avant d'écrire du code, tu peux utiliser le Workbench dans ton navigateur.

Étape 1, tu vas sur platform.claude.com/workbench.

Étape 2, tu choisis un modèle dans le menu déroulant (Sonnet recommandé par défaut pour 80 pour cent des cas).

Étape 3, tu colles ton prompt dans la zone de texte system et user.

Étape 4, tu cliques Submit.

Étape 5, tu vois la réponse de Claude et le nombre de tokens consommés (les tokens sont en gros les unités de comptage de texte qu'Anthropic facture, environ 4 caractères par token).

→ Le Workbench est l'équivalent du Console des autres APIs : tu testes en clic-clic avant de coder.

Ton premier appel curl

Pour faire ton tout premier appel programmatique, tu peux copier-coller cette commande dans ton terminal.

curl -X POST https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Explique-moi en 3 phrases ce qu est un agent IA."}
    ]
  }'

Tu commences par exporter ta clé avec export ANTHROPIC_API_KEY=sk-ant-... pour que $ANTHROPIC_API_KEY soit défini dans ton shell.

Tu reçois en réponse un JSON qui contient le champ content avec la réponse de Claude, le champ model avec le modèle utilisé, et le champ usage avec les tokens consommés en entrée et en sortie.

↳ Tu paies un coût total qui est calculé sur le nombre de tokens (les tokens sont en gros les unités de comptage de texte qu'Anthropic facture, environ 4 caractères par token) en entrée plus sortie, multiplié par le tarif du modèle choisi.

Deux compteurs comparés, le forfait fixe de claude.ai et le compteur à l'usage de l'API

La même chose en Python

Pour la même requête, tu peux utiliser le SDK officiel Python.

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Explique-moi en 3 phrases ce qu est un agent IA."}
    ],
)

print(response.content[0].text)
print(f"Tokens consommés : {response.usage.input_tokens} entrée, {response.usage.output_tokens} sortie")

Tu installes le SDK avec pip install anthropic. Tu exportes ta clé avec export ANTHROPIC_API_KEY=sk-ant-....

Le SDK lit automatiquement la variable d'environnement. Tu lances le script avec python3 script.py.

→ Anthropic publie aussi des SDKs officiels en TypeScript, Java, Go, C#, Ruby, et PHP. Tu retrouves la même logique dans chaque langage.

Les headers obligatoires

Tu dois envoyer 3 headers à chaque appel à l'API.

▸ Le header x-api-key contient ta clé d'accès (alternative : Authorization: Bearer <token> via Workload Identity Federation pour l'usage avancé).

▸ Le header anthropic-version contient la version de l'API que tu utilises (par exemple 2023-06-01). Cette version est obligatoire pour qu'Anthropic sache quel format de réponse te renvoyer.

▸ Le header content-type: application/json indique que le body de ta requête est en JSON.

Les SDKs officiels envoient ces 3 headers automatiquement, donc tu n'as pas besoin de les écrire à la main si tu utilises un SDK.

Les limites de taille et de débit

Tu peux atteindre 3 types de limites selon ton usage.

▸ La taille de chaque requête est cappée à 32 Mo pour les endpoints Messages et Token Counting, à 256 Mo pour Message Batches, et à 500 Mo pour Files. Au-delà, tu reçois l'erreur 413 request_too_large.

▸ Le débit est cappé en requêtes par minute (RPM) et en tokens par minute (un token est en gros une unité de comptage de texte, environ 4 caractères, qu'Anthropic utilise pour facturer). Tu as des limites qui sont liées à ton tier d'usage. Tu vois tes limites courantes sur platform.claude.com/settings/limits.

▸ La dépense mensuelle est cappée pour éviter les explosions de facture. Tu peux régler une limite hard (dépense bloquée au-delà) et une limite soft (alerte par email).

↳ Anthropic augmente automatiquement tes limits à mesure que tu consommes, selon un système de tiers progressifs.

Trois panneaux de vigilance le long du chemin qui mène à la porte de la Console

Un dernier mot

Pour la majorité des utilisateurs Claude, tu n'as pas besoin de l'API.

Tu sors l'API le jour où tu veux intégrer Claude dans un script perso (automation), dans une application interne (chatbot client), ou dans un produit commercial (SaaS).

Tu commences par tester ton prompt dans le Workbench pour valider que la sortie est correcte, puis tu passes au code (curl ou SDK).

Tu mets en place dès le début des limits de dépense pour éviter les surprises de fin de mois (un script en boucle qui appelle Opus peut brûler 50 euros en une heure).

→ Essaie Claude maintenant : claude.ai

→ Chapitre suivant : Les 8 repos GitHub d'Anthropic à connaître