Aperçu du SDK Agent

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 :

• SDK TypeScript - Pour les applications Node.js et web
• SDK Python - Pour les applications Python et la science des données
• Mode Streaming vs Mode Unique - Comprendre les modes d'entrée et les meilleures pratiques

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.

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 ou dans votre répertoire de projet, ou pour les instructions au niveau de l'utilisateur. Pour charger ces fichiers, vous devez définir explicitement (TypeScript) ou (Python) dans vos options. Consultez 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 :

• SDK TypeScript : Signaler les problèmes sur GitHub
• SDK Python : Signaler les problèmes sur GitHub

Journal des modifications

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

• SDK TypeScript : Voir CHANGELOG.md
• SDK Python : Voir CHANGELOG.md

Ressources connexes

• Référence CLI - Documentation CLI complète
• Intégration GitHub Actions - Automatisez votre flux de travail GitHub
• Documentation MCP - Étendez Claude avec des outils personnalisés
• Flux de travail courants - Guides étape par étape
• Dépannage - Problèmes courants et solutions