メインコンテンツへスキップ

​
概要

Claude Code SDK は Claude Agent SDK に名前が変更され、ドキュメントが再編成されました。この変更は、コーディングタスクだけでなく、AI エージェント構築のための SDK のより広い機能を反映しています。

​
変更内容

項目旧版新版
パッケージ名（TS/JS）@anthropic-ai/claude-code@anthropic-ai/claude-agent-sdk
Python パッケージclaude-code-sdkclaude-agent-sdk
ドキュメント場所Claude Code ドキュメントAPI ガイド → Agent SDK セクション
ドキュメント変更： Agent SDK ドキュメントは Claude Code ドキュメントから API ガイドの専用 Agent SDK セクションに移動しました。Claude Code ドキュメントは現在、CLI ツールと自動化機能に焦点を当てています。

​
移行手順

​
TypeScript/JavaScript プロジェクト向け

1. 古いパッケージをアンインストールします： 
npm uninstall @anthropic-ai/claude-code
2. 新しいパッケージをインストールします： 
npm install @anthropic-ai/claude-agent-sdk
3. インポートを更新します： @anthropic-ai/claude-code からのすべてのインポートを @anthropic-ai/claude-agent-sdk に変更します： 
// 変更前
import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-code";

// 変更後
import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-agent-sdk";
4. package.json の依存関係を更新します： package.json にパッケージがリストされている場合は、更新します： 変更前： 
{
  "dependencies": {
    "@anthropic-ai/claude-code": "^0.0.42"
  }
}
変更後： 
{
  "dependencies": {
    "@anthropic-ai/claude-agent-sdk": "^0.2.0"
  }
}
以上です。他のコード変更は必要ありません。

​
Python プロジェクト向け

1. 古いパッケージをアンインストールします： 
pip uninstall claude-code-sdk
2. 新しいパッケージをインストールします： 
pip install claude-agent-sdk
3. インポートを更新します： claude_code_sdk からのすべてのインポートを claude_agent_sdk に変更します： 
# 変更前
from claude_code_sdk import query, ClaudeCodeOptions

# 変更後
from claude_agent_sdk import query, ClaudeAgentOptions
4. 型名を更新します： ClaudeCodeOptions を ClaudeAgentOptions に変更します： 
# 変更前
from claude_code_sdk import query, ClaudeCodeOptions

options = ClaudeCodeOptions(model="claude-opus-4-7")

# 変更後
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(model="claude-opus-4-7")
5. 破壊的変更 を確認します 移行を完了するために必要なコード変更を行います。

​
破壊的変更

分離と明示的な設定を改善するため、Claude Agent SDK v0.1.0 は Claude Code SDK から移行するユーザーに対して破壊的変更を導入しています。移行前にこのセクションを注意深く確認してください。

​
Python：ClaudeCodeOptions が ClaudeAgentOptions に名前変更

変更内容： Python SDK の型 ClaudeCodeOptions が ClaudeAgentOptions に名前変更されました。 移行： 
# 変更前（claude-code-sdk）
from claude_code_sdk import query, ClaudeCodeOptions

options = ClaudeCodeOptions(model="claude-opus-4-7", permission_mode="acceptEdits")

# 変更後（claude-agent-sdk）
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(model="claude-opus-4-7", permission_mode="acceptEdits")
変更理由： 型名は「Claude Agent SDK」ブランディングと一致し、SDK の命名規則全体で一貫性を提供します。

​
システムプロンプトがデフォルトではなくなりました

変更内容： SDK はデフォルトで Claude Code のシステムプロンプトを使用しなくなりました。 移行： 
// 変更前（v0.0.x）- デフォルトで Claude Code のシステムプロンプトを使用
const result = query({ prompt: "Hello" });

// 変更後（v0.1.0）- デフォルトで最小限のシステムプロンプトを使用
// 古い動作を取得するには、Claude Code のプリセットを明示的にリクエストします：
const result = query({
  prompt: "Hello",
  options: {
    systemPrompt: { type: "preset", preset: "claude_code" }
  }
});

// またはカスタムシステムプロンプトを使用します：
const result = query({
  prompt: "Hello",
  options: {
    systemPrompt: "You are a helpful coding assistant"
  }
});
変更理由： SDK アプリケーションのより良い制御と分離を提供します。Claude Code の CLI 中心の指示を継承することなく、カスタム動作を持つエージェントを構築できるようになりました。

​
設定ソースのデフォルト

このデフォルトは v0.1.0 で一度変更されてから元に戻されたため、移行アクションは必要ありません。 現在の動作： query() で settingSources を省略すると、ユーザー、プロジェクト、ローカルファイルシステムの設定が読み込まれ、CLI と一致します。これには ~/.claude/settings.json、.claude/settings.json、.claude/settings.local.json、CLAUDE.md ファイル、およびカスタムコマンドが含まれます。 ファイルシステム設定から分離して実行するには、空の配列を渡します： 
const result = query({
  prompt: "Hello",
  options: {
    settingSources: [] // ファイルシステム設定は読み込まれません
  }
});

// または特定のソースのみを読み込みます：
const result = query({
  prompt: "Hello",
  options: {
    settingSources: ["project"] // プロジェクト設定のみ
  }
});
分離は、ローカルのカスタマイズがリークしてはいけない CI/CD パイプライン、デプロイされたアプリケーション、テスト環境、マルチテナントシステムで特に重要です。
SDK v0.1.0 は一度設定が読み込まれないようにデフォルト設定されましたが、その後のリリースで元に戻されました。Python SDK 0.1.59 以前は空のリストをオプションを省略するのと同じように扱ったため、setting_sources=[] に依存する前にアップグレードしてください。settingSources が [] の場合でも読み込まれる入力については、What settingSources does not control を参照してください。

​
名前変更の理由

Claude Code SDK はもともとコーディングタスク用に設計されていましたが、あらゆるタイプの AI エージェント構築のための強力なフレームワークに進化しました。新しい名前「Claude Agent SDK」はその機能をより良く反映しています：
  • ビジネスエージェントの構築（法務アシスタント、ファイナンスアドバイザー、カスタマーサポート）
  • 特化したコーディングエージェントの作成（SRE ボット、セキュリティレビュアー、コードレビューエージェント）
  • ツール使用、MCP 統合など、あらゆるドメイン向けのカスタムエージェント開発

​
ヘルプを得る

移行中に問題が発生した場合： TypeScript/JavaScript の場合：
  1. すべてのインポートが @anthropic-ai/claude-agent-sdk を使用するように更新されていることを確認します
  2. package.json に新しいパッケージ名があることを確認します
  3. npm install を実行して、依存関係が更新されていることを確認します
Python の場合：
  1. すべてのインポートが claude_agent_sdk を使用するように更新されていることを確認します
  2. requirements.txt または pyproject.toml に新しいパッケージ名があることを確認します
  3. pip install claude-agent-sdk を実行して、パッケージがインストールされていることを確認します

​
次のステップ