Claude Agent SDK : créer des agents natifs Anthropic

Le Claude Agent SDK est le framework officiel d'Anthropic pour créer des agents IA prêts pour la production directement sur les modèles Claude. Au lieu de programmer à la main la boucle d'outils d'un agent, le SDK fournit un harness d'agent complet : boucles d'outils automatiques, intégration MCP native, sous-agents, gestion des sessions et du contexte, ainsi qu'un système intégré de permissions et de sandbox. Il est issu du Claude Code SDK le 29 septembre 2025 et utilise le même ensemble d'outils que celui sur lequel repose Claude Code.

Trois réponses rapides

• Ce que c'est : un SDK natif Anthropic (Python et TypeScript) qui fournit à Claude des boucles d'outils gérées, des sessions, du sandboxing et des sous-agents, c'est-à-dire tout ce qu'il faudrait sinon construire soi-même autour d'un simple appel à l'API d'un LLM.
• Quand l'utiliser : agents de codage, agents de recherche et tâches longues en plusieurs étapes dans une stack qui mise délibérément sur les modèles Claude.
• Points de vigilance : dépendance au fournisseur Claude, API encore en v0.x avec des breaking changes (en 2026), SDK Python sous licence MIT, SDK TypeScript propriétaire, utilisation des deux sous les Anthropic Commercial Terms.

Du Claude Code SDK au Claude Agent SDK

À l'origine, le framework s'appelait Claude Code SDK et constituait le socle technique de l'agent de codage Claude Code. Avec le changement de nom du 29 septembre 2025, Anthropic lui donne délibérément un positionnement plus large : un harness généraliste pour les agents qui utilisent des outils, le codage n'étant plus qu'un cas d'usage parmi d'autres. L'idée centrale reste le « dogfooding » : les développeurs disposent exactement du même ensemble d'outils et de la même mécanique de boucle qu'Anthropic utilise en interne pour Claude Code, dont Read, Write, Edit, Bash, Glob, Grep, WebFetch et WebSearch.

C'est la différence décisive avec le simple Anthropic Client SDK. Avec le Client SDK, tu écris toi-même la boucle de l'agent : appeler le modèle, récupérer l'appel d'outil, exécuter l'outil, renvoyer le résultat, rappeler le modèle. L'Agent SDK prend en charge précisément cette orchestration et la complète par des briques prêtes pour la production. Anthropic elle-même conseille, dans « Building Effective Agents » (décembre 2024), de commencer par travailler directement avec l'API du LLM, car de nombreux patterns s'implémentent en quelques lignes de code. Si tu utilises un framework, tu devrais comprendre le code sous-jacent. Le principe : d'abord la solution la plus simple, plus de complexité seulement si nécessaire. Si tu n'as besoin que d'un seul appel API, tu n'as pas besoin de framework ; un harness comme l'Agent SDK ne devient rentable qu'avec de longues chaînes d'outils en plusieurs étapes.

Les briques essentielles

Utilisation d'outils et ensemble d'outils de Claude Code. Le SDK embarque les outils éprouvés Read, Write, Edit, Bash, Glob, Grep, WebFetch et WebSearch. Un agent peut ainsi lire et écrire des fichiers, exécuter des commandes shell et récupérer du contenu web, sans que tu aies à définir et sécuriser ces outils toi-même.

Intégration MCP native. Le Model Context Protocol (MCP) est ancré nativement dans le Claude Agent SDK ; les serveurs MCP peuvent même tourner in-process. MCP standardise l'accès aux outils externes, aux sources de données et aux API. Depuis son transfert à l'Agentic AI Foundation (AAIF) de la Linux Foundation le 9 décembre 2025, le protocole est neutre vis-à-vis des fournisseurs ; selon Anthropic, il a dépassé en avril 2026 les 110 millions de téléchargements mensuels du SDK et les 10 000 serveurs actifs. Pour les agences, cela signifie que les intégrations développées une fois sous forme de serveur MCP sont réutilisables en dehors de l'écosystème Anthropic.

Sous-agents et sessions. Au lieu d'un modèle de graphe classique (comme avec LangGraph), le SDK s'appuie sur des sous-agents et des sessions pour les processus en plusieurs étapes et la répartition du travail. Un agent principal peut lancer des sous-agents spécialisés pour des sous-tâches ; les sessions conservent le contexte sur plusieurs étapes. Il n'existe officiellement pas de prise en charge native d'A2A (protocole Agent-to-Agent), ce qui distingue le SDK de Microsoft Agent Framework, CrewAI ou Pydantic AI.

Gestion du contexte et des permissions, plus sandbox. Le SDK gère le contexte via la session et comprend un système de permissions intégré ainsi que du sandboxing. Les permissions déterminent les actions qu'un agent a le droit d'effectuer, par exemple quels fichiers il peut écrire ou quelles commandes il peut exécuter : un levier important pour le human-in-the-loop et les exigences d'audit.

Observabilité via des hooks. Contrairement à LangGraph (LangSmith) ou Pydantic AI (Logfire), le SDK ne dispose pas d'une plateforme d'observabilité first-party mature. Il fonctionne à base de hooks et s'intègre à l'Anthropic Console. Si tu fais tourner le SDK en pur self-hosting, tu dois ajouter ton propre logging structuré pour la traçabilité et les justificatifs pertinents au regard du règlement européen sur l'IA.

