Outils · bibliothèque pour développeurs

Claude Agent SDK

Le Claude Agent SDK est la bibliothèque d'Anthropic pour programmer ses propres agents en Python ou en TypeScript.

En bref

Ce que c'est: 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 de Claude Agent SDKFiche relevée le 3 octobre 2026 sur les pages officielles.

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"

Paquets vérifiés sur leur registre : @anthropic-ai/claude-agent-sdk (npm), claude-agent-sdk (pip).

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).

D'après la documentation officielle (code.claude.com), lue le 3 octobre 2026. Les commandes sont recopiées telles quelles.

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. code.claude.com
Sous-agents: L'agent lance des agents spécialisés pour des sous-tâches ciblées. code.claude.com
Hooks: Son propre code s'exécute à des moments clés du travail de l'agent, par exemple avant ou après une action. code.claude.com
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. code.claude.com
Permissions: On décide quels outils tournent seuls et lesquels demandent une validation. code.claude.com
Sessions: Le contexte se garde d'un échange à l'autre. Une session peut être reprise ou dupliquée plus tard. code.claude.com
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/. code.claude.com

Les façons de l'utiliser

Systèmes

macOS
Linux
Windowsen natif (PowerShell) ; sur Windows ARM64, le paquet Python n'embarque pas Claude Code, qu'il faut installer à part

D'après code.claude.com. Un système absent de la liste n'est pas cité par l'éditeur.

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.

Prix relevés le 3 octobre 2026 sur code.claude.com, dans la devise de la page.

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é. code.claude.com

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. code.claude.com

Clé d'API personnelle: oui
Modèles locaux: non

Sources

Fiche relevée le 3 octobre 2026 sur 13 pages officielles. Une information que nous n'avons pas pu vérifier n'est jamais présentée comme un fait.

Ce que nous n'avons pas pu vérifier (3)

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.

Tous les outils →Le même modèle, des outils différents →Les abonnements d'IA →Signaler une erreur →

Cette fiche existe aussi en texte et en JSON.