Le SDK Claude Code a été renommé SDK Agent Claude. 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 Agent Claude est disponible sous plusieurs formes pour s’adapter à différents cas d’usage :

​
Pourquoi utiliser le SDK Agent Claude ?

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

​
Que pouvez-vous construire avec le SDK ?

Voici quelques exemples de types d’agents que vous pouvez créer : Agents de codage :
  • Agents SRE qui diagnostiquent et corrigent les problèmes de production
  • Bots de révision de sécurité qui auditent le code pour les vulnérabilités
  • Assistants d’ingénierie d’astreinte qui trient les incidents
  • Agents de révision de code qui appliquent le style et les meilleures pratiques
Agents métier :
  • Assistants juridiques qui révisent les contrats et la conformité
  • Conseillers financiers qui analysent les rapports et les prévisions
  • Agents de support client 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 depuis 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.

​
Support Complet des Fonctionnalités Claude Code

Le SDK fournit l’accès à toutes les fonctionnalités par défaut disponibles dans Claude Code, 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 comme fichiers Markdown dans ./.claude/agents/
  • 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 comme fichiers Markdown dans ./.claude/commands/
  • Mémoire (CLAUDE.md) : Maintenez le contexte du projet à travers les fichiers CLAUDE.md qui fournissent des instructions et un contexte persistants
Ces fonctionnalités fonctionnent de manière identique à leurs homologues Claude Code en lisant depuis les mêmes emplacements du système de fichiers.

​
Prompts Système

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

​
Permissions d’Outils

Contrôlez quels outils votre agent peut utiliser avec des permissions fines :
  • 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 personnalisés et des intégrations à travers les serveurs MCP. Cela vous permet de vous connecter aux bases de données, APIs, et autres services externes.

​
Signalement de Bugs

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

​
Ressources Connexes