​
Aperçu

Le SDK Claude Code a été renommé SDK Claude Agent 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 SDK Agent
Changements de documentation : La documentation du SDK Agent a été déplacée des docs Claude Code vers le Guide API sous une section dédiée SDK Agent. 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ésinstaller l’ancien package : 
npm uninstall @anthropic-ai/claude-code
2. Installer le nouveau package : 
npm install @anthropic-ai/claude-agent-sdk
3. Mettre à jour vos imports : Changer tous les imports de @anthropic-ai/claude-code vers @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. Mettre à 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 ! Aucun autre changement de code n’est requis.

​
Pour les projets Python

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

# Après
from claude_agent_sdk import query, ClaudeAgentOptions
4. Mettre à jour les noms de types : Changer ClaudeCodeOptions vers 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. Examiner les changements cassants Effectuer tous les changements de code nécessaires pour compléter la migration.

​
Changements cassants

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

​
Python : ClaudeCodeOptions renommé en ClaudeAgentOptions

Ce qui a changé : Le type ClaudeCodeOptions du SDK Python 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 cela a changé : Le nom du type correspond maintenant à la marque “SDK Claude Agent” et fournit une cohérence à travers les conventions de nommage du SDK.

​
Prompt système plus par défaut

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

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

// Ou utiliser un prompt système personnalisé :
const result = query({
  prompt: "Bonjour",
  options: {
    systemPrompt: "Vous êtes un assistant de codage utile"
  }
});
Pourquoi cela a changé : Fournit un meilleur contrôle et isolation pour les applications SDK. Vous pouvez maintenant construire des agents avec un comportement personnalisé sans hériter des instructions axées CLI de Claude Code.

​
Sources de paramètres plus chargées par défaut

Ce qui a changé : Le SDK ne lit plus depuis 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: "Bonjour" });
// 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: "Bonjour",
  options: {
    settingSources: ["user", "project", "local"]
  }
});

// Ou charger seulement des sources spécifiques :
const result = query({
  prompt: "Bonjour",
  options: {
    settingSources: ["project"]  // Seulement les paramètres du projet
  }
});
Pourquoi cela a changé : Assure que les applications SDK ont un comportement prévisible indépendant des configurations locales du système de fichiers. Ceci 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 - Prévenir les fuites de paramètres entre utilisateurs
Compatibilité ascendante : Si votre application dépendait des paramètres du système de fichiers (commandes slash personnalisées, instructions CLAUDE.md, etc.), ajoutez settingSources: ['user', 'project', 'local'] à vos options.

​
Pourquoi le renommage ?

Le SDK Claude Code était originalement conçu pour les tâches de codage, mais il a évolué en un framework puissant pour construire tous types d’agents IA. Le nouveau nom “SDK Claude Agent” 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, réviseurs de sécurité, agents de révision de code)
  • Développer des agents personnalisés pour tout domaine avec utilisation d’outils, intégration MCP, et plus

​
Obtenir de l’aide

Si vous rencontrez des problèmes pendant 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é
Voir le guide Dépannage pour les problèmes courants.

​
Prochaines étapes