Commencer à partir d'un stub

Écrire du code qui appelle l'API Claude à la main fonctionne bien, mais il existe un chemin encore plus rapide : faire écrire le code par Claude. Dans cette leçon, nous utiliserons Claude Code pour compléter une intégration API à partir d'un fichier avec des stubs — en utilisant les mêmes primitives que vous avez apprises tout au long de ce cours.

Commencer à partir d'un stub

Le projet est simple : un fichier TypeScript qui récupère la météo. Il contient deux stubs :

• getWeather — accepte une ville et retourne la température et les conditions.
• run — une fonction qui devrait utiliser le tool runner et le SDK TypeScript Claude.

Le tool runner est la partie qui gère l'appel d'outils et la boucle d'agent pour vous, afin que vous n'ayez pas à le câbler manuellement.

La compétence Claude API

Claude Code est livré avec une compétence intégrée appelée Claude API. Vous pouvez l'invoquer directement avec /claude-api, ou Claude Code l'invoquera automatiquement quand il détecte que vous utilisez le SDK TypeScript.

Si vous ne voyez pas la compétence, vous pouvez l'ajouter depuis la marketplace :

/plugin marketplace add AnthropicsSkills

Notez le s à la fin d'Anthropics — c'est facile à manquer.

Dialogue Add Marketplace de Claude Code après avoir exécuté la commande /plugin marketplace add

Un prompt, du code fonctionnel

Ouvrez le dossier du projet dans votre terminal et lancez Claude Code.

À partir de là, il faut un seul prompt. Un bon prompt fait trois choses :

• Il nomme le fichier que vous voulez modifier.
• Il nomme le motif que vous voulez utiliser.
• Il nomme l'état final que vous attendez.

Claude Code remplit ensuite getWeather et run par rapport aux types, ajoute un appel au bas du fichier, exécute le script et rapporte la sortie. Si quelque chose génère une erreur, il lit le message d'erreur et corrige le code sur place.

Claude Code dans le terminal lisant weather. ts et le fichier tool runner après avoir reçu le prompt

Ce que Claude Code a produit

Dans cette exécution, Claude Code a créé un Zod tool qui a analysé l'entrée et retourné la sortie en fonction du type de ville. Il a également créé le tool runner et la fonction run que nous avons demandée, et a imprimé les résultats finaux de la boucle d'agent.

Claude Code générant le code météo dans le terminal, avec l'import betaZodTool et les données de ville codées en dur visibles

Le motif à retenir

La plupart de ce que vous écrivez contre l'API Claude a une forme familière :

• Définir un outil.
• Le remettre à un runner.
• Retourner le résultat.

Vous n'avez pas besoin de taper cela de mémoire à chaque fois. À la place, créez un stub du fichier, remettez-le à Claude Code, et examinez simplement le diff.

Récapitulatif

• Claude Code est un agent qui édite des fichiers et exécute des commandes dans votre terminal.
• La compétence intégrée Claude API se charge automatiquement quand Claude Code détecte le SDK TypeScript, ou vous pouvez l'invoquer avec /claude-api.
• Donnez-lui un prompt qui nomme le fichier, le motif et l'état final — il écrit le code, l'exécute et corrige les erreurs sur place.
• Le code Claude API suit une forme familière : définir un outil, le remettre à un runner, retourner le résultat. Créez un stub, déléguez, examinez le diff.