Claude 的工具使用

「Tool use」（工具使用）讓 Claude 能夠呼叫您定義或 Anthropic 提供的函式。Claude 會根據使用者的請求和工具的描述來決定何時呼叫工具。接著它會回傳一個結構化的呼叫，由您的應用程式執行（用戶端工具）或由 Anthropic 執行（伺服器工具）。

以下是使用伺服器工具的最簡範例，即 Web search 工具，由 Anthropic 為您執行：

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    tools=[{"type": "web_search_20260209", "name": "web_search"}],
    messages=[{"role": "user", "content": "What's the latest on the Mars rover?"}],
)
print(response.content)

Claude 在 Anthropic 的基礎設施上執行搜尋，並在同一個回應中回傳附有引用來源的結果。若要讓 Claude 呼叫您定義的函式，請傳遞一個帶有 input_schema 的工具，然後在 Claude 回傳 tool_use 區塊時執行該呼叫。定義工具和處理工具呼叫涵蓋了這個往返流程。



工具使用的運作方式

工具的主要差異在於程式碼執行的位置。用戶端工具（包括使用者定義的工具以及具有 Anthropic 定義結構描述的工具，例如 bash 和 text_editor）在您的應用程式中執行。Claude 會以 stop_reason: "tool_use" 和一個或多個 tool_use 區塊回應。您的程式碼執行該操作並回傳 tool_result。伺服器工具（例如 web_search、web_fetch、code_execution 和 tool_search）在 Anthropic 的基礎設施上執行：您無需處理執行過程即可直接看到結果，除非 Claude 在與您的某個用戶端工具相同的平行工具呼叫群組中呼叫該工具（請參閱停止原因與備援）。

如需完整的概念模型，包括代理迴圈以及何時選擇每種方法，請參閱工具使用的運作方式。

如需連接到「Model Context Protocol」，即 MCP 伺服器，請參閱 MCP 連接器。如需建立您自己的 MCP 用戶端，請參閱 Model Context Protocol 的建立 MCP 用戶端指南。



Claude 何時使用工具

在預設的 tool_choice 為 {"type": "auto"} 時，Claude 會在每個回合決定是呼叫工具還是直接回應。當請求對應到該工具所描述的功能，且答案尚未存在於上下文中時，它會呼叫工具。對於穩定的知識、創意任務和對話性回合，它會直接回應。

這個界限可以透過您的系統提示來引導。如果 Claude 沒有在您預期的時候呼叫工具，一個輕量的指示，例如 "Use the tools to investigate before responding."（在回應前使用工具進行調查），會增加工具使用。更強烈的形式，例如 "Always call a tool first before responding."（在回應前一律先呼叫工具），會進一步推動。相反地，"Use your judgment about whether to call a tool or respond directly."（自行判斷是否呼叫工具或直接回應）會讓觸發行為保持保守。

若要強制要求工具呼叫而非依賴提示，請設定 tool_choice。

每個伺服器工具的頁面都會更詳細地描述其觸發界限。



選擇工具

如需 type 字串、版本和 beta 標頭，請參閱工具參考。



您自己的工具

對於您定義的工具，您撰寫結構描述，並由您的應用程式執行每次呼叫。



Anthropic 結構描述的用戶端工具

Anthropic 發布結構描述並以此訓練 Claude。您的應用程式仍需執行每次呼叫並回傳 tool_result。



伺服器工具

伺服器工具在 Anthropic 的基礎設施上執行，您的應用程式中無需處理程式碼。請參閱伺服器工具以了解它們共用的機制。



定價

工具使用請求的計價依據如下：

1. 傳送至模型的輸入 token 總數（包含 tools 參數中的內容）
2. 生成的輸出 token 數量
3. 對於伺服器端工具，會有額外的用量計費（例如，網頁搜尋會依每次執行的搜尋收費）

用戶端工具的計價方式與任何其他 Claude API 請求相同，而伺服器端工具可能會根據其特定用量產生額外費用。

工具使用所產生的額外 token 來自：

• API 請求中的 tools 參數（工具名稱、描述和結構定義）
• API 請求和回應中的 tool_use 內容區塊
• API 請求中的 tool_result 內容區塊

當您使用 tools 時，API 也會自動為模型加入一個特殊的系統提示以啟用工具使用。每個模型所需的工具使用 token 數量列於下方（不包含上述的額外 token）。請注意，此表格假設至少提供了 1 個工具。如果未提供任何 tools，則 tool choice 為 none 時會使用 0 個額外的系統提示 token。

這些 token 數量會加到您正常的輸入和輸出 token 中，以計算請求的總費用。

請參閱模型總覽表格以取得目前各模型的價格。

當您傳送工具使用提示時，與任何其他 API 請求一樣，回應會在回報的 usage 指標中包含輸入和輸出 token 數量。

某些伺服器工具會在 token 之外增加基於使用量的費用：請參閱 Web search 工具和 Code execution 工具以了解其費率。



後續步驟