Cours
Claude Code 101
3 h
28.3K
Utiliser l’API Claude d’Anthropic permet d’aller bien au-delà d’une simple conversation avec un chatbot. Vous pouvez intégrer toutes les capacités de Claude IA directement dans vos applications.
Anthropic a surpris l’écosystème IA avec la sortie de Fable 5, un modèle si performant que le gouvernement américain en a temporairement restreint l’accès peu après son lancement. Si le modèle est désormais à nouveau disponible dans le monde entier, la façon d’y accéder a changé.
Anthropic restreint désormais l’accès à Fable 5 exclusivement via l’API, avec une facturation à l’usage basée sur des crédits (avec une prise d’effet après une brève extension de cinq jours).
Conséquence : nous devons repenser notre manière d’interagir avec l’IA. Les modèles très puissants et les outils de codage automatisés exigent bien plus de ressources de calcul que ce que permettent des offres grand public à prix fixe.
Dans ce tutoriel, je vous prépare à cette nouvelle réalité en vous montrant comment utiliser l’API Claude.
Je vous explique pas à pas comment configurer Claude Code avec l’API d’Anthropic pour développeurs. En passant dès aujourd’hui à la facturation à l’usage, vous garantissez un accès ininterrompu aux modèles de pointe comme Fable 5, vous supprimez les limites invisibles de taux, et vous apprenez à mener des sessions de codage complexes directement depuis votre terminal.
Si vous cherchez un aide-mémoire, nous vous recommandons la cheat sheet Claude API en Python.
Pourquoi préférer l’API Claude à un abonnement Claude Pro
Pour beaucoup, l’offre Claude Pro à 20 $ par mois était la façon idéale d’accéder à une IA haut de gamme : un prix fixe et un accès régulier.
Mais la montée en puissance des outils de codage automatisés a changé la donne. Les workflows agents nécessitent bien plus de ressources qu’un abonnement standard ne peut en fournir, faisant de l’API Claude la seule option viable pour les développeurs exigeants.
Voici trois raisons majeures d’abandonner l’abonnement et d’utiliser Claude Code directement via l’API.
Epuisement de jetons avec les outils agents
Les offres standard peinent avec des outils comme Claude Code à cause de leur mode de fonctionnement.
Contrairement à un simple chat web, un outil de développement automatisé doit en permanence analyser l’ensemble du projet pour comprendre sur quoi il travaille.
Chaque fois qu’on lui confie une tâche, il suit plusieurs étapes : lecture de fichiers, vérification des structures, exécution de tests. Cela implique d’échanger d’importants volumes de données pour maintenir l’IA à jour sur l’état du code.
Ce processus consomme très vite des jetons. Avec un abonnement Pro, ces workflows complexes peuvent épuiser plusieurs heures de quotits en quelques minutes, stoppant net notre travail.
Protéger votre capacité d’usage quotidienne
Les comptes Claude Pro partagent un même pool de ressources. Si nous utilisons notre compte principal pour du codage en terminal, ces tâches lourdes ponctionneront la capacité disponible pour le navigateur ou l’application mobile.
On ne souhaite pas se retrouver bloqué sur une simple conversation parce qu’une tâche de codage en arrière-plan a atteint le plafond. Faire passer vos outils de développement par l’API Claude isole totalement votre travail de codage professionnel de votre usage quotidien de l’IA.
Accès exclusif aux modèles intensifs
Au fur et à mesure qu’Anthropic publie des modèles conçus pour l’ingénierie lourde et le travail autonome, comme Claude Fable 5, l’entreprise s’éloigne des offres à prix forfaitaire.
Parce que Fable 5 requiert une puissance de calcul immense, Anthropic a confirmé que ce modèle spécifique imposera à terme une facturation à l’usage pour maîtriser des coûts d’opération élevés.
Cette restriction préfigure l’avenir. Rester sur un abonnement grand public signifie que vous perdrez progressivement l’accès aux moteurs de raisonnement les plus puissants d’Anthropic ; un compte API Claude devient donc indispensable pour rester à la pointe.
API Claude vs abonnement Claude
La différence entre un abonnement grand public et l’API développeur tient à un arbitrage : coûts prévisibles contre accès ininterrompu.
Un abonnement Claude offre un tarif mensuel fixe.
On peut l’utiliser intensément un temps, puis on finit par atteindre un plafond d’usage dynamique selon la charge serveur. Quand Claude Code se heurte à ce mur invisible en plein projet, il cesse tout bonnement de fonctionner.
Nous devons alors attendre plusieurs heures la remise à zéro avant que l’agent puisse terminer le code.
L’API Claude supprime ces roulettes. Pas de plafond horaire de messages, pas de bande passante partagée, pas de délais d’attente. Si nous voulons que Fable 5 refactorise une base de code massive pendant huit heures d’affilée, l’API exécutera chaque commande sans interruption.
Cette liberté introduit toutefois un risque majeur : les dérapages budgétaires. Un abonnement peut être frustrant quand on atteint la limite, mais au moins on connaît le montant de la facture en fin de mois.
C’est particulièrement vrai avec des modèles onéreux comme Fable 5.
Gestion des coûts et contrôle du budget avec l’API Claude
Deux leviers permettent de contrôler votre budget avec l’API.
Le premier consiste à désactiver l’auto-recharge. L’auto-recharge permet à Claude d’acheter automatiquement des crédits en cas d’épuisement.
L’usage de jetons avec Claude Code étant très imprévisible, je recommande fortement de ne pas l’activer.
Le second est de choisir soigneusement le modèle utilisé.
Fable 5 excelle sur des tâches et applications complexes. Mais il est souvent disproportionné pour des besoins plus simples.
Personnellement, je privilégie les modèles moins chers et je ne bascule vers des modèles plus coûteux que si les premiers échouent après plusieurs tentatives. Le modèle que j’utilise le plus est d’ailleurs Haiku 4.5.
Pour sélectionner le modèle, utilisez la commande /model.
Configuration pas à pas de l’API Claude (avec Fable 5)
Si vous cherchez un tutoriel dédié à l’API Claude Fable 5, consultez notre guide séparé.
Pour commencer, connectez-vous à la plateforme web Claude et configurez la facturation. Ouvrez ensuite un terminal et installez Claude Code avec la commande :
npm install -g @anthropic-ai/claude-codeUne fois installé, lancez-le en tapant claude dans le terminal. Au premier lancement, il vous demandera une configuration. Veillez à sélectionner « API usage billing » lors du paramétrage :
Claude ouvrira ensuite le navigateur pour demander l’autorisation de lier votre compte et de créer une clé API. Cliquez sur « Authorize » ; le compte sera lié automatiquement.
Une fois la configuration terminée, nous pouvons commencer à construire avec Claude Code :
Dans mon cas, Claude Code tourne déjà avec Fable 5. Si ce n’est pas votre cas, vous pouvez choisir le modèle à l’aide de la commande /model puis sélectionner Fable 5 dans le menu.
Passer Claude Code de l’abonnement à l’API
Si vous utilisiez déjà Claude Code avec un abonnement et souhaitez passer à la facturation à l’usage via API, la procédure est simple.
- Déconnectez-vous avec la commande
/logout. - Relancez Claude Code avec la commande
claudeet choisissez la méthode de connexion « Anthropic Console account · API usage billing ».
Si nous venons à manquer de crédits alors que Claude Code est en train d’implémenter une fonctionnalité, il s’arrêtera et vous indiquera d’ajouter des crédits.
Après avoir ajouté des crédits, si Claude est toujours actif, demandez-lui simplement de continuer avec une invite, il reprendra où il s’était arrêté. S’il n’est pas en cours d’exécution, utilisez la commande claude --continue.
Créer un projet concret avec l’API Claude
L’objectif de ce tutoriel est d’apprendre à configurer Claude Code avec l’API, plutôt que de proposer un guide détaillé d’utilisation de Claude Code.
Pour aller plus loin, je vous conseille de vous inscrire à notre cours Claude Code 101.
Aperçu du projet
Le but est de construire une application Python qui permette de retrouver facilement des photos sur son ordinateur.
Aujourd’hui, on prend beaucoup de photos, souvent désorganisées et dispersées. En tant que photographe, c’est fréquemment un casse-tête de retrouver un cliché des mois plus tard.
L’idée : permettre à l’utilisateur de retrouver ses photos en décrivant leur contenu ou en fournissant une capture d’écran ou une image de référence.
Ce deuxième mode est très utile pour moi : je publie souvent mon travail sur les réseaux, je peux donc juste prendre une capture de mon post pour retrouver le fichier source en haute qualité.
On pourrait laisser Claude Code définir l’architecture et tout implémenter ; cela fonctionnerait probablement très bien.
Mais à des fins pédagogiques, j’ai choisi de définir moi-même l’architecture et de confier l’implémentation à Claude Code.
Architecture du projet avec CLAUDE.md
Pour créer cette application, j’ai rédigé un CLAUDE.md qui décrit l’architecture du projet.
Un fichier CLAUDE.md est une configuration Markdown spécifique au projet que Claude Code lit au démarrage de chaque session pour mémoriser durablement votre architecture, vos standards de code et vos préférences de workflow.
L’application comporte deux composants principaux :
- Un processus d’ingestion de photos permettant de sélectionner un dossier d’images, de convertir ces images en vecteurs et de les stocker dans une base de données vectorielle.
- Une entrée multimodale pour interroger la base.
Pour encoder les images en vecteurs, nous utilisons le modèle CLIP. Pour la base, nous utilisons ChromaDB, qui s’exécute en local gratuitement.
L’intuition : CLIP est entraîné à convertir textes et images en vecteurs (représentations numériques) de sorte que les images visuellement proches ou partageant des concepts similaires soient placées à proximité, tandis que les images non liées sont éloignées.
Pour retrouver une image, nous convertissons aussi la requête en vecteur de requête et utilisons ChromaDB pour retrouver les vecteurs les plus proches.
Pour en savoir plus sur les bases vectorielles, consultez ce tutoriel ChromaDB : guide pas à pas.
L’invite (prompt)
Avec l’architecture spécifiée dans le fichier CLAUDE.md, j’ai ouvert un terminal dans ce dossier et fourni à Claude Code (Fable 5) l’invite suivante :
Build a desktop graphical app for my photography search engine with Python.
First, plan the application architecture exactly as outlined in the CLAUDE.md file, ensuring the GUI can handle both folder ingestion and searching.
Create a virtual environment, install the necessary dependencies (including customtkinter and raw image processing libraries), and save them to requirements.txt.
Write the application logic, paying special attention to background threading for the ingestion process. Le résultat
J’ai soumis l’invite et laissé Claude Code faire sa magie. En environ sept minutes, c’était terminé.
J’ai exécuté l’application, voici le rendu :
J’ai importé quelques images prises cette année, puis je suis allé sur Instagram pour faire une capture d’écran d’un post afin de l’utiliser comme image de référence.
J’ai volontairement laissé toute l’interface pour compliquer la tâche. Voici le résultat :
Je dois dire que cela fonctionne très bien, et l’interface correspond exactement à ce que j’avais en tête. J’ai aussi testé la recherche textuelle pour trouver des photos de Taipei 101, le plus haut immeuble de Taïwan.
Voici les résultats :
Consommation de jetons et coûts réels de l’API Claude
Au total, la création de ce projet a coûté 3,65 $ de jetons API. Vous pouvez obtenir une ventilation détaillée des coûts d’une session avec la commande /cost :
Fait intéressant : on voit que claude-haiku-4.5 a aussi été utilisé pour une partie du travail.
Cela montre que Fable 5 est assez coûteux.
Une session de sept minutes sur un projet vierge nous a déjà coûté 3,65 $.
On imagine aisément le coût de Fable 5 sur un projet existant avec des centaines de fichiers.
Bien sûr, dans un contexte réel, pour une application qui génère des revenus, ces coûts doivent être analysés autrement : ce sont des investissements.
Fonctionnalités avancées de l’API Claude à connaître
Passer à l’API donne accès à des outils indisponibles sur Claude.ai : la mise en cache d’invite, le traitement par lots et l’intégration d’outils.
Si vous utilisez Claude Code, si vous gérez un fort volume d’appels API ou si vous construisez des systèmes agents qui interagissent avec des services externes, ce sont ces fonctionnalités qui auront le plus d’impact sur vos coûts et votre latence.
1. Mise en cache des invites (réduction des coûts)
La mise en cache conserve côté serveur les parties statiques de votre fenêtre de contexte entre appels API, évitant de repayer le retraitement des mêmes contenus à chaque requête.
Si vous travaillez avec Claude Code, vous renvoyez probablement le même contexte volumineux à chaque appel (un fichier CLAUDE.md, un résumé de codebase ou un long prompt système). D’après la documentation d’Anthropic, les préfixes mis en cache réduisent les coûts d’entrée jusqu’à 90 % et accélèrent l’apparition du premier jeton, le préfixe sautant la ré-ingestion.
La première requête paie le plein tarif d’entrée. Toutes les suivantes qui exploitent le même préfixe de cache sont facturées au tarif réduit.
2. Batch API (traitement asynchrone)
La Batch API gère les charges qui n’exigent pas de réponse en temps réel.
Traiter 10 000 tickets support, générer la documentation d’une base de code entière, ou lancer des évaluations sur un grand jeu de tests : tout cela est adapté au mode batch. Anthropic facture les requêtes batch à 50 % du coût standard des jetons d’entrée et de sortie, et l’ensemble du job est soumis en un seul appel API au lieu de gérer vous-même une file d’attente.
La contrainte : les jobs batch peuvent prendre jusqu’à 24 heures et les résultats arrivent en bloc, sans streaming. Parfait pour des pipelines hors ligne, inadapté à du front utilisateur.
3. Utilisation d’outils et Model Context Protocol (MCP)
L’utilisation d’outils (parfois appelée function calling) permet à Claude d’invoquer des fonctions externes pendant la génération et d’intégrer leurs résultats à sa réponse.
Vous définissez les outils disponibles en JSON Schema ; Claude décide quand les appeler, quels arguments passer et comment exploiter la sortie. Il peut ainsi requêter une base de données, appeler une API REST ou exécuter un script Python sans que vous indiquiez le point d’appel exact dans le prompt.
Le Model Context Protocol (MCP) va plus loin avec une interface serveur standardisée : au lieu de définir des outils par projet, Claude se connecte à un serveur MCP local qui expose l’accès aux fichiers, l’exécution de code ou la lecture de bases de données.
La Computer Use API fonctionne différemment : Claude interprète une capture d’écran et émet des événements clavier/souris, naviguant dans des interfaces sans accès API programmatique à l’application sous-jacente.
Conclusion
Passer à l’API Claude est indispensable pour exécuter des outils de développement automatisés, mais cela suppose de revoir la gestion de nos projets.
Fable 5 est indéniablement un modèle de codage remarquable, capable de générer des applications complexes et pleinement fonctionnelles à partir d’un seul prompt.
Sa puissance de raisonnement permet de transformer une vision architecturale en réalité fonctionnelle en quelques minutes : impressionnant.
Cependant, accéder à ce niveau de puissance via l’API Claude a un coût. Étant donné le prix d’exécution de modèles comme Fable 5, il est crucial d’être stratégique dans votre sélection de modèles.
Je vous recommande d’utiliser des modèles plus économiques et efficaces pour les tâches courantes, et de réserver Fable 5 aux véritables blocages ou aux défis architecturaux complexes qui exigent un raisonnement plus profond.
Comme nous l’avons vu, même pour une application relativement simple et monofichier, les coûts en jetons API peuvent grimper rapidement. Protégez votre budget en surveillant de près votre consommation et, surtout, en désactivant l’auto-recharge pour éviter qu’une session de codage automatisé ne s’emballe.
Pour approfondir l’écosystème Claude, nous vous recommandons notre cours Claude 101.
