このページでは、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_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
tools=[
    {
        "type": "text_editor_20250124",
        "name": "str_replace_editor"
    }
]

# Claude 4
tools=[
    {
        "type": "text_editor_20250429",
        "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リリースノートをご確認ください。
  • 移行中に問題が発生した場合は、サポートにお問い合わせください。