Quelle différence entre le Claude Agent SDK et le SDK client d'Anthropic ?

Avec le SDK client, vous appelez l'API et écrivez vous-même la boucle d'appel d'outils (ou la confiez au tool runner). Le Claude Agent SDK fournit la boucle complète de Claude Code, avec des outils intégrés, des permissions, des sessions et des hooks.

Claude Agent SDK : présentation et premier agent

Q: Peut-on utiliser le Claude Agent SDK hors de l'API d'Anthropic ?

Oui : sa documentation décrit l'authentification par Amazon Bedrock, Claude Platform on AWS, Google Cloud et Microsoft Foundry, en plus de la clé d'API d'Anthropic.

Le Claude Agent SDK est le kit de développement (SDK, software development kit) d'agents d'Anthropic. Il permet d'intégrer à une application Python ou TypeScript la même boucle, les mêmes outils et la même gestion du contexte que Claude Code : lire et modifier des fichiers, lancer des commandes, chercher sur le web, déléguer à des sous-agents, le tout sous des règles de permission que vous fixez. Cette fiche résume sa documentation, lue le 15/11/2026.

Où il se situe parmi les outils d'Anthropic

La documentation compare quatre façons de construire avec Claude :

Vous voulez	Outil	Ce que vous obtenez
Intégrer l'agent de Claude Code dans votre application, sur vos machines	Claude Agent SDK	Une bibliothèque avec outils intégrés, permissions, sessions et hooks
Travailler en interactif dans un terminal	Claude Code (interface en ligne de commande)	L'outil du quotidien pour développer
Appeler directement l'interface de programmation (API)	SDK client	Vous écrivez la boucle, ou vous la confiez au « tool runner »
Faire héberger l'agent par Anthropic	Claude Managed Agents	Un agent hébergé, dans un bac à sable géré par Anthropic ou chez vous

Si votre besoin se limite à quelques appels d'outils dans une application existante, le SDK client suffit souvent (voir function calling). Le Claude Agent SDK prend tout son sens quand l'agent doit travailler sur des fichiers, lancer des commandes ou mener une tâche longue.

Ce qu'il apporte

Fonction	Rôle
Outils intégrés	`Read`, `Edit`, `Write`, `Glob`, `Grep`, `Bash`, `WebSearch`, `WebFetch`, et des outils d'orchestration (sous-agents, questions à l'utilisateur, suivi de tâches)
Hooks	Du code exécuté à des moments clés : avant ou après un outil, à la fin, avant un résumé du contexte
Sous-agents	Des agents spécialisés pour des sous-tâches, avec leur propre contexte
MCP	Brancher des outils et sources externes via le Model Context Protocol
Permissions	Décider quels outils s'exécutent seuls et lesquels demandent une validation
Sessions	Garder le contexte d'un échange à l'autre, reprendre ou dupliquer une session

Installer et lancer un premier agent

Prérequis indiqués par la documentation : Node.js 18.14 ou plus, ou Python 3.10 ou plus, et un compte Anthropic. Installation :

Python : pip install claude-agent-sdk (ou uv add claude-agent-sdk) ;
TypeScript : npm install @anthropic-ai/claude-agent-sdk.

La clé d'API se fournit par la variable d'environnement ANTHROPIC_API_KEY ; le SDK ne lit pas les fichiers .env de lui-même. Il accepte aussi Amazon Bedrock, Claude Platform on AWS, Google Cloud et Microsoft Foundry, chacun avec sa variable d'activation.

L'exemple du guide de démarrage, réduit à l'essentiel : un agent qui relit un fichier et corrige les bogues qui le feraient planter.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions, ResultMessage

async def main():
    async for message in query(
        prompt="Review utils.py for bugs that would cause crashes. Fix any issues you find.",
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Edit", "Glob"],
            permission_mode="acceptEdits",
        ),
    ):
        if isinstance(message, ResultMessage):
            print(f"Done: {message.subtype}")

asyncio.run(main())

query lance la boucle et renvoie les messages au fil de l'eau : raisonnement, appels d'outils, résultats, puis un message final avec le statut, le coût et l'identifiant de session.

Les réglages à connaître avant la production

Réglage	Effet	À retenir
`tools`	Limite les outils intégrés disponibles	C'est lui qui restreint l'ensemble d'outils
`allowed_tools`	Pré-approuve des outils	N'empêche pas l'agent d'appeler les autres, qui passent par le mode de permission
`disallowed_tools`	Interdit des outils ou des commandes	S'applique dans tous les modes
`permission_mode`	Niveau de validation : `default`, `dontAsk`, `acceptEdits`, `plan`, `auto`, `bypassPermissions`	`bypassPermissions` est réservé aux environnements isolés
`max_turns`	Nombre maximal de tours	Sans limite par défaut
`max_budget_usd`	Dépense estimée maximale	Sans limite par défaut ; couvre les sous-agents
`effort`	Profondeur de raisonnement	`low` pour les tâches simples, moins de jetons

La documentation recommande, pour une application interactive, le mode default avec une fonction de validation ; pour un agent qui modifie des fichiers sur un poste de développement, acceptEdits ; et de réserver bypassPermissions à l'intégration continue, aux conteneurs ou à d'autres environnements isolés. Le détail est sur limiter les permissions et humain dans la boucle.

Lire le résultat

Le message final porte un sous-type : success, ou une erreur comme error_max_turns, error_max_budget_usd ou error_during_execution. Tous les sous-types indiquent le coût total (total_cost_usd), l'usage, le nombre de tours et l'identifiant de session, ce qui permet de reprendre une session interrompue et de suivre la dépense par tâche (voir coût d'un agent).

Conditions d'usage

La documentation précise deux points pour ceux qui construisent un produit dessus :

l'usage est régi par les conditions commerciales d'Anthropic, y compris quand l'agent sert vos propres clients ;
sauf accord préalable, Anthropic n'autorise pas les produits tiers à proposer la connexion claude.ai ou ses limites d'usage : l'authentification se fait par clé d'API. Le produit doit garder sa propre marque ; « Claude Agent » ou « {Votre agent} Powered by Claude » sont admis, « Claude Code » ne l'est pas.

Pour comparer avec les autres frameworks (LangGraph, CrewAI, OpenAI Agents SDK, Microsoft Agent Framework), voyez frameworks d'agents.