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 répondent chacun à des besoins différents. Utilisez le tableau pour trouver celui qui correspond à ce que vous construisez.
| Si vous... | Utilisez | Pourquoi |
|---|---|---|
| Construisez un agent sans implémenter vous-même la boucle d'outils | SDK Agent | Une bibliothèque Python ou TypeScript qui exécute la boucle d'agent pour vous. |
| Faites du développement interactif ou exécutez des tâches ponctuelles depuis un terminal | Claude Code CLI | L'interface de terminal, conçue pour une utilisation interactive quotidienne. |
| Appelez l'API directement et implémentez vous-même la boucle d'outils | SDK Client | Accès direct à l'API Anthropic plutôt qu'à Claude Code. Vous implémentez vous-même la boucle d'outils. |
| Exécutez des agents de longue durée ou asynchrones sans gérer votre propre infrastructure de sandbox ou de session | Agents Gérés | API REST hébergée, un produit distinct du SDK Agent. Anthropic exécute l'agent et le sandbox. |
Le SDK est disponible en tant que bibliothèque pour Python et TypeScript uniquement. Pour piloter la même boucle d'agent à partir d'un autre langage, 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