Comprendre l’écosystème Claude

Le Claude Agent SDK : Claude Code transformé en brique logicielle

Vous connaissez déjà Claude Code, l’agent qui code dans votre terminal. Le Claude Agent SDK, c’est ce même moteur, mais que des développeurs peuvent intégrer dans leurs propres logiciels métier. Ce tutoriel vous permet de comprendre le principe pour en parler avec vos clients ou vos équipes techniques.

⏱️ Durée : 30 min

📶 Niveau : Découverte

🧰 Outil : Claude Agent SDK (Python / TypeScript)

🎯 Objectif de ce module

À la fin de ce tutoriel, vous serez capable d’expliquer ce qu’est le Claude Agent SDK, en quoi il diffère de Claude Code et de l’API Anthropic classique, et de reconnaître les cas où une entreprise ou un client l’utiliserait plutôt qu’un autre outil de la gamme Claude.

⚠️ Avant de commencer

Ce module est conceptuel : le Claude Agent SDK s’adresse à des développeurs Python ou TypeScript, pas aux utilisateurs bureautiques. Vous n’aurez pas de code à écrire.
Il est recommandé d’avoir déjà suivi les modules Claude Code et Le Model Context Protocol (MCP), sur lesquels ce module s’appuie directement.

De quoi parle-t-on exactement ?

Découverte

Le Claude Agent SDK (anciennement « Claude Code SDK ») permet à un développeur de reprendre le moteur qui fait fonctionner Claude Code — sa capacité à lire des fichiers, exécuter des commandes, chercher sur le web, éditer du code — et de le glisser à l’intérieur de son propre logiciel, sous sa propre marque.

Autrement dit : Claude Code est un produit fini qu’on utilise dans un terminal. Le Claude Agent SDK est la brique technique derrière ce produit, disponible pour que d’autres construisent leurs propres outils dessus.

Bon à savoir Anthropic explique que l’intérêt du SDK, c’est d’hériter des problèmes déjà résolus par l’équipe Claude Code : la gestion de la mémoire sur des tâches longues, les systèmes de permission, la coordination de plusieurs sous-agents. Un développeur qui repart de zéro devrait réinventer tout ça lui-même.

La différence avec l’API Anthropic « classique »

Découverte

C’est le point qui prête le plus à confusion, donc autant le fixer tout de suite avec une image simple.

Avec l’API Anthropic (Client SDK)	Avec le Claude Agent SDK
Le développeur envoie un message à Claude et reçoit une réponse.	Le développeur donne un objectif à Claude.
Si Claude a besoin d’un outil, le développeur doit lui-même écrire le code qui exécute cet outil, renvoyer le résultat, puis rappeler l’API.	Le SDK exécute lui-même les outils (lire un fichier, lancer une commande…) et boucle automatiquement jusqu’au résultat final.
Le développeur pilote chaque étape de la boucle.	Claude pilote sa propre trajectoire ; le développeur définit seulement le cadre (quels outils sont autorisés, quelles limites).

Astuce pour l’expliquer simplement Avec l’API classique, on donne à Claude une seule réponse à la fois, comme un échange de lettres. Avec le Agent SDK, on lui confie les clés de la maison et un objectif : « range le salon », et il décide lui-même dans quel ordre faire les choses.

Ce que le SDK apporte concrètement

Application

Tout ce qui fait la force de Claude Code est directement disponible dans le SDK :

Outils intégrés : lecture de fichiers, exécution de commandes, recherche dans une base de code, recherche web — sans que le développeur ait à les recoder.
Connexion au MCP : le SDK peut se brancher sur des serveurs MCP (voir notre module dédié) pour donner à l’agent accès à des outils métier tiers.
Outils personnalisés : un développeur peut créer ses propres fonctions (« si on te demande X, fais Y ») et les proposer à Claude comme des outils supplémentaires.
Sous-agents : possibilité de déléguer une portion de la tâche à un agent secondaire, pour ne pas polluer le contexte de l’agent principal.
Deux langages : disponible en Python (claude-agent-sdk) et en TypeScript (@anthropic-ai/claude-agent-sdk), avec les mêmes concepts des deux côtés.

À quoi ressemble un appel minimal (à titre d’illustration, pas à taper)

# Exemple simplifié, langage Python from claude_agent_sdk import query, ClaudeAgentOptions async for message in query( prompt= »Trouve et corrige le bug dans auth.py », options=ClaudeAgentOptions(allowed_tools=[« Read », « Edit », « Bash »]), ): print(message) # Claude lit le fichier, trouve le bug, le corrige — seul.

✅ Ce que vous devez retenir de cet exemple

Le développeur ne décrit que l’objectif et la liste des outils autorisés.
C’est le SDK, pas le développeur, qui gère la boucle « lire → décider → agir → vérifier ».
allowed_tools est un vrai garde-fou : on peut limiter précisément ce que l’agent a le droit de faire.

