このページでは、Claude 3.7モデルからClaude 4モデル（Opus 4およびSonnet 4）への移行に関するガイダンスを提供します。 ほとんどの場合、最小限の変更でClaude 4モデルに切り替えることができます：
  1. モデル名を更新してください：
    • 変更前：claude-3-7-sonnet-20250219
    • 変更後：claude-sonnet-4-20250514またはclaude-opus-4-20250514
  2. 既存のAPI呼び出しは変更なしで動作し続けるはずですが、Claude 4モデルではAPIの動作が若干変更されています（詳細はAPIリリースノートを参照してください）。

​
Claude 4の新機能

​
新しい拒否停止理由

Claude 4モデルでは、Claude 4モデルの知能向上により、モデルが安全上の理由で生成を拒否するコンテンツに対して新しいrefusal停止理由が導入されています： 
{"id":"msg_014XEDjypDjFzgKVWdFUXxZP",
"type":"message",
"role":"assistant",
"model":"claude-sonnet-4-20250514",
"content":[{"type":"text","text":"I would be happy to assist you. You can "}],
"stop_reason":"refusal",
"stop_sequence":null,
"usage":{"input_tokens":564,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":22}
}
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_20250728
  • ツール名：str_replace_based_edit_tool
  • undo_editコマンドはClaude 4モデルではサポートされなくなりました。
str_replace_editorテキストエディターツールは、Claude Sonnet 3.7では同じままです。
Claude Sonnet 3.7から移行してテキストエディターツールを使用している場合： 
# Claude Sonnet 3.7
tools=[
    {
        "type": "text_editor_20250124",
        "name": "str_replace_editor"
    }
]

# Claude 4
tools=[
    {
        "type": "text_editor_20250728",
        "name": "str_replace_based_edit_tool"
    }
]
詳細については、テキストエディターツールドキュメントを参照してください。

​
トークン効率的ツール使用はサポートされなくなりました

トークン効率的ツール使用は、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リリースノートを確認してください。
  • 移行中に問題が発生した場合は、サポートにお問い合わせください。