​
概要

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

​
次のステップ