Leçon 13 sur 15
Le SDK Claude Code
13 min de lecture
Points clés de cette leçon
- Le SDK permet d'invoquer Claude Code par programmation, hors du terminal interactif.
- Il sert à construire des outils, scripts et automatisations sur mesure.
- Le mode programmatique exige des garde-fous explicites.
Jusqu'ici, le cours a présenté Claude Code en mode interactif, dans le terminal. Le SDK Claude Code ouvre une autre voie : invoquer l'assistant par programmation, depuis vos propres scripts et applications.
Du terminal au programme
En mode interactif, vous dialoguez avec l'assistant en temps réel. C'est parfait pour explorer, comprendre, ajuster au fil de l'eau.
Mais certains usages demandent l'automatisation : appliquer le même traitement à cent dépôts, intégrer l'assistant dans un outil interne, déclencher une analyse à chaque événement. Pour ces cas, on ne veut pas d'un humain devant un terminal : on veut du code. C'est le rôle du SDK.
Deux modes, deux usages
Le mode interactif et le SDK ne s'opposent pas. Le premier sert l'exploration et le travail au cas par cas ; le second, les traitements répétables et intégrés. Vous choisissez selon le besoin.
Le principe du SDK
Le SDK fournit une interface programmatique pour lancer des sessions Claude Code depuis votre code. Vous formulez une instruction, l'assistant l'exécute, et votre programme récupère le résultat pour en faire ce qu'il veut.
// Schéma illustratif d'un usage programmatique
import { runClaudeCode } from "@exemple/claude-code-sdk";
const resultat = await runClaudeCode({
prompt: "Mets à jour le numéro de version dans package.json",
cwd: "./mon-projet",
});
console.log(resultat.summary);Cet extrait est volontairement schématique : noms et signatures réels sont à vérifier sur le site officiel d'Anthropic. L'idée à retenir est qu'une instruction en langage naturel devient un appel de fonction dont vous traitez le retour.
Cas d'usage du SDK
Le SDK ouvre des scénarios que le mode interactif ne couvre pas bien.
Traitements par lots
Appliquer une migration, une mise à jour de dépendance ou une correction à de nombreux dépôts, en boucle, sans intervention manuelle.
Outils internes
Construire un outil maison qui mobilise Claude Code en coulisses : un assistant de revue, un générateur de documentation, un agent de tri d'issues.
Déclenchements automatiques
Lancer une analyse en réaction à un événement : un nouveau commit, une issue créée, une planification horaire. Cette logique prépare l' automatisation CI/CD de la leçon suivante.
Les garde-fous en mode programmatique
Sans humain dans la boucle, les garde-fous deviennent critiques.
Permissions explicites
Définissez précisément ce que l'assistant a le droit de faire. En mode automatisé, il n'y a personne pour confirmer une action sensible. Les permissions vues dans la leçon d'installation prennent ici toute leur importance.
Gestion des erreurs
Votre code doit prévoir l'échec : une instruction mal interprétée, un test qui ne passe pas, un timeout. Traitez ces cas explicitement plutôt que de supposer le succès.
Surveillance des coûts
Un traitement par lots multiplie les appels. Surveillez la consommation et posez des limites pour éviter les mauvaises surprises.
Toujours un point de contrôle
Même automatisé, un changement de code mérite un point de contrôle humain. Faites produire à l'assistant des pull requests à relire plutôt que des fusions directes, comme le recommande la leçon GitHub.
Combiner SDK et autres mécanismes
Le SDK ne s'utilise pas isolément. Il se combine aux hooks, aux serveurs MCP, aux sous-agents et aux skills vus précédemment. Un script SDK peut, par exemple, lancer un sous-agent spécialisé qui s'appuie sur un skill maison. La puissance vient de l'assemblage.
En résumé
Le SDK Claude Code fait passer l'assistant du terminal interactif au code programmatique. Il rend possibles les traitements par lots, les outils internes et les déclenchements automatiques, à condition d'encadrer permissions, erreurs et coûts.
La leçon suivante applique tout cela à l'automatisation CI/CD. Retrouvez les cours et la certification Certified Architect.