Claude Agent SDK : réutiliser le moteur de Claude Code

D’un outil de terminal à une bibliothèque

À l’origine, il y a Claude Code, l’assistant de programmation d’Anthropic qui travaille dans le terminal. Ses fonctions ont d’abord été proposées aux développeurs sous le nom de Claude Code SDK, renommé Claude Agent SDK en septembre 2025 pour signaler qu’il ne sert pas qu’à coder. Le principe : au lieu d’écrire vous-même la boucle d’un agent IA et ses outils, vous reprenez ceux de Claude Code.

Concrètement, l’agent dispose d’emblée d’outils pour lire, écrire et modifier des fichiers, exécuter des commandes et chercher sur le web. S’y ajoutent des sous-agents spécialisés, des « hooks » (votre code exécuté à des moments clés), un système de permissions qui décide quelles actions demandent votre accord, des sessions que l’on peut reprendre, et la connexion à des serveurs MCP pour brancher bases de données, navigateurs ou API.

Pour quels projets ?

Le SDK brille là où un agent doit agir sur un environnement réel : corriger des bogues, écrire et lancer des tests (codage agentique), trier des documents, produire des rapports, automatiser une tâche dans une chaîne d’intégration continue. Anthropic publie des exemples d’agents (assistant e-mail, agent de recherche) sur GitHub.

Comment démarrer

Il faut Node.js 18+ ou Python 3.10+ et un compte Anthropic. On installe le paquet claude-agent-sdk (pip) ou @anthropic-ai/claude-agent-sdk (npm), on définit sa clé API, puis on appelle la fonction query avec une consigne et la liste des outils autorisés. Le guide de démarrage officiel montre un agent qui trouve et corrige des bogues dans un fichier.

Forces et limites

Forces : un agent très outillé dès la première ligne, la même mécanique que Claude Code, une gestion fine des permissions et du contexte.

Limites : il ne fonctionne qu’avec les modèles Claude ; son usage est soumis aux conditions commerciales d’Anthropic ; chaque exécution consomme des tokens facturés, potentiellement beaucoup sur des tâches longues. Un agent qui peut lancer des commandes doit être limité avec soin : un bac à sable et l’outil puis-je confier ça à un agent ? aident à cadrer les risques. Pour un agent hébergé par Anthropic plutôt que dans vos serveurs, l’éditeur propose une offre distincte, Managed Agents.

Alternatives

L’OpenAI Agents SDK et Google ADK jouent le même rôle avec d’autres fabricants, tandis que smolagents et Pydantic AI restent indépendants du modèle.