Skip to main content

概要

Claude Code SDK は Claude Agent SDK に名前が変更され、ドキュメントが再編成されました。この変更は、コーディングタスクだけでなく、AI エージェント構築のための SDK のより広い機能を反映しています。 OpenAI Agents SDK から移行していますか?OpenAI Agents SDK 移行レシピでは、単一の実装例を通じて各プリミティブを Claude Agent SDK にマッピングしています。

変更内容

マイグレーションステップ

TypeScript または JavaScript プロジェクトを移行する

1. 古いパッケージをアンインストールします:
2. 新しいパッケージをインストールします:
3. インポートを更新します: @anthropic-ai/claude-code からのすべてのインポートを @anthropic-ai/claude-agent-sdk に変更します:
4. package.json を更新します: @anthropic-ai/claude-code が package.json にまだ記載されている場合は、@anthropic-ai/claude-agent-sdk に置き換え、バージョン範囲も更新します。例えば、"^0.0.42" から "^0.3.0" に更新します。 5. 破壊的変更を確認します マイグレーションを完了するために必要なコード変更を行います。

Python プロジェクトを移行する

1. 古いパッケージをアンインストールします:
古いパッケージがインストールされていない場合、pip は 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 に変更します:
4. 破壊的変更を確認します マイグレーションを完了するために必要なコード変更を行います。

破壊的変更

分離と明示的な設定を改善するため、Claude Agent SDK v0.1.0 では Claude Code 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 が制御しないものを参照してください。

次のステップ