本頁面提供從 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 模型引入了新的 refusal 停止原因，用於模型因安全原因拒絕生成的內容，這是由於 Claude 4 模型智能的提升： 
{"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
  • Claude 4 模型不再支援 undo_edit 命令。
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 更新。
  • 如果您在遷移過程中遇到任何問題，請聯絡支援。