L’API Anthropic : connecter Claude à vos propres outils
Comprendre ce qu’est l’API Claude, en quoi elle diffère de l’interface Claude.ai, et comment un premier appel technique fonctionne — même sans être développeur.
🎯 Objectif de ce module
À l’issue de ce tuto, vous saurez expliquer ce qu’est l’API Anthropic, la différencier de Claude.ai et de Claude Code, identifier les cas d’usage professionnels pertinents (automatisation, intégration dans un logiciel métier, traitement en masse) et lire un exemple d’appel API simple.
📋 Avant de commencer
- Un compte sur console.anthropic.com (gratuit à créer, facturation à l’usage ensuite)
- Aucune connaissance de programmation n’est requise pour ce module — les exemples de code sont commentés pas à pas
- Ce module est complémentaire aux tutos Claude Code et Connecteurs Claude, qui utilisent cette même API en coulisses
Qu’est-ce que l’API Anthropic ?
DécouverteQuand vous discutez avec Claude sur claude.ai, vous utilisez une interface toute prête : une page web, une zone de texte, un bouton d’envoi. L’API (Application Programming Interface) est la porte d’entrée technique qui se cache derrière : c’est elle qui permet à n’importe quel logiciel — un site web, une appli mobile, un outil interne d’entreprise — d’envoyer une question à Claude et de récupérer sa réponse, sans passer par le chat.
Concrètement, l’API Claude est accessible à l’adresse https://api.anthropic.com. Un développeur (ou un outil no-code connecté à cette API) y envoie une requête contenant le texte, et Claude renvoie sa réponse au format JSON, directement exploitable par le programme appelant.
À retenir
- Claude.ai = interface grand public prête à l’emploi
- Claude Code = agent qui utilise l’API pour coder dans votre terminal
- API Claude = brique technique brute, pour intégrer Claude dans vos propres outils
Les concepts clés à connaître
DécouverteQuatre notions reviennent systématiquement quand on parle de l’API :
| Concept | À quoi ça sert |
|---|---|
| Clé API | Un code secret unique qui identifie votre compte et sert à facturer l’usage. Elle se génère dans la Console. |
| Modèle | La version de Claude appelée (par ex. Claude Sonnet 5, Claude Opus 4.8). Chaque modèle a un rapport coût / intelligence / vitesse différent. |
| Endpoint « Messages » | L’adresse technique précise à laquelle on envoie une conversation pour obtenir une réponse. |
| Tokens | L’unité de mesure du texte (environ ¾ de mot). La facturation se fait au nombre de tokens envoyés et reçus. |
Obtenir une clé API
Application- Rendez-vous sur console.anthropic.com et créez un compte (ou connectez-vous)
- Dans les paramètres du compte, ouvrez la section « Clés API »
- Cliquez sur « Créer une clé », donnez-lui un nom (ex. « Test A3I »)
- Copiez la clé immédiatement : elle ne sera plus jamais affichée en clair ensuite
Ce que vous devez observer
- La clé commence toujours par
sk-ant- - Un espace « Workbench » permet de tester l’API directement dans le navigateur, sans écrire de code
- La facturation se configure séparément, dans « Billing » — aucun appel n’est possible tant qu’un moyen de paiement n’est pas ajouté
Lire un premier appel API
ApplicationVoici à quoi ressemble un appel minimal à l’API, ici en Python. Vous n’avez pas besoin de l’écrire vous-même pour ce module : l’objectif est de comprendre sa structure.
# 1. On importe la librairie officielle Anthropic import anthropic # 2. On crée un client, relié à votre clé API client = anthropic.Anthropic() # 3. On envoie un message et on demande une réponse message = client.messages.create( model="claude-sonnet-5", max_tokens=1024, messages=[{"role": "user", "content": "Rédige un objectif pédagogique pour Excel"}] ) # 4. On récupère le texte de la réponse print(message.content[0].text)
Trois éléments à repérer dans ce code : le modèle choisi, le message envoyé (identique à ce que vous taperiez dans le chat), et le nombre maximum de tokens autorisé en réponse — un plafond de sécurité pour maîtriser le coût.
Ce que vous devez observer
- La réponse revient au format JSON structuré, pas comme un simple texte de chat
- Chaque réponse est accompagnée d’un identifiant de requête (
request-id), utile en cas de support technique - Aucune mémoire entre deux appels : chaque requête doit renvoyer tout l’historique de la conversation si on veut que Claude s’en souvienne
Cas d’usage professionnels
MaîtrisePour un organisme de formation, l’API ouvre des usages que le chat seul ne permet pas :
- Traitement en masse : générer automatiquement 50 questionnaires d’auto-évaluation à partir d’une liste de compétences, via la Message Batches API (50 % moins cher, traitement asynchrone)
- Intégration dans un outil interne : brancher Claude sur un CRM ou un formulaire de demande de devis pour générer une réponse personnalisée automatiquement
- Site web intelligent : un chatbot pédagogique sur a3iformations.fr qui répond aux questions des visiteurs à partir de votre catalogue de formations
- Connecteurs (MCP) : c’est cette même API qui permet à Claude de lire vos emails ou votre agenda, comme vu dans le tuto Les connecteurs Claude
À retenir
- L’API n’est pas réservée aux développeurs confirmés : des outils no-code (Zapier, Make) permettent de la brancher sans écrire de code
- Le coût dépend du modèle choisi et du volume de tokens échangés, pas d’un abonnement fixe
API, Claude.ai, Claude Code : bien distinguer
Maîtrise| Produit | Pour qui | Facturation |
|---|---|---|
| Claude.ai | Grand public, usage conversationnel quotidien | Abonnement (gratuit / Pro / Team) |
| Claude Code | Développeurs, agent autonome dans le terminal | Abonnement ou API à l’usage |
| API Anthropic | Intégrer Claude dans un logiciel ou un site tiers | À l’usage, au token |
Retenez que Claude Code et les connecteurs Claude reposent tous les deux sur cette API : ce module en est donc le socle technique commun à plusieurs autres tutos de cette série.
🛠️ Atelier A3I
Mise en pratique guidée (15 min) :
- Créez un compte sur console.anthropic.com si ce n’est pas déjà fait
- Ouvrez le Workbench et envoyez un message test à Claude directement depuis le navigateur, sans écrire de code
- Repérez dans l’interface où sont indiqués le modèle utilisé et le nombre de tokens consommés
- Notez, en une phrase, un cas d’usage concret pour A3iformations où l’API pourrait automatiser une tâche répétitive (ex. génération de questionnaires, réponses aux demandes de devis)
✅ Auto-évaluation
- ☐ Je sais expliquer la différence entre Claude.ai et l’API Anthropic
- ☐ Je sais ce qu’est une clé API et où la créer
- ☐ Je peux identifier les éléments d’un appel API simple (modèle, message, tokens)
- ☐ Je peux citer au moins deux cas d’usage professionnels de l’API
- ☐ Je comprends que Claude Code et les connecteurs s’appuient sur cette même API