Formation · ta première application
Brancher l'API de Claude dans ton application.
Jusqu'ici, c'est toi qui parles à Claude. Ici, c'est ton programme qui lui parle, tout seul, à chaque fois qu'un client fait quelque chose. Ça s'appelle l'API, ça demande une clé et quelques centimes et le script complet tient en vingt lignes.
La clé et ce qu'elle coûte, le script en vingt lignes, les deux erreurs exactes que tu verras avant que ça marche, le prix par question, puis comment le poser dans ton application sans que ça la fragilise.
Avant cette leçon Tu arrives ici directement ? Ces leçons préparent ce qu'elle suppose (le dossier, les outils installés) :
Windows
Mac
Touche ton ordinateur ci-dessus : les commandes du guide s'adaptent. Testé sous Windows 11. Les passages Mac suivent la documentation d'Apple et d'Anthropic.
Ce que tu vas faire
La clé et où la ranger Le script, en vingt lignes Les deux erreurs que tu verras d'abord Ce que ça coûte, par question Le poser dans ton application, sans la fragiliser
La leçon d'avant Réparer en production sans tout casser →
Avant tout : l'abonnement et l'API sont deux choses
Ton abonnement Claude te donne l'application et Claude Code, pour toi. L'API, c'est Claude pour tes programmes : un compte à part, prépayé, avec une clé. Tu déposes dix euros, chaque question en consomme une fraction de centime et tu vois le compteur descendre.
Ton application La clé, dans les secrets L'API de Claude La réponse, dans ta page Le programme pose la question, l'API répond, ta page l'affiche. Toi, tu n'es pas là. Cette leçon est un bonus : ton application marche très bien sans. Fais-la quand tu as une vraie raison de faire parler ton programme à Claude.
La clé ne se cherche pas dans les réglages de ton abonnement : elle se crée sur la console des développeurs, platform.claude.com, avec un compte à part, même si c'est la même adresse mail.
01
La clé et où la ranger
Avant de commencer
Un compte à part sur la console, une carte bancaire et un crédit prépayé de quelques euros avant la première question. Et la clé ne se colle jamais dans la conversation avec Claude : elle resterait écrite dans l'historique de la session. Tu la tapes toi-même, dans le terminal, comme ci-dessous.
Sur platform.claude.com (l'ancienne console.anthropic.com) : un compte, un crédit prépayé de quelques euros, puis « API keys », « Create key ». Elle commence par sk-ant- et ne s'affiche qu'une fois. Copie-la tout de suite dans une variable d'environnement (des étiquettes que les programmes lisent au démarrage : elles sont rangées dans ta session (le registre sur Windows, ~/.zshrc sur Mac), dans aucun fichier de ton projet) , jamais dans un fichier de ton dossier. Pour cette fenêtre du terminal seulement :
Dans le terminal Copier
$env:ANTHROPIC_API_KEY = "sk-ant-... "
Dans le terminal Copier
export ANTHROPIC_API_KEY="sk-ant-... "
La bibliothèque officielle (un morceau de code tout prêt, publié par Anthropic, que ton programme utilise) la trouve toute seule à cet endroit. Ton script n'a donc jamais besoin de la contenir et la leçon Ce qu'il ne faut jamais lui donner explique pourquoi c'est la seule façon acceptable.
Cette ligne ne vaut que pour la fenêtre où tu l'as tapée . Ferme-la et la clé a disparu. Et un double-clic sur lancer.bat (sur Mac lancer.command) ne la voit jamais : il ouvre sa propre fenêtre. Pour qu'elle tienne sur ta machine, enregistre-la pour ton compte, une fois :
Dans le terminal Copier
setx ANTHROPIC_API_KEY "sk-ant-... "
Dans le terminal Copier
echo 'export ANTHROPIC_API_KEY="sk-ant-... "' >> ~/.zshrc
Elle vaut alors pour toutes les fenêtres et tous les programmes ouverts après : ferme et relance ton terminal, puis ton application. Elle n'est toujours dans aucun fichier de ton dossier, donc jamais dans git.
Sur le serveur, elle va dans le fichier des secrets, .env, que le service lit au démarrage (la ligne EnvironmentFile de la leçon La mise en ligne ). Les clés de paiement suivront le même chemin dans la leçon Encaisser ton premier paiement .
Le piège
Coller la clé dans le script « pour tester ». Le script finit dans git, git finit quelque part et la clé aussi. Une clé fuitée se révoque dans la console, mais ce qui a été dépensé entre-temps est dépensé.