Passer au contenu principal
Créez des agents IA qui lisent autonomement les fichiers, exécutent des commandes, recherchent sur le web, modifient le code, et bien plus. 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. Pour en savoir plus sur la réflexion derrière la conception du harnais d’agent, consultez Un harnais pour chaque tâche : flux de travail dynamiques dans Claude Code sur le blog.
Le SDK Agent inclut des outils intégrés pour lire les fichiers, exécuter des commandes et modifier le code, afin que votre agent puisse commencer à travailler immédiatement sans que vous ayez besoin d’implémenter l’exécution des outils. Plongez dans le guide de démarrage rapide ou explorez des agents réels construits avec le SDK :

Guide de démarrage rapide

Créez un agent de correction de bugs en quelques minutes

Agents d'exemple

Assistant e-mail, agent de recherche, et bien plus

Commencer

1

Installer le SDK

Le SDK TypeScript regroupe un binaire Claude Code natif pour votre plateforme en tant que dépendance optionnelle, vous n’avez donc pas besoin d’installer Claude Code séparément.
2

Définir votre clé API

Obtenez une clé API à partir de la Console, puis définissez-la comme variable d’environnement.Sur macOS ou Linux :
Sur Windows PowerShell :
Le SDK prend également en charge l’authentification via des fournisseurs d’API tiers :
  • Amazon Bedrock : définissez la variable d’environnement CLAUDE_CODE_USE_BEDROCK=1 et configurez les identifiants AWS
  • Claude Platform on AWS : définissez CLAUDE_CODE_USE_ANTHROPIC_AWS=1 et ANTHROPIC_AWS_WORKSPACE_ID, puis configurez les identifiants AWS
  • Google Cloud’s Agent Platform : définissez la variable d’environnement CLAUDE_CODE_USE_VERTEX=1 et configurez les identifiants Google Cloud
  • Microsoft Azure : définissez la variable d’environnement CLAUDE_CODE_USE_FOUNDRY=1 et configurez les identifiants Azure
Consultez les guides de configuration pour Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform, ou Microsoft Foundry pour plus de détails.
Sauf approbation préalable, Anthropic n’autorise pas les développeurs tiers à proposer la connexion claude.ai ou les limites de débit pour leurs produits, y compris les agents construits sur le SDK Claude Agent. Veuillez utiliser les méthodes d’authentification par clé API décrites dans ce document à la place.
3

Exécuter votre premier agent

Cet exemple crée un agent qui liste les fichiers de votre répertoire courant en utilisant les outils intégrés.
Prêt à construire ? Suivez le Guide de démarrage rapide pour créer un agent qui trouve et corrige les bugs en quelques minutes.

Capacités

Tout ce qui rend Claude Code puissant est disponible dans le SDK :
Votre agent peut lire des fichiers, exécuter des commandes et rechercher dans les bases de code dès le départ. Les outils clés incluent :Cet exemple crée un agent qui recherche les commentaires TODO dans votre base de code :

Fonctionnalités de Claude Code

Le SDK prend également en charge la configuration basée sur le système de fichiers de Claude Code. Avec les options par défaut, le SDK les charge à partir de .claude/ dans votre répertoire de travail et ~/.claude/. Pour restreindre les sources qui se chargent, définissez setting_sources (Python) ou settingSources (TypeScript) dans vos options.

Comparer le SDK Agent à d’autres outils Claude

La plateforme Claude offre plusieurs façons de construire avec Claude. Voici comment le SDK Agent s’intègre :
Le SDK Client Anthropic vous donne un accès direct à l’API : vous envoyez des invites et implémentez vous-même l’exécution des outils. Le SDK Agent vous donne Claude avec l’exécution des outils intégrée.Avec le SDK Client, vous implémentez une boucle d’outils. Avec le SDK Agent, Claude la gère :

Journal des modifications

Consultez le journal des modifications complet pour les mises à jour du SDK, les corrections de bugs et les nouvelles fonctionnalités :

Signaler les bugs

Si vous rencontrez des bugs ou des problèmes avec le SDK Agent :

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 »)
  • « 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

Guide de démarrage rapide

Créez un agent qui trouve et corrige les bugs en quelques minutes

Agents d'exemple

Assistant e-mail, agent de recherche, et bien plus

SDK TypeScript

Référence API TypeScript complète et exemples

SDK Python

Référence API Python complète et exemples