Aperçu
Construisez des agents IA personnalisés avec le SDK Claude Code
Options du SDK
Le SDK Claude Code est disponible sous plusieurs formes pour s’adapter à différents cas d’usage :
- Mode Headless - Pour les scripts CLI et l’automatisation
- SDK TypeScript - Pour les applications Node.js et web
- SDK Python - Pour les applications Python et la science des données
Pourquoi utiliser le SDK Claude Code ?
Construit sur le harnais d’agent qui alimente Claude Code, le SDK Claude Code fournit tous les blocs de construction dont vous avez besoin pour construire des agents prêts pour la production :
- Intégration Claude optimisée : Mise en cache automatique des prompts et optimisations de performance
- Écosystème d’outils riche : Opérations sur fichiers, exécution de code, recherche web, et extensibilité MCP
- Permissions avancées : Contrôle granulaire des capacités de l’agent
- Essentiels de production : Gestion d’erreurs intégrée, gestion de session, et surveillance
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 Anthropic depuis la Console Anthropic 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, 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 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 là que vous spécifiez quel type d’agent vous construisez.
Permissions d’Outils
Contrôlez quels outils votre agent peut utiliser avec des permissions granulaires :
allowedTools
- Autorisez explicitement des outils spécifiquesdisallowedTools
- Bloquez des outils spécifiquespermissionMode
- 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.
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