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.

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 donne les mêmes outils, boucle d'agent et gestion du contexte qui alimentent Claude Code, programmables 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 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

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.

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	Étendre avec des commandes personnalisées, des agents et des serveurs MCP	Programmatique via l'option `plugins`

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 complet des modifications 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 des 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 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 couverte 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

Installer le SDK
Définir votre clé API
Obtenez une clé API depuis la Console, puis définissez-la comme variable d'environnement :
export ANTHROPIC_API_KEY=your-api-key
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 Azure : définissez la variable d'environnement CLAUDE_CODE_USE_FOUNDRY=1 et configurez les identifiants Azure
Consultez les guides de configuration pour Bedrock, Vertex AI, ou Azure AI 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.

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.

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"])
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())