Présentation du SDK Agent
Créez des agents IA de production avec Claude Code en tant que bibliothèque
Un agent est une application qui complète une tâche en planifiant ses propres étapes et en appelant des outils qui lisent des fichiers, exécutent des commandes ou modifient du code. Le SDK Agent vous offre les mêmes outils, boucle d'agent, et gestion du contexte qui alimentent Claude Code, programmables en Python et TypeScript.
Comparer le SDK Agent à d'autres outils Claude
Le SDK Agent, la CLI, le SDK Client et les Agents Gérés diffèrent par qui exécute l'agent, ce qui est intégré et comment vous y accédez. Trouvez la ligne qui correspond à la façon dont vous souhaitez construire et exécuter le vôtre.
| Vous souhaitez | Utilisez | Ce que vous obtenez |
|---|---|---|
| Intégrer l'agent Claude Code dans votre propre application Python ou TypeScript, dans un processus que vous exploitez | SDK Agent | Une bibliothèque qui exécute le binaire Claude Code, avec les capacités de Claude Code, telles que les outils intégrés, les permissions, les sessions et les hooks. |
| Faire du développement interactif ou exécuter des tâches ponctuelles depuis un terminal | Claude Code CLI | L'interface de terminal, conçue pour une utilisation interactive quotidienne. |
| Appeler l'API Claude directement depuis votre propre code | SDK Client | Accès direct à l'API Claude à partir de n'importe quel langage du SDK client. Vous écrivez vous-même la boucle d'outils, ou laissez le tool runner bêta du SDK client la piloter. |
| Faire héberger l'agent par Anthropic, configuré via l'API Claude | Agents Gérés | Un harnais d'agent hébergé qui exécute la boucle d'agent, avec des sessions dans un sandbox cloud géré par Anthropic ou un sandbox auto-hébergé sur votre propre infrastructure. Utilisez-le à partir du SDK pour votre langage, de la CLI ant, ou de l'API REST. |
Pour piloter la même boucle d'agent à partir d'un langage autre que Python ou TypeScript, exécutez la CLI en tant que sous-processus avec le drapeau -p et --output-format json.
Capacités
Ces capacités de Claude Code sont disponibles dans le SDK :
| Capacité | Ce qu'elle fait | En savoir plus |
|---|---|---|
| Outils intégrés | Lire, écrire, modifier des fichiers, exécuter des commandes et rechercher sur le web | Référence des outils |
| Hooks | Exécuter du code personnalisé à des points clés du cycle de vie de l'agent | Hooks |
| Sous-agents | Générer des agents spécialisés pour des sous-tâches ciblées | Sous-agents |
| MCP | Connecter des outils externes et des sources de données via le Model Context Protocol | MCP |
| Permissions | Contrôler quels outils s'exécutent automatiquement, lesquels nécessitent une approbation | Permissions |
| Sessions | Maintenir le contexte sur plusieurs échanges, reprendre ou diviser plus tard | Sessions |
| Skills, commandes et mémoire | Charger automatiquement à partir du répertoire .claude/ de votre projet et de ~/.claude/, comme Claude Code |
Skills, Commandes, Mémoire, Chargement de la configuration |
| Plugins | Empaqueter les skills, les agents, les hooks et les serveurs MCP, et les charger par chemin local | Plugins |
Commencer
Suivez le Démarrage rapide pour installer le SDK, définir votre clé API et créer votre premier agent, un agent qui trouve et corrige les bugs dans le code existant.
Journal des modifications
Consultez le journal des modifications complet pour les mises à jour du SDK, les corrections de bugs et les nouvelles fonctionnalités :
- SDK TypeScript : voir CHANGELOG.md
- SDK Python : voir CHANGELOG.md
Signaler les bugs
Si vous rencontrez des bugs ou des problèmes avec le SDK Agent :
- SDK TypeScript : signaler les problèmes sur GitHub
- SDK Python : signaler les problèmes sur GitHub
Directives de marque
Pour les partenaires intégrant le SDK Claude Agent, l'utilisation de la marque Claude est facultative. Lorsque vous référencez Claude dans votre produit :
Autorisé :
- « Claude Agent », préféré pour les menus déroulants
- « Claude », lorsque vous êtes déjà dans un menu étiqueté « Agents »
- « {YourAgentName} Powered by Claude », si vous avez un nom d'agent existant
Non autorisé :
- « Claude Code » ou « Claude Code Agent »
- Art ASCII ou éléments visuels de marque Claude Code qui imitent Claude Code
Votre produit doit conserver sa propre marque et ne pas sembler être Claude Code ou un produit Anthropic. Pour des questions sur la conformité de la marque, contactez l'équipe ventes d'Anthropic.
Licence et conditions
L'utilisation du SDK Claude Agent est régie par les Conditions commerciales d'Anthropic, y compris lorsque vous l'utilisez pour alimenter des produits et services que vous mettez à disposition de vos propres clients et utilisateurs finaux, sauf dans la mesure où un composant ou une dépendance spécifique est couvert par une licence différente comme indiqué dans le fichier LICENSE de ce composant.
Prochaines étapes
Ces ressources couvrent des détails techniques plus approfondis et des projets d'exemple pour construire avec le SDK Agent.
- Guide de démarrage : créez votre premier agent qui trouve et corrige les bugs
- Guide de migration : migrez des packages Claude Code SDK vers le SDK Agent
- Boucle d'agent : comment Claude planifie, appelle les outils et décide quand une tâche est terminée
- Agents d'exemple : applications de démonstration pour le développement local
- SDK TypeScript : référence API TypeScript complète et exemples
- SDK Python : référence API Python complète et exemples
- Conception du harnais d'agent : comment l'équipe Claude Code utilise les workflows dynamiques pour orchestrer de nombreux sous-agents à la fois