Passer au contenu principal

​
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.

​
Ce qui a changé

AspectAncienNouveau
Nom du package (TS/JS)@anthropic-ai/claude-code@anthropic-ai/claude-agent-sdk
Package Pythonclaude-code-sdkclaude-agent-sdk
Emplacement de la documentationDocs Claude Code → Section SDKGuide API → Section Agent SDK
Modifications de la documentation : La documentation Agent SDK a été déplacée des docs Claude Code vers le Guide API dans une section dédiée Agent SDK. Les docs Claude Code se concentrent maintenant sur l’outil CLI et les fonctionnalités d’automatisation.

​
Étapes de migration

​
Pour les projets TypeScript/JavaScript

1. Désinstallez l’ancien package : 
npm uninstall @anthropic-ai/claude-code
2. Installez le nouveau package : 
npm install @anthropic-ai/claude-agent-sdk
3. Mettez à jour vos imports : Changez tous les imports de @anthropic-ai/claude-code à @anthropic-ai/claude-agent-sdk : 
// Avant
import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-code";

// Après
import {
  query,
  tool,
  createSdkMcpServer,
} from "@anthropic-ai/claude-agent-sdk";
4. Mettez à jour les dépendances package.json : Si vous avez le package listé dans votre package.json, mettez-le à jour : 
// Avant
{
  "dependencies": {
    "@anthropic-ai/claude-code": "^1.0.0"
  }
}

// Après
{
  "dependencies": {
    "@anthropic-ai/claude-agent-sdk": "^0.1.0"
  }
}
C’est tout ! Aucune autre modification de code n’est requise.

​
Pour les projets Python

1. Désinstallez l’ancien package : 
pip uninstall claude-code-sdk
2. Installez le nouveau package : 
pip install claude-agent-sdk
3. Mettez à jour vos imports : Changez tous les imports de claude_code_sdk à claude_agent_sdk : 
# Avant
from claude_code_sdk import query, ClaudeCodeOptions

# Après
from claude_agent_sdk import query, ClaudeAgentOptions
4. Mettez à jour les noms de types : Changez ClaudeCodeOptions en ClaudeAgentOptions : 
# Avant
from claude_agent_sdk import query, ClaudeCodeOptions

options = ClaudeCodeOptions(
    model="claude-sonnet-4-5"
)

# Après
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    model="claude-sonnet-4-5"
)
5. Consultez les modifications incompatibles Effectuez les modifications de code nécessaires pour terminer la migration.

​
Modifications incompatibles

Pour améliorer l’isolation et la configuration explicite, Claude Agent SDK v0.1.0 introduit des modifications incompatibles pour les utilisateurs migrant depuis Claude Code SDK. Consultez attentivement cette section avant de migrer.

​
Python : ClaudeCodeOptions renommé en ClaudeAgentOptions

Ce qui a changé : Le type Python SDK ClaudeCodeOptions a été renommé en ClaudeAgentOptions. Migration : 
# AVANT (v0.0.x)
from claude_agent_sdk import query, ClaudeCodeOptions

options = ClaudeCodeOptions(
    model="claude-sonnet-4-5",
    permission_mode="acceptEdits"
)

# APRÈS (v0.1.0)
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    model="claude-sonnet-4-5",
    permission_mode="acceptEdits"
)
Pourquoi ce changement : Le nom du type correspond maintenant à la marque “Claude Agent SDK” et fournit une cohérence dans les conventions de nommage du SDK.

​
L’invite système n’est plus définie par défaut

Ce qui a changé : Le SDK n’utilise plus l’invite système de Claude Code par défaut. Migration : 
// AVANT (v0.0.x) - Utilisait l'invite système de Claude Code par défaut
const result = query({ prompt: "Hello" });

// APRÈS (v0.1.0) - Utilise une invite système vide par défaut
// Pour obtenir l'ancien comportement, demandez explicitement le préréglage de Claude Code :
const result = query({
  prompt: "Hello",
  options: {
    systemPrompt: { type: "preset", preset: "claude_code" }
  }
});

// Ou utilisez une invite système personnalisée :
const result = query({
  prompt: "Hello",
  options: {
    systemPrompt: "You are a helpful coding assistant"
  }
});
Pourquoi ce changement : Fournit un meilleur contrôle et une meilleure isolation pour les applications SDK. Vous pouvez maintenant construire des agents avec un comportement personnalisé sans hériter des instructions orientées CLI de Claude Code.

​
Les sources de paramètres ne sont plus chargées par défaut

Ce qui a changé : Le SDK ne lit plus les paramètres du système de fichiers (CLAUDE.md, settings.json, commandes slash, etc.) par défaut. Migration : 
// AVANT (v0.0.x) - Chargeait tous les paramètres automatiquement
const result = query({ prompt: "Hello" });
// Lirait depuis :
// - ~/.claude/settings.json (utilisateur)
// - .claude/settings.json (projet)
// - .claude/settings.local.json (local)
// - Fichiers CLAUDE.md
// - Commandes slash personnalisées

// APRÈS (v0.1.0) - Aucun paramètre chargé par défaut
// Pour obtenir l'ancien comportement :
const result = query({
  prompt: "Hello",
  options: {
    settingSources: ["user", "project", "local"]
  }
});

// Ou charger uniquement des sources spécifiques :
const result = query({
  prompt: "Hello",
  options: {
    settingSources: ["project"]  // Uniquement les paramètres du projet
  }
});
Pourquoi ce changement : Garantit que les applications SDK ont un comportement prévisible indépendant des configurations du système de fichiers local. C’est particulièrement important pour :
  • Environnements CI/CD - Comportement cohérent sans personnalisations locales
  • Applications déployées - Aucune dépendance aux paramètres du système de fichiers
  • Tests - Environnements de test isolés
  • Systèmes multi-locataires - Empêcher la fuite de paramètres entre utilisateurs
Compatibilité rétroactive : Si votre application s’appuyait sur les paramètres du système de fichiers (commandes slash personnalisées, instructions CLAUDE.md, etc.), ajoutez settingSources: ['user', 'project', 'local'] à vos options.

​
Pourquoi le changement de nom ?

Le Claude Code SDK a été conçu à l’origine pour les tâches de codage, mais il a évolué en un cadre puissant pour construire tous les types d’agents IA. Le nouveau nom “Claude Agent SDK” reflète mieux ses capacités :
  • Construire des agents métier (assistants juridiques, conseillers financiers, support client)
  • Créer des agents de codage spécialisés (bots SRE, examinateurs de sécurité, agents d’examen de code)
  • Développer des agents personnalisés pour n’importe quel domaine avec utilisation d’outils, intégration MCP, et plus

​
Obtenir de l’aide

Si vous rencontrez des problèmes lors de la migration : Pour TypeScript/JavaScript :
  1. Vérifiez que tous les imports sont mis à jour pour utiliser @anthropic-ai/claude-agent-sdk
  2. Vérifiez que votre package.json a le nouveau nom de package
  3. Exécutez npm install pour vous assurer que les dépendances sont mises à jour
Pour Python :
  1. Vérifiez que tous les imports sont mis à jour pour utiliser claude_agent_sdk
  2. Vérifiez que votre requirements.txt ou pyproject.toml a le nouveau nom de package
  3. Exécutez pip install claude-agent-sdk pour vous assurer que le package est installé
Consultez le guide Dépannage pour les problèmes courants.

​
Prochaines étapes