Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Starting June 15, 2026, Agent SDK and claude -p usage on subscription plans will draw from a new monthly Agent SDK credit, separate from your interactive usage limits. See Use the Claude Agent SDK with your Claude plan for details.
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.
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

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

Commencer

1

Installer le SDK

npm install @anthropic-ai/claude-agent-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 :
export ANTHROPIC_API_KEY=your-api-key
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 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, Claude Platform on AWS, 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.
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.
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())
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 :
OutilCe qu’il fait
ReadLire n’importe quel fichier du répertoire de travail
WriteCréer de nouveaux fichiers
EditEffectuer des modifications précises aux fichiers existants
BashExécuter des commandes de terminal, des scripts, des opérations git
MonitorSurveiller un script en arrière-plan et réagir à chaque ligne de sortie en tant qu’événement
GlobTrouver des fichiers par motif (**/*.ts, src/**/*.py)
GrepRechercher le contenu des fichiers avec regex
WebSearchRechercher sur le web pour obtenir des informations actuelles
WebFetchRécupérer et analyser le contenu des pages web
AskUserQuestionPoser à l’utilisateur des questions de clarification avec des options à choix multiples
Cet exemple crée un agent qui recherche les commentaires TODO dans votre base de code :
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions


async def main():
    async for message in query(
        prompt="Find all TODO comments and create a summary",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Glob", "Grep"]),
    ):
        if hasattr(message, "result"):
            print(message.result)


asyncio.run(main())

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.
FonctionnalitéDescriptionEmplacement
SkillsCapacités spécialisées définies en Markdown.claude/skills/*/SKILL.md
Slash commandsCommandes personnalisées pour les tâches courantes.claude/commands/*.md
MemoryContexte du projet et instructionsCLAUDE.md ou .claude/CLAUDE.md
PluginsÉtendre avec des commandes personnalisées, des agents et des serveurs MCPProgrammatique 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 :
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 :
# Client SDK: You implement the tool loop
response = client.messages.create(...)
while response.stop_reason == "tool_use":
    result = your_tool_executor(response.tool_use)
    response = client.messages.create(tool_result=result, **params)

# Agent SDK: Claude handles tools autonomously
async for message in query(prompt="Fix the bug in auth.py"):
    print(message)

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