遷移至 Claude 4

本頁面提供從 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 模型支持將工具使用與擴展思考交錯，允許更自然的對話，其中工具使用和響應可以與常規消息混合。

更多信息，請參閱擴展思考文檔。

​

更新的文本編輯器工具

Claude 4 模型的文本編輯器工具已更新，變更如下：

• 工具類型：text_editor_20250429
• 工具名稱：str_replace_based_edit_tool
• Claude 4 模型不再支持 undo_edit 命令。

如果您正在從 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 beta 標頭。

token-efficient-tools-2025-02-19 beta 標頭仍然可以包含在 Claude 4 請求中，但它不會產生任何效果。

​

不再支持擴展輸出

用於擴展輸出的 output-128k-2025-02-19 beta 標頭僅在 Claude Sonnet 3.7 中可用。

如果您正在從 Claude Sonnet 3.7 遷移，我們建議從您的請求中移除 output-128k-2025-02-19。

output-128k-2025-02-19 beta 標頭仍然可以包含在 Claude 4 請求中，但它不會產生任何效果。

​

性能考慮

​

Claude Sonnet 4

• 與 Claude Sonnet 3.7 相比，推理和智能能力有所提高
• 增強了工具使用的準確性

​

Claude Opus 4

• 最強大的模型，具有卓越的推理和智能
• 比 Sonnet 模型慢
• 最適合需要深入分析的複雜任務

​

遷移檢查清單

• 更新 API 調用中的模型 ID
• 測試現有請求（應該無需更改即可工作）
• 如適用，移除 token-efficient-tools-2025-02-19 beta 標頭
• 如適用，移除 output-128k-2025-02-19 beta 標頭
• 處理新的 refusal 停止原因
• 如果使用文本編輯器工具，更新工具類型和名稱
• 移除使用 undo_edit 命令的任何代碼
• 探索擴展思考的新工具交錯功能
• 查看 Claude 4 提示工程最佳實踐以獲得最佳結果
• 在生產部署前在開發環境中進行測試

​

需要幫助？

• 查看我們的 API 文檔以獲取詳細規格。
• 查看模型能力以進行性能比較。
• 查看 API 發布說明以了解 API 更新。
• 如果在遷移過程中遇到任何問題，請聯繫支持。