Claude Agent SDK への移行

概要

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

変更点

移行手順

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 に変更します：

// Before
import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-code";

// After
import {
  query,
  tool,
  createSdkMcpServer,
} from "@anthropic-ai/claude-agent-sdk";

4. package.json の依存関係を更新：

package.json にパッケージが記載されている場合は、更新してください：

// Before
{
  "dependencies": {
    "@anthropic-ai/claude-code": "^1.0.0"
  }
}

// After
{
  "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 に変更します：

# Before
from claude_code_sdk import query, ClaudeCodeOptions

# After
from claude_agent_sdk import query, ClaudeAgentOptions

4. 型名を更新：

ClaudeCodeOptions を ClaudeAgentOptions に変更します：

# Before
from claude_agent_sdk import query, ClaudeCodeOptions

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

# After
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    model="claude-opus-4-6"
)

5. 破壊的変更を確認

移行を完了するために必要なコード変更を行ってください。

破壊的変更

Python: ClaudeCodeOptions が ClaudeAgentOptions に名称変更

変更内容: Python SDK の型 ClaudeCodeOptions が ClaudeAgentOptions に名称変更されました。

移行方法：

# BEFORE (v0.0.x)
from claude_agent_sdk import query, ClaudeCodeOptions

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

# AFTER (v0.1.0)
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    model="claude-opus-4-6",
    permission_mode="acceptEdits"
)

変更理由: 型名が「Claude Agent SDK」のブランディングと一致するようになり、SDK の命名規則全体で一貫性が確保されます。

システムプロンプトがデフォルトではなくなった

変更内容: SDK はデフォルトで Claude Code のシステムプロンプトを使用しなくなりました。

移行方法：

// BEFORE (v0.0.x) - Used Claude Code's system prompt by default
const result = query({ prompt: "Hello" });

// AFTER (v0.1.0) - Uses minimal system prompt by default
// To get the old behavior, explicitly request Claude Code's preset:
const result = query({
  prompt: "Hello",
  options: {
    systemPrompt: { type: "preset", preset: "claude_code" }
  }
});

// Or use a custom system prompt:
const result = query({
  prompt: "Hello",
  options: {
    systemPrompt: "You are a helpful coding assistant"
  }
});

変更理由: SDK アプリケーションに対してより良い制御と分離を提供します。Claude Code の CLI 向け指示を継承することなく、カスタム動作を持つエージェントを構築できるようになりました。

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

変更内容: SDK はデフォルトでファイルシステムの設定（CLAUDE.md、settings.json、スラッシュコマンドなど）を読み込まなくなりました。

移行方法：

// BEFORE (v0.0.x) - Loaded all settings automatically
const result = query({ prompt: "Hello" });
// Would read from:
// - ~/.claude/settings.json (user)
// - .claude/settings.json (project)
// - .claude/settings.local.json (local)
// - CLAUDE.md files
// - Custom slash commands

// AFTER (v0.1.0) - No settings loaded by default
// To get the old behavior:
const result = query({
  prompt: "Hello",
  options: {
    settingSources: ["user", "project", "local"]
  }
});

// Or load only specific sources:
const result = query({
  prompt: "Hello",
  options: {
    settingSources: ["project"]  // Only project settings
  }
});

変更理由: SDK アプリケーションがローカルファイルシステムの設定に依存せず、予測可能な動作を保証します。これは特に以下の場合に重要です：

• CI/CD 環境 - ローカルカスタマイズなしで一貫した動作
• デプロイされたアプリケーション - ファイルシステム設定への依存なし
• テスト - 分離されたテスト環境
• マルチテナントシステム - ユーザー間の設定漏洩を防止

名称変更の理由

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 を実行してパッケージがインストールされていることを確認

次のステップ

• Agent SDK 概要を確認して、利用可能な機能について学ぶ
• TypeScript SDK リファレンスで詳細な API ドキュメントを確認
• Python SDK リファレンスで Python 固有のドキュメントを確認
• カスタムツールと MCP 統合について学ぶ