Construire avec Claude Code

Écrire à la main le code qui appelle l’API Claude fonctionne, mais il existe un chemin plus rapide : le faire écrire par Claude. La leçon finale du cours officiel confie à Claude Code un fichier squelette, à remplir avec les briques vues dans ce cours. Elle rappelle aussi pourquoi tout ce qui précède reste indispensable : pour juger ce que Claude Code produit, il faut savoir à quoi ressemble un bon code d’API.

Partir d’un squelette

Le projet de la démonstration est un fichier TypeScript qui donne la météo, avec deux fonctions à écrire :

• getWeather, qui reçoit une ville et renvoie la température et le temps qu’il fait ;
• run, qui doit utiliser le Tool Runner et le SDK TypeScript de Claude.

Le Tool Runner, vu à la leçon 5, fait tourner les appels d’outils et la boucle d’agent à votre place. Le squelette peut ressembler à ceci :

// weather.ts : le squelette confié à Claude Code
export async function getWeather(city: string): Promise<{ temperature: number; conditions: string }> {
  throw new Error("à écrire");
}

// Doit utiliser le Tool Runner du SDK TypeScript de Claude
export async function run(question: string): Promise<string> {
  throw new Error("à écrire");
}

La skill /claude-api

Claude Code intègre une skill /claude-api qui charge la documentation de référence de la Claude API et des agents gérés pour le langage de votre projet. Claude l’active de lui-même quand votre code importe anthropic ou @anthropic-ai/sdk, et vous pouvez aussi l’appeler directement. Elle propose des procédures à lancer par une sous-commande :

Un seul prompt

Ouvrez le dossier du projet dans votre terminal et lancez Claude Code. Il suffit d’un prompt, et un bon prompt fait trois choses : il nomme le fichier à modifier, il nomme le procédé à employer, il décrit l’état final attendu.

Dans weather.ts, écris getWeather et run. Utilise le Tool Runner du SDK
TypeScript avec un outil défini par betaZodTool. À la fin du fichier, appelle
run("Quel temps fait-il à Lyon ?") : le script doit s'exécuter sans erreur et
afficher la réponse finale de Claude.

Claude Code remplit les deux fonctions d’après leurs types, ajoute l’appel en bas du fichier, exécute le script et rend compte de la sortie. Si une erreur survient, il lit le message et corrige le code sur place. Dans la démonstration, il a créé un outil Zod qui valide l’entrée et renvoie un résultat selon la ville, puis le Tool Runner et la fonction run demandés, et il a affiché le résultat final de la boucle d’agent.

Le schéma à retenir

La plupart du code écrit pour l’API Claude a la même forme : définir un outil, le confier à un runner, renvoyer le résultat. Inutile de le taper de mémoire à chaque fois : écrivez le squelette, confiez-le à Claude Code, et relisez le diff.

Ce qu’il faut vérifier dans le code produit

Les leçons de ce cours vous donnent une grille de relecture :

• le modèle : un identifiant actuel, complet, sans date ajoutée (leçon 3) ;
• la réflexion : thinking adaptatif et un effort choisi, pas de budget_tokens, pas de temperature, pas de préremplissage (leçon 6) ;
• les outils : des descriptions précises, strict: true quand la forme compte, pas d’appel forcé sur Fable 5.1, Opus 5.5 ou Sonnet 5.5, tous les résultats d’un tour renvoyés dans un seul message, les erreurs signalées par is_error (leçons 4 et 5) ;
• les réponses longues en streaming, response.content complet ajouté à l’historique (leçons 2 et 10) ;
• les erreurs traitées avec les exceptions typées du SDK, et la clé d’API lue dans l’environnement, jamais écrite dans le code (leçon 2) ;
• pour un agent géré, l’agent créé une fois et non à chaque exécution (leçons 11 et 12).

La bonne méthode

Appliquez à votre code d’API les pratiques de Claude Code : une demande précise, une vérification que Claude peut lancer lui-même (un test qui appelle l’API sur quelques cas, un script qui vérifie la forme des sorties), et une relecture du diff avant de commiter. Demandez des preuves : la sortie du script de test plutôt qu’un « ça marche ». Le cours Claude Code 101 du catalogue détaille cette méthode.

À vous de jouer

Du squelette au code. Créez le fichier weather.ts ci-dessus dans un projet où le SDK TypeScript et Zod sont installés, lancez Claude Code et donnez-lui un seul prompt qui nomme le fichier, le procédé et l’état final. Relisez ensuite le diff avec la grille : quel modèle, quelle gestion des erreurs, où est lue la clé ? Notez ce que vous auriez écrit autrement.

Sources officielles : Building with Claude Code (Claude Academy) · Extend Claude with skills — Work on Claude API projects · Tool runner (SDK)

Points clés à retenir

• Un bon prompt nomme le fichier, le procédé et l’état final ; Claude Code écrit, exécute et corrige sur place
• Le schéma du code d’API : définir un outil, le confier à un runner, renvoyer le résultat
• La skill /claude-api charge la référence de l’API et propose des procédures (migration, audit de prompts, coûts, évaluations, agents gérés)
• Pour juger le code produit, relisez le diff avec la grille du cours, et demandez des preuves exécutables