概要
Claude Code SDK は Claude Agent SDK に名前が変更され、ドキュメントが再編成されました。この変更は、コーディングタスクだけでなく、AI エージェント構築のための SDK のより広い機能を反映しています。 OpenAI Agents SDK から移行していますか?OpenAI Agents SDK 移行レシピでは、単一の実装例を通じて各プリミティブを Claude Agent SDK にマッピングしています。変更内容
マイグレーションステップ
TypeScript または JavaScript プロジェクトを移行する
1. 古いパッケージをアンインストールします:@anthropic-ai/claude-code からのすべてのインポートを @anthropic-ai/claude-agent-sdk に変更します:
@anthropic-ai/claude-code が package.json にまだ記載されている場合は、@anthropic-ai/claude-agent-sdk に置き換え、バージョン範囲も更新します。例えば、"^0.0.42" から "^0.3.0" に更新します。
5. 破壊的変更を確認します
マイグレーションを完了するために必要なコード変更を行います。
Python プロジェクトを移行する
1. 古いパッケージをアンインストールします:WARNING: Skipping claude-code-sdk as it is not installed. と出力します。これは予期された動作であり、次のステップに進むことができます。
2. 新しいパッケージをインストールします:
claude-code-sdk が requirements.txt または pyproject.toml に記載されている場合は、claude-agent-sdk に置き換えます。
3. インポートを更新します:
claude_code_sdk からのすべてのインポートを claude_agent_sdk に変更します:
破壊的変更
Python: ClaudeCodeOptions が ClaudeAgentOptions に名前変更
変更内容: Python SDK の型ClaudeCodeOptions が ClaudeAgentOptions に名前変更されました。
移行方法:
システムプロンプトがデフォルトではなくなった
変更内容: SDK は Claude Code のシステムプロンプトをデフォルトで使用しなくなりました。 移行方法:設定ソースのデフォルト
このデフォルトは v0.1.0 で一時的にファイルシステム設定を読み込まないように変更され、その後元に戻されたため、移行アクションは必要ありません。 現在の動作:query() で settingSources を省略すると、ユーザー、プロジェクト、ローカルファイルシステムの設定が読み込まれ、CLI と一致します。これには ~/.claude/settings.json、.claude/settings.json、.claude/settings.local.json、CLAUDE.md ファイル、およびカスタムコマンドが含まれます。
ファイルシステム設定から分離して実行するには、settingSources: [] を渡すか、Python では setting_sources=[] を渡してください。各ソースが読み込む内容については、settingSources でファイルシステム設定を制御するを参照してください。
分離は、ローカルカスタマイズが漏洩してはいけない CI/CD パイプライン、デプロイされたアプリケーション、テスト環境、マルチテナントシステムで特に重要です。
Python SDK 0.1.59 以前は、空のリストを省略した場合と同じように扱っていたため、
setting_sources=[] に依存する前にアップグレードしてください。settingSources が [] の場合でも読み込まれる入力については、settingSources が制御しないものを参照してください。次のステップ
- Agent SDK Overview を探索して、利用可能な機能について学びます
- TypeScript SDK Reference をチェックして、詳細な API ドキュメントを確認します
- Python SDK Reference を確認して、Python 固有のドキュメントを確認します
- Custom Tools と MCP Integration について学びます