Place dans l'écosystème Anthropic

La force du SDK réside dans son couplage étroit avec les modèles Claude et avec MCP. Dans le modèle en couches des frameworks, il se situe avec l'OpenAI Agents SDK au niveau agent runtime/harness, c'est-à-dire une couche au-dessus des SDK bruts des fournisseurs, avec un caractère différent de celui de la couche framework (LangGraph, CrewAI, Pydantic AI). Cette proximité est à la fois un avantage et une limite : l'optimisation et l'ensemble d'outils sont taillés pour Claude, mais il est impossible de basculer vers GPT, Gemini ou des modèles locaux.

Côté adoption : selon les statistiques npm, le paquet TypeScript a atteint environ 12,1 millions de téléchargements la semaine du 5 au 11 octobre 2026, contre environ 1,85 million seulement la semaine du 1er au 7 février 2026. Avec Apple Xcode 26.3, un éditeur de premier plan a intégré le SDK nativement.

Perspective européenne : souveraineté et licence

Pour les décideurs B2B en Europe, deux points sont essentiels. Premièrement, la résidence des données : l'endpoint direct d'Anthropic se trouve aux États-Unis. Pour des exigences strictes en matière d'UE et de RGPD, il faut passer par AWS Bedrock (région UE), Google Vertex ou Azure AI Foundry. Le code du SDK Python est sous licence MIT, mais le paquet embarque la CLI propriétaire Claude Code. Le SDK TypeScript est entièrement propriétaire. Les deux tournent en local, l'endpoint du modèle non. D'où le classement « souveraineté moyenne » face à des frameworks entièrement auto-hébergeables comme n8n (éditeur allemand), LangGraph ou Pydantic AI.

Deuxièmement, la licence : le code du SDK Python est sous licence MIT. Selon le README, le paquet embarque toutefois la CLI Claude Code, qui est propriétaire selon son fichier de licence (All rights reserved). Le SDK TypeScript est entièrement propriétaire. L'utilisation des deux SDK relève des Anthropic Commercial Terms of Service, même si tu t'en sers pour faire tourner des produits destinés à tes propres clients. Cette distinction doit figurer clairement dans toute évaluation de fournisseurs et tout examen côté achats.

Exemple concret

Imaginons qu'une agence développe un agent de recherche qui, pour chaque demande, parcourt des documents Markdown internes, établit une fiche concurrent et enregistre le résultat dans un fichier. Avec le Client SDK, l'équipe devrait écrire elle-même toute la boucle d'outils, la gestion des erreurs et la gestion du contexte : selon des analyses tierces portant sur des agents ReAct comparables, entre 40 et plus de 100 lignes de code d'orchestration. Avec le Claude Agent SDK, tout se réduit à une configuration et un appel (exemple Python simplifié, en octobre 2026, API v0.x) :

```python
import asyncio
from claude_agent_sdk import ClaudeAgentOptions, ClaudeSDKClient

options = ClaudeAgentOptions(
model="claude-...", # lié aux modèles Claude
allowed_tools=["Read", "Glob", "Grep", "WebFetch", "WebSearch", "Agent"],
permission_mode="default", # Write n'est pas autorisé d'avance
can_use_tool=verifier_droits, # demande confirmation avant d'écrire (human-in-the-loop)
mcp_servers={"crm": crm_mcp_server}, # connexion MCP native, p. ex. CRM
agents={"recherche": agent_recherche}, # sous-agent dédié à la recherche
setting_sources=["project"], # ne charger que les paramètres du projet et CLAUDE.md
)

async def main():
async with ClaudeSDKClient(options=options) as client:
await client.query("Établis une fiche concurrent sur l'entreprise X.")
async for message in client.receive_response():
print(message)

asyncio.run(main())
```

Point important lors du passage depuis l'ancien nom : ClaudeCodeOptions s'appelle désormais ClaudeAgentOptions. setting_sources définit quels fichiers de paramètres (user, project, local) sont chargés. Sans valeur indiquée, le SDK charge les trois selon la référence Python ; si tu définis la valeur explicitement, tu dois inclure "project" pour que les règles du projet et CLAUDE.md s'appliquent. Les boucles d'outils, le lancement du sous-agent de recherche, la gestion du contexte de session et la demande d'autorisation avant l'écriture du fichier sont pris en charge par le SDK.

Pour les agences et le B2B

Le Claude Agent SDK est le bon choix lorsque la décision stratégique sur le modèle se porte de toute façon sur Claude et que l'accent est mis sur des agents de codage, de recherche ou de longue durée. Grâce à un harness éprouvé et à la connexion MCP native, il réduit considérablement le time-to-production. Si, en revanche, tu as besoin d'indépendance vis-à-vis du modèle, d'une communication multi-agents native via A2A, d'une observabilité first-party mature ou d'une souveraineté européenne complète sans éditeur américain, tu devrais examiner LangGraph, Pydantic AI ou n8n. Pour ses clients en Europe, Blck Alpaca évalue conjointement le framework, le mode d'hébergement (Bedrock/Vertex/Azure UE) et les implications de licence, afin que le prototype devienne une exploitation en production conforme au RGPD. Toutes les indications de versions, de prix et d'adoption datent de 2026 et doivent être revérifiées avant le lancement d'un projet.