Qui utilise ça, et pour quoi ?

Application

Le SDK n’est pas réservé au code informatique. Anthropic cite plusieurs familles de cas d’usage déjà en production chez ses clients :

Agents de développement : le cas d’origine — lecture de code, écriture de tests, automatisation de pull requests.
Agents métier : revue de documents juridiques, contrôles de conformité financière, escalade de tickets support, workflows de validation à plusieurs étapes.
DevOps / infrastructure : tri automatique des tickets GitHub, réponse à incident, bots Slack.

Attention Le SDK fonctionne avec les modèles Claude — ce n’est pas un cadre « multi-fournisseurs » comme LangGraph ou crewAI, qui permettent de changer de modèle d’IA sans tout reconstruire. C’est un choix assumé par Anthropic : en échange, le SDK exploite à fond les capacités propres à Claude (réflexion étendue, usage d’outils, computer use).

Claude Code, le SDK, ou l’API : comment s’y retrouver

Maîtrise

Pour situer clairement chaque brique de la gamme, voici la grille à avoir en tête :

Outil	Pour qui	Ce qu’on en fait
Claude Code	Un développeur, en direct, dans un terminal ou un IDE	Coder au quotidien, sans rien construire soi-même
Claude Agent SDK	Une équipe technique qui construit un logiciel	Intégrer un agent Claude à l’intérieur d’un produit, sous sa propre marque
API Anthropic (Client SDK)	Un développeur qui veut un contrôle total	Envoyer un prompt, recevoir une réponse, gérer soi-même chaque étape
Managed Agents	Une équipe qui ne veut pas gérer l’infrastructure	API hébergée : Anthropic fait tourner l’agent et l’environnement d’exécution

Bon à savoir Beaucoup d’équipes utilisent les deux à la fois : Claude Code pour le développement quotidien, et le Agent SDK pour la mise en production — car les habitudes prises avec l’un se retrouvent directement dans l’autre.

📖 Mini-glossaire

Agent (vs workflow)Un workflow suit une structure fixe décidée à l’avance. Un agent reçoit un objectif et construit lui-même sa trajectoire pour l’atteindre.

Boucle agentiqueLe cycle « rassembler le contexte → agir avec les outils → vérifier le résultat » que l’agent répète seul jusqu’à la fin de la tâche.

Outil personnaliséUne fonction écrite par le développeur et proposée à Claude comme un outil qu’il peut décider d’utiliser.

Sous-agentUn agent secondaire auquel l’agent principal délègue une partie de la tâche, pour ne pas surcharger son propre contexte.

🛠️ Atelier A3I — Vérifier votre compréhension

Pas de code à écrire ici : l’objectif est de savoir expliquer le Claude Agent SDK à un client ou un collègue.

Niveau Découverte

Un client vous demande : « Claude Code et le Claude Agent SDK, c’est la même chose ? » Rédigez en 3 phrases maximum la réponse que vous lui donneriez.

Niveau Application

Une entreprise veut créer un chatbot interne qui répond aux questions RH en allant chercher l’information dans ses propres documents. Quel outil de la gamme Claude est le plus adapté : l’API classique, le Claude Agent SDK, ou Claude Code ? Justifiez votre choix.

Niveau Maîtrise

Listez deux avantages et une limite du Claude Agent SDK par rapport à des cadres concurrents « multi-fournisseurs » comme LangGraph. Formulez votre réponse comme si vous conseilliez un client indécis.

📝 Voir des pistes de corrigé

Découverte : Non. Claude Code est l’outil fini qu’on utilise directement. Le Claude Agent SDK est le moteur derrière Claude Code, mis à disposition des développeurs pour qu’ils construisent leurs propres logiciels avec.

Application : Le Claude Agent SDK, car il faut un agent capable d’aller chercher l’information par lui-même (dans les documents RH) et de l’intégrer dans un produit interne sous la marque de l’entreprise — ce n’est ni un usage ponctuel (API classique) ni un outil personnel de développement (Claude Code).

Maîtrise : Avantages : le SDK hérite directement des mécanismes déjà éprouvés par Claude Code (permissions, mémoire, sous-agents) et exploite à fond les capacités propres à Claude. Limite : contrairement à LangGraph, il ne permet pas de changer facilement de fournisseur de modèle d’IA — c’est un choix pertinent seulement si l’entreprise est déjà engagée avec Anthropic.

✅ Auto-évaluation — J’ai réussi si…

Je sais expliquer la différence entre Claude Code, le Claude Agent SDK et l’API Anthropic classique.
Je comprends ce qu’est une « boucle agentique » et pourquoi elle change la manière de travailler avec Claude.
Je peux citer au moins deux familles de cas d’usage réels du Claude Agent SDK.
Je sais identifier, face à un besoin client, si c’est le SDK, l’API ou Claude Code qui est adapté.