Qu’est-ce que Claude Agent SDK ?
Le Claude Agent SDK permet à un programme Python ou TypeScript de faire tourner la même boucle d'agent, les mêmes outils et la même gestion du contexte que Claude Code. Il s'appelait auparavant Claude Code SDK. La bibliothèque lance un binaire Claude Code fourni et échange des messages avec lui, si bien qu'un agent construit dessus peut d'emblée lire, écrire et modifier des fichiers, lancer des commandes shell et chercher sur le web.
query() exécute une tâche ponctuelle sous forme de flux asynchrone ; ClaudeSDKClient maintient une session bidirectionnelle et ajoute des outils personnalisés, écrits comme de simples fonctions Python et servis comme serveurs MCP en processus, ainsi que des hooks qui exécutent votre code à certains moments du cycle de vie de l'agent. Sous-agents, sessions qu'on reprend ou qu'on bifurque, modes de permission, skills, plugins et mémoire de projet des dossiers .claude/ sont repris de Claude Code.
Le paquet Python exige Python 3.10 ou plus récent. La version 0.2.178 est sortie le 4 novembre 2026 avec Claude Code 2.1.318 intégré ; le paquet TypeScript est publié sous le nom @anthropic-ai/claude-agent-sdk.
Claude Agent SDK vaut-il le coup ?
La valeur de l'Agent SDK tient à ce que les parties difficiles sont déjà écrites. L'édition de fichiers, l'accès au shell, la compaction du contexte, les sous-agents et les demandes de permission viennent de Claude Code, qu'Anthropic met à jour tous les quelques jours : un appel query() de dix lignes donne un agent capable de corriger un bug dans un vrai dépôt. Les frameworks concurrents comme l'OpenAI Agents SDK ou LangGraph fournissent des briques à assembler ; celui-ci fournit un environnement fini qu'il faut encadrer.
Cette inversion façonne le modèle de sécurité. Par défaut, Claude dispose de tout l'outillage de Claude Code, Bash et Write compris. allowed_tools approuve seulement automatiquement les outils listés ; il ne retire pas les autres, qui retombent sur le mode de permission et votre callback can_use_tool. Pour retirer un outil, il faut disallowed_tools. Qui intègre le SDK dans un service devrait lire le guide des permissions avant le quickstart, et faire tourner le processus dans un conteneur si les entrées ne sont pas fiables.
L'étiquette open source mérite une note de bas de page. L'enveloppe Python est sous licence MIT, mais le travail se fait dans le binaire Claude Code fourni, et la documentation précise que l'usage du SDK relève des Commercial Terms d'Anthropic. Le dépôt TypeScript porte la mention tous droits réservés. On ne peut pas forker la boucle de l'agent, seulement la configurer.
Le rythme des versions suit celui de Claude Code : 25 versions Python entre le 15 septembre et le 4 novembre 2026, de 0.2.153 à 0.2.178, toujours sous la 1.0. Le dépôt compte environ 8 440 étoiles et 616 issues et pull requests ouvertes. La documentation interdit aux produits tiers de proposer la connexion claude.ai ou les limites des offres sans autorisation, donc un produit bâti sur le SDK facture par clés d'API ; sur la machine d'un développeur, l'usage connecté puise dans son offre Claude. Un crédit mensuel pour le SDK annoncé pour le 15 juin 2026 a été suspendu le jour même.
Là où il fait la différence
Un ingénieur plateforme dans une entreprise de 100 développeurs
Faire tourner un bot interne qui trie les jobs de CI en échec et propose des correctifs
Appelez query() depuis le runner de CI avec cwd sur le checkout, disallowed_tools pour tout ce qui sort du dépôt et un hook PreToolUse qui bloque les commandes réseau ; l'usage est facturé à une clé d'API de la Console avec sa propre limite de dépense.
Une start-up qui ajoute un agent à un produit de gestion documentaire
Laisser les clients demander à un agent de réorganiser et résumer leurs fichiers
Exposez les actions du produit comme outils avec le décorateur @tool et create_sdk_mcp_server, pour qu'elles tournent en processus ; chaque session client tourne dans son propre conteneur, et la facturation passe par des clés d'API puisque la connexion claude.ai n'est pas autorisée.
Une développeuse indépendante qui automatise des corvées sur son portable
Scripter des refactorisations répétées sans écrire de boucle d'agent
Un court script Python avec ClaudeSDKClient et le mode acceptEdits fait les modifications ; connectée avec son offre Claude personnelle, elle puise dans les limites de cette offre plutôt que de recevoir une facture à part.
Avant de vous engager
- Mise en route
- pip install claude-agent-sdk sous Python 3.10+ (ou npm install @anthropic-ai/claude-agent-sdk), définissez une clé d'API, et l'agent de correction de bugs du quickstart tourne en quelques minutes ; pas besoin d'installer Claude Code à part.
- Intégrations
- Serveurs MCP, outils personnalisés en processus, hooks, sous-agents, skills et plugins des dossiers .claude/ ; Claude API, Amazon Bedrock, Google Cloud et Microsoft Foundry pour l'accès aux modèles.
- Données et confidentialité
- Tourne en local avec les droits de son processus et envoie prompts et contenus de fichiers à Claude selon les conditions de l'API ou de l'offre du compte ; l'outillage par défaut peut lire, écrire et exécuter partout où le processus le peut.
- Coût à grande échelle
- Le SDK est gratuit ; le coût, ce sont les tokens Claude aux tarifs de l'API, et les boucles d'agent riches en appels d'outils multiplient les tokens par tâche. Les offres Max, Ultra et Team incluent des crédits d'API mensuels utilisables avec une clé Console liée.
- Limites
- Modèles Claude uniquement ; API d'avant la 1.0 aux versions fréquentes ; les règles de marque interdisent d'appeler un produit Claude Code ; la boucle de l'agent elle-même n'est pas modifiable.
Les points forts
- Les outils fichiers, shell et web de Claude Code d'emblée
- Outils personnalisés en serveurs MCP en processus, sans processus séparé
- Hooks, sous-agents, sessions et plugins repris
- Le même moteur sur l'API, Bedrock, Google Cloud et Foundry
- Versions fréquentes au rythme de Claude Code
Les points faibles
- Le binaire central est fermé et relève des Commercial Terms d'Anthropic
- Tous les outils disponibles par défaut ; allowed_tools ne restreint rien
- Modèles Claude uniquement
- Avant la 1.0, avec des versions tous les quelques jours
- Les produits ne peuvent pas proposer la connexion claude.ai à leurs utilisateurs
Idéal pour
Les développeurs qui veulent un agent de code ou de travail sur fichiers du niveau de Claude Code dans leur propre produit et ont misé sur Claude.
Alternatives à Claude Agent SDK
Claude Agent SDK : questions fréquentes
- Claude Agent SDK vaut-il le coup ?
- Pas de chemin plus rapide vers un agent qui sait déjà modifier des fichiers et lancer des commandes, à condition d'accepter Claude Code comme un moteur fermé à l'intérieur. Nous lui donnons 4.2 sur 5.
- Combien coûte Claude Agent SDK ?
- L'enveloppe Python est gratuite sous licence MIT ; le binaire Claude Code fourni et le paquet TypeScript relèvent des Commercial Terms d'Anthropic. Vous payez l'usage de la Claude API ou puisez dans les limites de votre propre offre Claude.
- Quels sont les inconvénients de Claude Agent SDK ?
- Le binaire central est fermé et relève des Commercial Terms d'Anthropic; tous les outils disponibles par défaut ; allowed_tools ne restreint rien; modèles Claude uniquement; avant la 1.0, avec des versions tous les quelques jours; les produits ne peuvent pas proposer la connexion claude.ai à leurs utilisateurs.
- À qui s’adresse Claude Agent SDK ?
- Les développeurs qui veulent un agent de code ou de travail sur fichiers du niveau de Claude Code dans leur propre produit et ont misé sur Claude.
- Combien coûte Claude Agent SDK pour une équipe ou en production ?
- Le SDK est gratuit ; le coût, ce sont les tokens Claude aux tarifs de l'API, et les boucles d'agent riches en appels d'outils multiplient les tokens par tâche. Les offres Max, Ultra et Team incluent des crédits d'API mensuels utilisables avec une clé Console liée.
- Claude Agent SDK est-il sûr pour les données de l’entreprise ?
- Tourne en local avec les droits de son processus et envoie prompts et contenus de fichiers à Claude selon les conditions de l'API ou de l'offre du compte ; l'outillage par défaut peut lire, écrire et exécuter partout où le processus le peut.
- Quelles sont les meilleures alternatives à Claude Agent SDK ?
- Les alternatives les plus proches que nous avons testées sont OpenAI Agents SDK, Pydantic AI, LangGraph et Google Agent Development Kit (ADK).
Réponses vérifiées le 6 nov. 2026.
Vous éditez Claude Agent SDK ? Affichez cette note sur votre site
