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

​
概要

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 ドキュメント → SDK セクション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": "^1.0.0"
  }
}

// 変更後
{
  "dependencies": {
    "@anthropic-ai/claude-agent-sdk": "^0.1.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_agent_sdk import query, ClaudeCodeOptions

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

# 変更後
from claude_agent_sdk import query, ClaudeAgentOptions

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

​
破壊的変更

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

​
Python: ClaudeCodeOptions が ClaudeAgentOptions に名前変更

何が変わったか: Python SDK の型 ClaudeCodeOptions が ClaudeAgentOptions に名前変更されました。 移行: 
# 変更前 (v0.0.x)
from claude_agent_sdk import query, ClaudeCodeOptions

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

# 変更後 (v0.1.0)
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    model="claude-sonnet-4-5",
    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 に焦点を当てた指示を継承することなく、カスタム動作を持つエージェントを構築できるようになりました。

​
設定ソースがデフォルトで読み込まれなくなった

何が変わったか: SDK は、デフォルトではファイルシステム設定 (CLAUDE.md、settings.json、スラッシュコマンドなど) から読み込まなくなりました。 移行: 
// 変更前 (v0.0.x) - すべての設定を自動的に読み込み
const result = query({ prompt: "Hello" });
// 以下から読み込みます:
// - ~/.claude/settings.json (ユーザー)
// - .claude/settings.json (プロジェクト)
// - .claude/settings.local.json (ローカル)
// - CLAUDE.md ファイル
// - カスタムスラッシュコマンド

// 変更後 (v0.1.0) - デフォルトで設定は読み込まない
// 古い動作を取得するには:
const result = query({
  prompt: "Hello",
  options: {
    settingSources: ["user", "project", "local"]
  }
});

// または特定のソースのみを読み込みます:
const result = query({
  prompt: "Hello",
  options: {
    settingSources: ["project"]  // プロジェクト設定のみ
  }
});
なぜこれが変わったか: SDK アプリケーションがローカルファイルシステム設定に依存せず、予測可能な動作を確保します。これは特に以下の場合に重要です:
  • CI/CD 環境 - ローカルカスタマイズなしの一貫した動作
  • デプロイされたアプリケーション - ファイルシステム設定への依存なし
  • テスト - 分離されたテスト環境
  • マルチテナントシステム - ユーザー間の設定漏洩を防止
後方互換性: アプリケーションがファイルシステム設定 (カスタムスラッシュコマンド、CLAUDE.md 指示など) に依存していた場合は、settingSources: ['user', 'project', 'local'] をオプションに追加してください。

​
なぜ名前が変わったのか?

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 を実行して、パッケージがインストールされていることを確認します
一般的な問題については、トラブルシューティング ガイドを参照してください。

​
次のステップ