Aperçu du SDK Agent

Le SDK Claude Code a été renommé en SDK Claude Agent. Si vous migrez depuis l'ancien SDK, consultez le Guide de migration.

Construisez des agents IA qui lisent autonomement des fichiers, exécutent des commandes, recherchent sur le web, modifient du code, et bien plus. Le SDK Agent vous donne les mêmes outils, boucle d'agent et gestion du contexte qui alimentent Claude Code, programmable en Python et TypeScript.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"])
    ):
        print(message)  # Claude reads the file, finds the bug, edits it

asyncio.run(main())

Le SDK Agent inclut des outils intégrés pour lire des fichiers, exécuter des commandes et modifier du 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

Construisez un agent de correction de bugs en quelques minutes

Agents d'exemple

Capacités

Tout ce qui rend Claude Code puissant est disponible dans le SDK :

Fonctionnalités de Claude Code

Le SDK supporte également la configuration basée sur le système de fichiers de Claude Code. Pour utiliser ces fonctionnalités, définissez setting_sources=["project"] (Python) ou settingSources: ['project'] (TypeScript) dans vos options.

Fonctionnalité	Description	Emplacement
Skills	Capacités spécialisées définies en Markdown	`.claude/skills/SKILL.md`
Slash commands	Commandes personnalisées pour les tâches courantes	`.claude/commands/*.md`
Memory	Contexte du projet et instructions	`CLAUDE.md` ou `.claude/CLAUDE.md`
Plugins	Étendez avec des commandes personnalisées, des agents et des serveurs MCP	Programmatique via l'option `plugins`

Commencer

Prêt à construire ? Suivez le Guide de démarrage rapide pour créer un agent qui trouve et corrige les bugs en quelques minutes.

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 :

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. Lors de la référence à Claude dans votre produit :

Autorisé :

« Claude Agent » (préféré pour les menus déroulants)
« Claude » (quand 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 maintenir sa propre marque et ne pas sembler être Claude Code ou un produit Anthropic. Pour des questions sur la conformité de la marque, contactez notre équipe commerciale.

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

Construisez un agent qui trouve et corrige les bugs en quelques minutes

Agents d'exemple

Installer Claude Code
Le SDK utilise Claude Code comme son runtime :
Consultez Configuration de Claude Code pour Windows et d'autres options.
Installer le SDK
Définir votre clé API
export ANTHROPIC_API_KEY=your-api-key
Obtenez votre clé à partir de la Console.
Le SDK supporte également 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
- Google Vertex AI : Définissez la variable d'environnement CLAUDE_CODE_USE_VERTEX=1 et configurez les identifiants Google Cloud
- Microsoft Foundry : Définissez la variable d'environnement CLAUDE_CODE_USE_FOUNDRY=1 et configurez les identifiants Azure
Sauf approbation préalable, nous n'autorisons pas les développeurs tiers à offrir 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.

Exécuter votre premier agent

Cet exemple crée un agent qui liste les fichiers dans votre répertoire courant en utilisant les outils intégrés.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
    ):
        print(message)

asyncio.run(main())