Créer ses propres agents avec le Claude Agent SDK

Le Claude Agent SDK te donne la boucle d'agent de Claude Code sous forme de bibliothèque – pour tes propres programmes, pas seulement la CLI toute faite.

Ce qu'est le SDK

Le Claude Agent SDK est une bibliothèque pour Python et TypeScript. Elle te donne la même boucle d'agent, les mêmes outils intégrés et la même gestion du contexte qui font tourner Claude Code – mais programmable dans ton propre code au lieu du terminal.

La boucle d'agent, offerte

Normalement, avec un LLM, tu dois construire toi-même une boucle : envoyer une requête, vérifier si le modèle veut utiliser un outil, exécuter l'outil, renvoyer le résultat, recommencer. Avec le SDK, Claude s'en charge : tu appelles query() avec un prompt, et la réponse arrive sous forme de flux de messages – raisonnement, appels d'outils, résultats d'outils – jusqu'à ce que la tâche soit terminée.

Définir des outils

Les outils intégrés comme Read, Write, Edit, Bash, Glob, Grep et WebSearch fonctionnent immédiatement, sans que tu aies à les implémenter toi-même. allowed_tools détermine ce que l'agent a le droit d'utiliser ; permission_mode contrôle le niveau d'autorisation nécessaire. Tu peux aussi connecter tes propres serveurs MCP quand l'agent a besoin d'accéder à des systèmes externes.

SDK ou CLI toute faite ?

Pour le développement interactif et les tâches ponctuelles, la CLI Claude Code suffit. Le SDK est pensé pour les pipelines CI/CD, tes propres applications et l'automatisation en production – les mêmes capacités, mais intégrées dans ton propre programme plutôt que dans le terminal.

EXEMPLE

Prompt dans ton propre code : `query(prompt="Lis README.md et résume les trois points les plus importants", options=ClaudeAgentOptions(allowed_tools=["Read"]))` – l'agent lit lui-même le fichier et répond sous forme de flux de messages.

🛠️ EXERCICE — À TOI DE JOUER

Construis avec le Claude Agent SDK (Python ou TypeScript) un petit agent qui lit un fichier contenant des bugs volontaires et le répare.

Installe le SDK (pip install claude-agent-sdk ou npm install @anthropic-ai/claude-agent-sdk) et configure ta variable ANTHROPIC_API_KEY.
Écris un petit fichier contenant un bug évident (par exemple une division par zéro) et appelle query() avec allowed_tools=["Read","Edit"].
Suis le flux de messages et observe comment l'agent lit, réfléchit et modifie le fichier – sans que tu aies programmé toi-même la boucle d'outils.

✅ AUTO-VÉRIFICATION

☐ As-tu écrit quelque part toi-même une boucle pour les appels d'outils – ou est-ce le SDK qui s'en est chargé ?
☐ Que se passe-t-il si tu mets permission_mode sur "plan" au lieu de "acceptEdits" ?
☐ Dans quel cas utiliserais-tu la CLI Claude Code plutôt que le SDK pour la même tâche ?

QUIZ RAPIDE

Qu'est-ce que le Claude Agent SDK prend en charge automatiquement, que tu devrais sinon programmer toi-même avec une solution maison basée sur l'API brute ?