遷移至 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 模型引入了一個新的 refusal
停止原因,用於模型因安全原因拒絕生成的內容,這是由於 Claude 4 模型的智能增強:
當遷移到 Claude 4 時,您應該更新您的應用程序以處理 refusal
停止原因。
總結思考
啟用擴展思考後,Claude 4 模型的 Messages API 會返回 Claude 完整思考過程的摘要。總結思考提供了擴展思考的全部智能優勢,同時防止濫用。
雖然 API 在 Claude 3.7 和 4 模型之間保持一致,但擴展思考的流式響應可能會以”塊狀”傳遞模式返回,流式事件之間可能會有延遲。
摘要由與您在請求中目標不同的模型處理。思考模型不會看到摘要輸出。
更多信息,請參閱擴展思考文檔。
交錯思考
Claude 4 模型支持將工具使用與擴展思考交錯,允許更自然的對話,其中工具使用和響應可以與常規消息混合。
交錯思考處於測試階段。要啟用交錯思考,請在您的 API 請求中添加 beta 標頭 interleaved-thinking-2025-05-14
。
更多信息,請參閱擴展思考文檔。
更新的文本編輯器工具
Claude 4 模型的文本編輯器工具已更新,變更如下:
- 工具類型:
text_editor_20250429
- 工具名稱:
str_replace_based_edit_tool
- Claude 4 模型不再支持
undo_edit
命令。
對於 Claude Sonnet 3.7,str_replace_editor
文本編輯器工具保持不變。
如果您正在從 Claude Sonnet 3.7 遷移並使用文本編輯器工具:
更多信息,請參閱文本編輯器工具文檔。
不再支持令牌高效工具使用
令牌高效工具使用僅在 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 提示工程最佳實踐以獲得最佳結果
- 在生產部署前在開發環境中進行測試