Aperçu
Le Claude Code SDK a été renommé en Claude Agent SDK et sa documentation a été réorganisée. Ce changement reflète les capacités plus larges du SDK pour construire des agents IA au-delà des simples tâches de codage. Vous migrez depuis le SDK OpenAI Agents ? La recette de migration du SDK OpenAI Agents mappe chaque primitive sur le Claude Agent SDK à travers un seul exemple travaillé.Ce qui a changé
Étapes de migration
Migrer un projet TypeScript ou JavaScript
1. Désinstallez l’ancien package :@anthropic-ai/claude-code vers @anthropic-ai/claude-agent-sdk :
@anthropic-ai/claude-code est toujours listé dans votre package.json, remplacez-le par @anthropic-ai/claude-agent-sdk et mettez à jour la plage de version également, par exemple de "^0.0.42" à "^0.3.0".
5. Consultez les modifications incompatibles
Effectuez les modifications de code nécessaires pour terminer la migration.
Migrer un projet Python
1. Désinstallez l’ancien package :WARNING: Skipping claude-code-sdk as it is not installed. C’est normal et vous pouvez passer à l’étape suivante.
2. Installez le nouveau package :
claude-code-sdk est listé dans votre requirements.txt ou pyproject.toml, remplacez-le par claude-agent-sdk.
3. Mettez à jour vos imports :
Modifiez tous les imports de claude_code_sdk vers claude_agent_sdk :
Changements majeurs
Python : ClaudeCodeOptions renommé en ClaudeAgentOptions
Ce qui a changé : Le type Python SDKClaudeCodeOptions a été renommé en ClaudeAgentOptions.
Migration :
Le système de prompt n’est plus défini par défaut
Ce qui a changé : Le SDK n’utilise plus le système de prompt de Claude Code par défaut. Migration :Défaut des sources de paramètres
Ce défaut a été brièvement modifié dans v0.1.0 pour ne charger aucun paramètre du système de fichiers, puis a été rétabli, donc aucune action de migration n’est nécessaire. Comportement actuel : OmettresettingSources sur query() charge les paramètres utilisateur, projet et système de fichiers local, correspondant à la CLI. Cela inclut ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json, les fichiers CLAUDE.md et les commandes personnalisées.
Pour fonctionner isolé des paramètres du système de fichiers, passez settingSources: [], ou setting_sources=[] en Python. Consultez Contrôler les paramètres du système de fichiers avec settingSources pour savoir ce que charge chaque source.
L’isolation est particulièrement importante pour les pipelines CI/CD, les applications déployées, les environnements de test et les systèmes multi-locataires où les personnalisations locales ne doivent pas s’échapper.
Python SDK 0.1.59 et antérieures traitaient une liste vide de la même manière que l’omission de l’option, donc mettez à jour avant de vous fier à
setting_sources=[]. Consultez Ce que settingSources ne contrôle pas pour les entrées qui sont lues même lorsque settingSources est [].Prochaines étapes
- Explorez l’Aperçu d’Agent SDK pour en savoir plus sur les fonctionnalités disponibles
- Consultez la Référence SDK TypeScript pour la documentation API détaillée
- Consultez la Référence SDK Python pour la documentation spécifique à Python
- En savoir plus sur les Outils personnalisés et l’Intégration MCP