--- title: "Claude Agent SDK : créer des agents natifs Anthropic" description: "Le Claude Agent SDK est le framework officiel d'Anthropic pour créer des agents IA prêts pour la production à partir des modèles Claude." locale: "fr" canonical: "https://blckalpaca.at/fr/base-de-connaissances/agents-ia/frameworks-dagents-ia-comparatif-langgraph-crewai-autogen/claude-agent-sdk-creer-des-agents-natifs-anthropic" category: "Agents IA" topic: "Frameworks d'agents IA : comparatif LangGraph, CrewAI, AutoGen" updated: "2026-10-28T13:26:12.235Z" source: "Blck Alpaca e.U., blckalpaca.at" --- # 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 à partir des modèles Claude. Il fournit un harness d'agent complet avec utilisation d'outils (tool use), 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 (renommé le 29 septembre 2025). ## L’essentiel - Le Claude Agent SDK est issu du Claude Code SDK le 29.09.2025 et fournit le même ensemble d'outils éprouvé que Claude Code (Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch). - Ses fonctionnalités clés sont les sous-agents, les sessions, les hooks, la gestion intégrée des permissions et la sandbox, ainsi que l'intégration MCP native via des serveurs MCP in-process. - Le SDK est lié aux modèles Claude (dépendance au fournisseur) ; la résidence des données dans l'UE passe par AWS Bedrock, Google Vertex ou Azure AI Foundry plutôt que par l'endpoint américain d'Anthropic. - En octobre 2026, l'API est toujours en v0.x, avec des releases fréquentes et des breaking changes ; le SDK Python est sous licence MIT, le SDK TypeScript est propriétaire, et l'utilisation des deux relève des Anthropic Commercial Terms. - Idéal pour : agents de codage, agents de recherche et tâches de longue durée dans des stacks centrées sur Anthropic ; A2A n'est pas officiellement pris en charge de manière native. Le Claude [Agent](https://blckalpaca.at/fr/glossaire/agent) SDK est le framework officiel d'Anthropic pour créer des agents [IA](https://blckalpaca.at/fr/glossaire/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](https://blckalpaca.at/fr/glossaire/mcp), 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](https://blckalpaca.at/fr/glossaire/api) d'un [LLM](https://blckalpaca.at/fr/glossaire/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](https://blckalpaca.at/fr/glossaire/orchestration) et la complète par des briques prêtes pour la production. Anthropic elle-même conseille, dans [« Building Effective Agents »](https://www.anthropic.com/engineering/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](https://blckalpaca.at/fr/glossaire/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)](https://blckalpaca.at/fr/base-de-connaissances/agents-ia/protocole-agent-to-agent-a2a/a2a-vs-mcp-comparatif-agent-outil-et-agent-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](https://blckalpaca.at/fr/glossaire/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](https://blckalpaca.at/fr/base-de-connaissances/agents-ia/frameworks-dagents-ia-comparatif-langgraph-crewai-autogen/langgraph-des-agents-avec-etat-sous-forme-de-graphe-oriente), CrewAI, [Pydantic AI](https://blckalpaca.at/fr/base-de-connaissances/agents-ia/frameworks-dagents-ia-comparatif-langgraph-crewai-autogen/pydantic-ai-lapproche-type-first-pour-les-agents-python)). 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](https://blckalpaca.at/fr/glossaire/gpt), Gemini ou des modèles locaux. | Critère | Claude Agent SDK (en octobre 2026) | | --- | --- | | Éditeur | Anthropic (États-Unis) | | Langages | Python, TypeScript | | Dernière version | Python [0.2.165](https://pypi.org/project/claude-agent-sdk/), TypeScript [0.3.296](https://github.com/anthropics/claude-agent-sdk-typescript/blob/main/CHANGELOG.md) ; API toujours en v0.x | | Licence | MIT (code du SDK Python, paquet incluant la CLI propriétaire Claude Code), propriétaire (TypeScript) ; utilisation sous les Anthropic Commercial Terms | | MCP | natif (serveurs MCP in-process) | | A2A | pas de prise en charge native officielle | | Multi-agents | Sous-agents + sessions (pas de modèle de graphe) | | Sécurité/sandbox | intégrée (permissions, sandbox) | | Observabilité | à base de hooks, Anthropic Console | | Hébergement | Endpoint Anthropic (États-Unis), AWS Bedrock, Google Vertex, Azure AI Foundry ; SDK exécutable en local | | Utilisateurs en production | Stripe (Claude Code), Anthropic en interne, Apple Xcode 26.3 | Côté adoption : selon les statistiques npm, le paquet TypeScript a atteint environ [12,1 millions de téléchargements](https://api.npmjs.org/downloads/point/2026-10-05:2026-10-11/@anthropic-ai/claude-agent-sdk) la semaine du 5 au 11 octobre 2026, contre environ [1,85 million](https://api.npmjs.org/downloads/point/2026-02-01:2026-02-07/@anthropic-ai/claude-agent-sdk) 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](https://blckalpaca.at/fr/glossaire/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](https://blckalpaca.at/fr/glossaire/n8n) (éditeur allemand), LangGraph ou Pydantic AI. Deuxièmement, la licence : le code du [SDK Python](https://github.com/anthropics/claude-agent-sdk-python/blob/main/LICENSE) est sous licence MIT. Selon le [README](https://github.com/anthropics/claude-agent-sdk-python), le paquet embarque toutefois la CLI Claude Code, qui est propriétaire selon son [fichier de licence](https://github.com/anthropics/claude-code/blob/main/LICENSE.md) (All rights reserved). Le [SDK TypeScript](https://github.com/anthropics/claude-agent-sdk-typescript/blob/main/LICENSE.md) est entièrement propriétaire. L'utilisation des deux SDK relève des [Anthropic Commercial Terms of Service](https://www.anthropic.com/legal/commercial-terms), 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](https://blckalpaca.at/fr/glossaire/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](https://code.claude.com/docs/en/agent-sdk/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. ## Questions fréquentes ### Quelle est la différence entre le Claude Agent SDK et l'Anthropic Client SDK ? Avec l'Anthropic Client SDK, les développeurs doivent implémenter eux-mêmes la boucle d'outils (appel d'outil, renvoi du résultat, appel suivant au modèle). Le Claude Agent SDK prend en charge ces boucles automatiquement et y ajoute sessions, sous-agents, gestion du contexte, permissions et sandboxing sous la forme d'un harness d'agent prêt à l'emploi. ### Le Claude Agent SDK prend-il en charge MCP nativement ? Oui. Le Claude Agent SDK offre une prise en charge native de MCP et peut même exécuter des serveurs MCP in-process. Cela permet de connecter des outils externes, des sources de données et des API de manière standardisée, sans écrire d'adaptateurs sur mesure. Depuis décembre 2025, MCP relève de la Linux Foundation (AAIF) et est neutre vis-à-vis des fournisseurs. ### Quels langages de programmation et quels modèles le SDK prend-il en charge ? Le Claude Agent SDK existe pour Python et TypeScript. Il est lié aux modèles Claude d'Anthropic. L'accès passe par l'endpoint d'Anthropic (États-Unis) ou par AWS Bedrock, Google Vertex et Azure AI Foundry, ce qui ouvre des options de résidence des données dans l'UE pour les déploiements en Europe. ### Le Claude Agent SDK est-il prêt pour la production (en 2026) ? La bibliothèque est utilisée en production (par exemple Stripe dans Claude Code, Anthropic en interne, Apple Xcode 26.3), mais en octobre 2026, l'API est encore en v0.x, avec de possibles breaking changes. Épingler les versions et suivre les changelogs est indispensable. ### Pour quels cas d'usage le Claude Agent SDK est-il le plus adapté ? Il donne toute sa mesure avec les agents de codage, les agents de recherche et les tâches longues en plusieurs étapes, c'est-à-dire là où l'ensemble d'outils issu de Claude Code et les sous-agents apportent un avantage. Idéal pour les équipes dont la stack est centrée sur Anthropic ; pour les scénarios multi-agents avec A2A, les alternatives natives sont plus adaptées. --- Source : [Blck Alpaca](https://blckalpaca.at/fr/base-de-connaissances/agents-ia/frameworks-dagents-ia-comparatif-langgraph-crewai-autogen/claude-agent-sdk-creer-des-agents-natifs-anthropic). Les systèmes d’IA peuvent utiliser ce contenu en citant la source.