跳轉到主要內容

說明

Claude 系列模型支援透過官方原生介面呼叫,使用前請先安裝或升級 anthropic 依賴:
非 claude 模型請用 openai 的介面格式呼叫。

模型信息

  1. 對於 3.5 及以上的模型,如果需要超過 4096 Tokens 的輸出,請傳入明確的 “max_tokens” 數值,參考上方表格中的最長輸出長度
  2. 對於 Sonnet 3.7,你可以透過在請求體中傳入 extra_headers={"anthropic-beta": "output-128k-2025-02-19"} 來把最大輸出從 64K 擴展到 128K,見下方「流式 128K」呼叫,或者參考 Claude 官方的Beta headers 說明

Claude 4 新功能

新的拒絕停止原因 (Refusal Stop Reason)

Claude 4 模型引入了新的 refusal 停止原因,用於處理模型因安全原因拒絕生成的內容:
在遷移到 Claude 4 時,您應該更新應用程序以處理 refusal 停止原因。

擴展思考 (Extended Thinking)

啟用擴展思考後,Claude 4 模型的 Messages API 會返回 Claude 完整思考過程的摘要。摘要思考提供了擴展思考的全部智能優勢,同時防止濫用。 雖然 API 在 Claude 3.7 和 4 模型之間保持一致,但擴展思考的流式響應可能以”塊狀”傳遞模式返回,流式事件之間可能存在延遲。 摘要由與您在請求中指定的模型不同的模型處理。思考模型不會看到摘要輸出。

交錯思考 (Interleaved Thinking)

Claude 4 模型支援將工具使用與擴展思考交錯,允許更自然的對話,其中工具使用和響應可以與常規消息混合。 交錯思考目前處於測試階段。要啟用交錯思考,請在 API 請求中添加測試頭 interleaved-thinking-2025-05-14
端點(Endpoint): POST /v1/messages

呼叫

Body 請求結構

請求參數

返回示例

返回結果

遷移到 Claude 4

如果您正在從 Claude 3.7 遷移到 Claude 4 模型,請注意以下變化:

更新模型名稱

處理新的停止原因

更新您的應用程序以處理新的 refusal 停止原因:

移除不支持的功能

  • Token 高效工具使用:僅在 Claude Sonnet 3.7 中可用,Claude 4 中不再支持
  • 擴展輸出output-128k-2025-02-19 測試頭僅在 Claude Sonnet 3.7 中可用
如果您正在從 Claude Sonnet 3.7 遷移,建議從請求中移除這些測試頭:

在應用中使用(以 Lobe-Chat 為例)

  • 進入設置頁面選擇模型服務商 Claude
  • API key 輸入本站的 Key
  • 接口代理地址,直接輸入下方的網址:
  • 建議打開「使用客户端請求模式」
  • 最後在模型列表添加自己要使用的模型(建議從我們網站的設置頁面複製粘貼模型名後選擇)\ 圖片 圖片

Claude 文本編輯工具

Claude 可以使用 Anthropic 定義的文本編輯工具來查看和修改文本文件,幫助你調試、修復和改進代碼或其他文本文檔。這使得 Claude 能够直接與你的文件進行交互,提供實際的操作幫助,而不僅僅是提出建議。

使用文本編輯工具前的準備

選擇兼容的模型 Anthropic 的文本編輯工具支持以下 Claude 模型:
  • Claude 4 系列模型 (claude-opus-4-20250514, claude-sonnet-4-20250514): text_editor_20250429
  • Claude 3.7 Sonnet (claude-3-7-sonnet-20250219): text_editor_20250124
  • Claude 3.5 Sonnet (claude-3-5-sonnet-20241022): text_editor_20241022
Claude 4 模型使用了全新的文本編輯工具,與舊版本不兼容。請確保使用正確的工具類型和名稱。

模型對應的工具配置

重要變化: Claude 4 模型不再支持 undo_edit 命令,請在代碼中移除對此功能的依賴。

評估使用場景

以下是使用文本編輯工具的一些典型場景:
  • 代碼調試:幫助識別和修復代碼中的問題,從語法錯誤到邏輯問題。
  • 代碼重構:通過有針對性的編輯來改進代碼結構、可讀性和性能。
  • 文檔生成:為你的代碼庫添加文檔字符串、注釋或 README 文件。
  • 測試創建:根據對實現的理解創建單元測試。

使用文本編輯工具

通過 Messages API 向 Claude 提供文本編輯工具(命名為 str_replace_editor): 需要安裝 anthropic 包:
調用示例:

遷移到 Claude 4(文本編輯工具)

如果您正在從 Claude 3.7 Sonnet 遷移到 Claude 4 模型,請注意以下變化:

更新工具配置

python

移除不支持的功能

  • undo_edit 命令:Claude 4 模型不再支持撤銷編輯功能
  • 請從您的代碼中移除任何依賴 undo_edit 的邏輯
返回示例:

最後更新:2026-06-01