# Claude Agent SDK Bibliothèque pour développeurs. Fiche relevée le 3 octobre 2026 sur les pages officielles. Page : https://quelleia.com/outils/claude-agent-sdk/ ## En bref Le Claude Agent SDK est la bibliothèque d'Anthropic pour programmer ses propres agents en Python ou en TypeScript. Il reprend les outils, la boucle d'agent et la gestion du contexte de Claude Code : lecture et édition de fichiers, commandes, recherche web, sous-agents, serveurs MCP. Il s'adresse aux développeurs, qui l'intègrent dans leur propre application. Les appels au modèle se paient à l'usage, par une clé d'API Claude ou un fournisseur dans le nuage. - Éditeur : Anthropic - Prix : gratuit, à l'usage - Licence : code fermé - Systèmes : macOS, Linux, Windows - Formes : bibliothèque pour développeurs (SDK) - Site officiel : https://www.anthropic.com ## Installer ### TypeScript, nouveau projet (Node.js 18+) ``` npm init -y ``` ``` npm pkg set type=module ``` ``` npm install @anthropic-ai/claude-agent-sdk ``` ``` npm install --save-dev tsx ``` ### TypeScript, projet existant ``` npm install @anthropic-ai/claude-agent-sdk ``` ``` npm install --save-dev tsx ``` ### Python avec uv (Python 3.10+) ``` uv init ``` ``` uv add claude-agent-sdk ``` ### Python avec pip, macOS ou Linux ``` python3 -m venv .venv ``` ``` source .venv/bin/activate ``` ``` pip install claude-agent-sdk ``` ### Python avec pip, Windows ``` py -m venv .venv ``` ``` .venv\Scripts\Activate.ps1 ``` ``` pip install claude-agent-sdk ``` ### macOS, Linux (clé d'API) ``` export ANTHROPIC_API_KEY=your-api-key ``` ### Windows (PowerShell, clé d'API) ``` $env:ANTHROPIC_API_KEY = "your-api-key" ``` ### Démarrer Écrire un script qui appelle `query()` puis le lancer : `npx tsx agent.ts` en TypeScript, `uv run agent.py` en Python. Les deux versions du SDK embarquent le programme Claude Code ; sur Windows ARM64, il faut l'installer à part. ``` npx tsx agent.ts ``` ``` uv run agent.py ``` ### Choisir le modèle L'option `model` accepte un alias Claude ou un nom de modèle complet, et `fallback_model` désigne un modèle de repli. Chaque sous-agent peut avoir son propre modèle (opus, sonnet, haiku, fable ou inherit). Source : https://code.claude.com/docs/en/agent-sdk/quickstart (lue le 3 octobre 2026). ## Ce qu'il sait faire - **Outils intégrés** : L'agent lit, écrit et modifie des fichiers, lance des commandes et cherche sur le web. (https://code.claude.com/docs/en/tools-reference) - **Sous-agents** : L'agent lance des agents spécialisés pour des sous-tâches ciblées. (https://code.claude.com/docs/en/agent-sdk/subagents) - **Hooks** : Son propre code s'exécute à des moments clés du travail de l'agent, par exemple avant ou après une action. (https://code.claude.com/docs/en/agent-sdk/hooks) - **MCP** : On branche des outils et des sources de données externes par le Model Context Protocol (MCP), le protocole standard prévu pour cela. (https://code.claude.com/docs/en/agent-sdk/mcp) - **Permissions** : On décide quels outils tournent seuls et lesquels demandent une validation. (https://code.claude.com/docs/en/agent-sdk/permissions) - **Sessions** : Le contexte se garde d'un échange à l'autre. Une session peut être reprise ou dupliquée plus tard. (https://code.claude.com/docs/en/agent-sdk/sessions) - **Skills, commandes et mémoire** : Comme Claude Code, le SDK charge les skills (procédures réutilisables), les commandes et la mémoire depuis le dossier .claude/ du projet et depuis ~/.claude/. (https://code.claude.com/docs/en/agent-sdk/skills) Les façons de l'utiliser : - Bibliothèque pour développeurs (SDK) : bibliothèque Python (claude-agent-sdk) (https://code.claude.com/docs/en/agent-sdk/python) - Bibliothèque pour développeurs (SDK) : bibliothèque TypeScript (@anthropic-ai/claude-agent-sdk) (https://code.claude.com/docs/en/agent-sdk/typescript) Systèmes : - macOS - Linux - Windows : en natif (PowerShell) ; sur Windows ARM64, le paquet Python n'embarque pas Claude Code, qu'il faut installer à part ## Sur téléphone Au 3 octobre 2026, l'éditeur ne documente ni application mobile ni pilotage depuis un téléphone. ## Prix et licence Bibliothèque gratuite. Les appels au modèle sont facturés à l'usage par la clé d'API Claude ou par Amazon Bedrock, Google Cloud ou Microsoft Foundry. Sauf accord préalable, Anthropic interdit aux développeurs tiers de proposer la connexion par compte claude.ai (abonnements Pro ou Max) dans leurs produits. (relevé le 3 octobre 2026, https://code.claude.com/docs/en/agent-sdk/quickstart) Licence : Code fermé. L'usage est régi par les conditions commerciales d'Anthropic, y compris pour un produit proposé à ses propres clients. Le dépôt Python porte un fichier de licence MIT. Le paquet npm TypeScript renvoie à son README (« SEE LICENSE IN README.md »), et GitHub ne détecte aucun fichier de licence dans son dépôt. Les deux versions pilotent le programme Claude Code, en code fermé. (https://code.claude.com/docs/en/agent-sdk/overview) ## Modèles Modèles Claude seulement, par l'API Anthropic (clé ANTHROPIC_API_KEY), Amazon Bedrock, Claude Platform on AWS, Google Cloud (Agent Platform) ou Microsoft Foundry. - Clé d'API personnelle : oui - Modèles locaux : non ## Sources - https://code.claude.com/docs/en/agent-sdk/overview - https://code.claude.com/docs/en/agent-sdk/quickstart - https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk - https://pypi.org/project/claude-agent-sdk/ - https://code.claude.com/docs/en/agent-sdk/python - https://code.claude.com/docs/en/tools-reference - https://code.claude.com/docs/en/agent-sdk/subagents - https://code.claude.com/docs/en/agent-sdk/hooks - https://code.claude.com/docs/en/agent-sdk/mcp - https://code.claude.com/docs/en/agent-sdk/permissions - https://code.claude.com/docs/en/agent-sdk/sessions - https://code.claude.com/docs/en/agent-sdk/skills - https://code.claude.com/docs/en/agent-sdk/typescript Non vérifié : - Le pays d'Anthropic n'apparaît sur aucune des pages consultées pour cette fiche. - La licence exacte du SDK TypeScript n'est pas établie : GitHub ne détecte aucun fichier de licence, et le paquet npm renvoie au README. - Le SDK n'a ni application mobile ni pilotage à distance qui lui soient propres, puisque c'est une bibliothèque.