Le SDK Claude Code a été renommé en SDK Claude Agent. Si vous migrez depuis l’ancien SDK, consultez le Guide de migration.

​
Installation

npm install @anthropic-ai/claude-agent-sdk

​
Options du SDK

Le SDK Claude Agent est disponible sous plusieurs formes pour s’adapter à différents cas d’usage :

​
Pourquoi utiliser le SDK Claude Agent ?

Construit sur le harnais d’agent qui alimente Claude Code, le SDK Claude Agent fournit tous les éléments constitutifs dont vous avez besoin pour créer des agents prêts pour la production. En tirant parti du travail que nous avons effectué sur Claude Code, notamment :
  • Gestion du contexte : Compaction automatique et gestion du contexte pour s’assurer que votre agent ne manque pas de contexte.
  • Écosystème d’outils riche : Opérations sur les fichiers, exécution de code, recherche web et extensibilité MCP
  • Permissions avancées : Contrôle granulaire des capacités de l’agent
  • Éléments essentiels de production : Gestion des erreurs intégrée, gestion des sessions et surveillance
  • Intégration Claude optimisée : Mise en cache automatique des invites et optimisations de performance

​
Que pouvez-vous créer avec le SDK ?

Voici quelques exemples de types d’agents que vous pouvez créer : Agents de codage :
  • Agents SRE qui diagnostiquent et résolvent les problèmes de production
  • Bots d’examen de sécurité qui auditent le code pour les vulnérabilités
  • Assistants d’ingénierie en service qui trient les incidents
  • Agents d’examen de code qui appliquent le style et les meilleures pratiques
Agents commerciaux :
  • Assistants juridiques qui examinent les contrats et la conformité
  • Conseillers financiers qui analysent les rapports et les prévisions
  • Agents d’assistance à la clientèle qui résolvent les problèmes techniques
  • Assistants de création de contenu pour les équipes marketing

​
Concepts fondamentaux

​
Authentification

Pour l’authentification de base, récupérez une clé API Claude à partir de la Console Claude et définissez la variable d’environnement ANTHROPIC_API_KEY. Le SDK prend également en charge l’authentification via des fournisseurs d’API tiers :
  • Amazon Bedrock : Définissez la variable d’environnement CLAUDE_CODE_USE_BEDROCK=1 et configurez les identifiants AWS
  • Google Vertex AI : Définissez la variable d’environnement CLAUDE_CODE_USE_VERTEX=1 et configurez les identifiants Google Cloud
Pour des instructions de configuration détaillées pour les fournisseurs tiers, consultez la documentation Amazon Bedrock et Google Vertex AI.
Sauf approbation préalable, nous ne permettons pas aux développeurs tiers d’appliquer les limites de débit Claude.ai pour leurs produits, y compris les agents construits sur le SDK Claude Agent. Veuillez plutôt utiliser les méthodes d’authentification par clé API décrites dans ce document.

​
Support complet des fonctionnalités Claude Code

Le SDK fournit un accès à toutes les fonctionnalités par défaut disponibles dans Claude Code, en tirant parti de la même configuration basée sur le système de fichiers :
  • Sous-agents : Lancez des agents spécialisés stockés sous forme de fichiers Markdown dans ./.claude/agents/
  • Compétences d’agent : Étendez Claude avec des capacités spécialisées stockées sous forme de fichiers SKILL.md dans ./.claude/skills/
  • Hooks : Exécutez des commandes personnalisées configurées dans ./.claude/settings.json qui répondent aux événements d’outils
  • Commandes Slash : Utilisez des commandes personnalisées définies sous forme de fichiers Markdown dans ./.claude/commands/
  • Plugins : Chargez des plugins personnalisés par programmation en utilisant l’option plugins pour étendre Claude Code avec des commandes personnalisées, des agents, des compétences, des hooks et des serveurs MCP. Consultez Plugins pour plus de détails.
  • Mémoire (CLAUDE.md) : Maintenez le contexte du projet via des fichiers CLAUDE.md ou .claude/CLAUDE.md dans votre répertoire de projet, ou ~/.claude/CLAUDE.md pour les instructions au niveau de l’utilisateur. Pour charger ces fichiers, vous devez définir explicitement settingSources: ['project'] (TypeScript) ou setting_sources=["project"] (Python) dans vos options. Consultez Modification des invites système pour plus de détails.
Ces fonctionnalités fonctionnent de manière identique à leurs homologues Claude Code en lisant à partir des mêmes emplacements du système de fichiers.

​
Invites système

Les invites système définissent le rôle, l’expertise et le comportement de votre agent. C’est ici que vous spécifiez le type d’agent que vous construisez.

​
Permissions des outils

Contrôlez les outils que votre agent peut utiliser avec des permissions granulaires :
  • allowedTools - Autorisez explicitement des outils spécifiques
  • disallowedTools - Bloquez des outils spécifiques
  • permissionMode - Définissez la stratégie de permission globale

​
Protocole de contexte de modèle (MCP)

Étendez vos agents avec des outils et des intégrations personnalisés via les serveurs MCP. Cela vous permet de vous connecter à des bases de données, des API et d’autres services externes.

​
Signaler des bogues

Si vous rencontrez des bogues ou des problèmes avec le SDK Agent :

​
Journal des modifications

Consultez le journal des modifications complet pour les mises à jour du SDK, les corrections de bogues et les nouvelles fonctionnalités :

​
Ressources connexes