Claude 4への移行
このページでは、Claude 3.7モデルからClaude 4モデル(Opus 4およびSonnet 4)への移行に関するガイダンスを提供します。
ほとんどの場合、最小限の変更でClaude 4モデルに切り替えることができます:
-
モデル名を更新する:
- 変更前:
claude-3-7-sonnet-20250219
- 変更後:
claude-sonnet-4-20250514
またはclaude-opus-4-20250514
- 変更前:
-
既存のAPIコールは修正なしで引き続き機能しますが、Claude 4モデルではAPIの動作が若干変更されています(詳細はAPIリリースノートを参照してください)。
Claude 4の新機能
新しい拒否停止理由
Claude 4モデルでは、Claude 4モデルの知性向上により、安全上の理由でモデルが生成を拒否するコンテンツに対して、新しいrefusal
停止理由が導入されています:
Claude 4に移行する際は、アプリケーションを更新してrefusal
停止理由を処理するようにしてください。
要約された思考
拡張思考が有効になっている場合、Claude 4モデル用のMessages APIはClaudeの完全な思考プロセスの要約を返します。要約された思考は、拡張思考の完全な知性上の利点を提供しながら、誤用を防止します。
APIはClaude 3.7と4モデル間で一貫していますが、拡張思考のストリーミングレスポンスは「塊状の」配信パターンで返される可能性があり、ストリーミングイベント間に遅延が発生する可能性があります。
要約はリクエストでターゲットとするモデルとは異なるモデルによって処理されます。思考モデルは要約された出力を見ることはありません。
詳細については、拡張思考のドキュメントを参照してください。
インターリーブされた思考
Claude 4モデルは、拡張思考とツール使用のインターリーブをサポートしており、ツールの使用とレスポンスが通常のメッセージと混在できるより自然な会話が可能になります。
インターリーブされた思考はベータ版です。インターリーブされた思考を有効にするには、APIリクエストにベータヘッダー interleaved-thinking-2025-05-14
を追加してください。
詳細については、拡張思考のドキュメントを参照してください。
更新されたテキストエディタツール
テキストエディタツールはClaude 4モデル向けに以下の変更で更新されました:
- ツールタイプ:
text_editor_20250429
- ツール名:
str_replace_based_edit_tool
undo_edit
コマンドはClaude 4モデルではサポートされなくなりました。
str_replace_editor
テキストエディタツールはClaude Sonnet 3.7では同じままです。
Claude Sonnet 3.7から移行し、テキストエディタツールを使用している場合:
詳細については、テキストエディタツールのドキュメントを参照してください。
トークン効率の良いツール使用はサポートされなくなりました
トークン効率の良いツール使用はClaude Sonnet 3.7でのみ利用可能です。
Claude Sonnet 3.7から移行し、トークン効率の良いツール使用を使用している場合は、リクエストからtoken-efficient-tools-2025-02-19
ベータヘッダーを削除することをお勧めします。
token-efficient-tools-2025-02-19
ベータヘッダーはClaude 4リクエストに含めることもできますが、効果はありません。
拡張出力はサポートされなくなりました
拡張出力用のoutput-128k-2025-02-19
ベータヘッダーはClaude Sonnet 3.7でのみ利用可能です。
Claude Sonnet 3.7から移行する場合は、リクエストからoutput-128k-2025-02-19
を削除することをお勧めします。
output-128k-2025-02-19
ベータヘッダーはClaude 4リクエストに含めることもできますが、効果はありません。
パフォーマンスに関する考慮事項
Claude Sonnet 4
- Claude Sonnet 3.7と比較して改善された推論と知性能力
- 強化されたツール使用の精度
Claude Opus 4
- 優れた推論と知性を持つ最も高性能なモデル
- Sonnetモデルより処理速度が遅い
- 深い分析を必要とする複雑なタスクに最適
移行チェックリスト
- APIコールのモデルIDを更新する
- 既存のリクエストをテストする(変更なしで動作するはず)
- 該当する場合は
token-efficient-tools-2025-02-19
ベータヘッダーを削除する - 該当する場合は
output-128k-2025-02-19
ベータヘッダーを削除する - 新しい
refusal
停止理由を処理する - テキストエディタツールを使用している場合は、ツールタイプと名前を更新する
-
undo_edit
コマンドを使用するコードを削除する - 拡張思考による新しいツールインターリーブ機能を探索する
- 最適な結果を得るためにClaude 4プロンプトエンジニアリングのベストプラクティスを確認する
- 本番環境にデプロイする前に開発環境でテストする
サポートが必要ですか?
- 詳細な仕様についてはAPIドキュメントをご確認ください。
- パフォーマンス比較についてはモデル機能をご確認ください。
- APIの更新についてはAPIリリースノートをご確認ください。
- 移行中に問題が発生した場合は、サポートにお問い合わせください。