工具參考

本頁是 Anthropic 所提供工具的參考，以及您可以在任何工具定義上設定的選用屬性。如需「tool use」（工具使用）的概念性介紹，請參閱 Claude 的工具使用。如需在您的應用程式中實作工具使用的指引，請參閱定義工具。

Anthropic 提供的工具

Anthropic 提供兩種工具：在 Anthropic 基礎設施上執行的伺服器工具（server tools），以及由 Anthropic 定義結構描述（schema）但由您的應用程式負責執行的用戶端工具（client tools）。這兩種工具都會與任何使用者自訂工具一同出現在您請求的 tools 陣列中。

關於模型相容性，請參閱各工具的頁面。支援的模型依工具及工具版本而有所不同。

工具版本管理

大多數 Anthropic 提供的工具在 type 字串中帶有 _YYYYMMDD 後綴。當工具的行為、結構描述或模型支援有所變更時，便會發布新版本。舊版本仍可繼續使用，以確保既有的整合能持續運作。

當某個工具有多個有效版本時，它們之間的關係各有不同：

• 依功能區分： web_search_20260209 和 web_fetch_20260209 相較於前一版本新增了動態內容篩選；web_fetch_20260309 新增了略過快取的選項；web_search_20260318 和 web_fetch_20260318 新增了回應內容納入控制。code_execution_20260120 新增了從沙箱內進行程式化工具呼叫的功能；code_execution_20260521 則在工具描述中揭露每個儲存格的時間限制。在上述每種情況下，新舊版本都是現行版本；要使用哪一個，取決於您是否需要新功能。
• 依模型區分： text_editor_20250728 適用於 Claude 4 及更新的模型，而 text_editor_20250124 適用於較早的模型。您使用的版本取決於您的目標模型。
• 變體，而非版本： tool_search_tool_regex_20251119 和 tool_search_tool_bm25_20251119 是同時發布的兩種搜尋演算法，兩者互不取代。
• 舊版： code_execution_20250522 僅支援 Python。code_execution_20250825 新增了 Bash 和檔案操作。
• 後繼版本： computer_toolset_20260801 是 beta 版 computer_20251124 和 computer_20250124 的穩定後繼版本；這些舊版本在較早的工具版本中所列的模型上仍可使用。browser_toolset_20260801 是瀏覽器使用工具的第一個版本。兩者皆為用戶端工具集。

mcp_toolset 類型不以日期進行版本管理；其版本資訊改由 anthropic-beta 標頭承載。

用戶端工具集

電腦使用工具與瀏覽器使用工具是 Anthropic 定義的「client toolsets」（用戶端工具集）：tools 中的一個項目會宣告一組固定的成員工具，其名稱、描述與輸入結構描述由 Anthropic 定義，而每次呼叫皆由您的應用程式執行。該項目不接受 name，因為含日期的 type 已固定了成員名稱。configs、cache_control 與 allowed_callers（僅接受 ["direct"]）為選用。

用戶端工具集是 Messages API 工具。它們目前無法作為 Claude Managed Agents 中的代理工具使用，後者提供其自有的內建代理工具集、MCP 工具集與自訂工具。

{
  "type": "browser_toolset_20260801",
  "configs": {
    "javascript_exec": { "enabled": true }
  },
  "cache_control": { "type": "ephemeral" }
}

configs 用於調整個別成員：

• 鍵為成員名稱，每個值僅接受 enabled 與 defer_loading。
• 您省略的成員會保留其預設值。缺少值、{} 與重述預設值三者等效。
• 未知的成員名稱或成員值中的任何其他欄位都會被拒絕，停用所有成員的 configs 亦然（請改為省略該項目）。
• 被停用的成員會從 Claude 可見的工具中移除。若 Claude 仍然指名該成員，請回傳錯誤的 tool_result。

請針對每個成員設定 defer_loading，切勿設定在項目上，並為每個已啟用的成員指定相同的值：在工具搜尋下，工具集會作為單一定義載入並展開。當每個已啟用的成員都延遲載入時，只有本身未延遲載入的工具搜尋工具才能讓該工具集浮現，因此請在同一請求中宣告一個。請勿在成員延遲載入的工具集項目上放置 cache_control；請改為將斷點設定在非延遲載入的工具上，因為延遲載入的定義不屬於快取前綴的一部分。

cache_control 僅能放在項目上；若要了解斷點落在何處（包括批次動作內的標記），請參閱搭配提示快取的工具使用。

處理成員工具呼叫。 Claude 會以 tool_use 區塊呼叫成員，其 name 為成員名稱，toolset_name 為 computer 或 browser；input 包含該成員的參數，且沒有 action 欄位。請依據 toolset_name 與 name 的組合進行分派，因為自訂工具可能與某個成員同名，且兩個工具集共用如 screenshot 等名稱。只有成員結果會回傳 toolset_name。同一輪中的多個成員呼叫會構成一個批次動作，您需依序執行（電腦使用、瀏覽器使用）。新成員只會隨新的含日期 type 一同推出。

工具集項目不支援的項目。 API 會以 invalid_request_error 拒絕以下每一項：

• strict: true 或 input_examples。
• 項目上的 defer_loading，或已啟用成員的 defer_loading 值不一致（請在 configs 中針對每個成員設定，且全部設為相同的值）。
• allowed_callers 中的程式碼執行呼叫者（不支援程式化工具呼叫）。
• 舊版的 fine-grained-tool-streaming-2025-05-14 beta 標頭。當您進行串流時，每個成員的 input 會以一個完整的 input_json_delta 送達。
• 類型為 tool 且指名工具集或成員的 tool_choice（請使用 auto、any 或 none）。
• 同一工具集的兩個項目，或帶有該工具集名稱的其他工具：與 computer_toolset_20260801 並存且名為 computer 的工具，或與 browser_toolset_20260801 並存且名為 browser 的工具。這兩個工具集可以一同宣告。

工具定義屬性

tools 陣列中的每個工具（包括使用者自訂工具）都接受選用屬性，用以控制工具的載入方式、誰可以呼叫它，以及其輸入的驗證方式。這些屬性可以組合使用：您可以在同一個工具上同時設定 defer_loading、cache_control 與 strict。

allowed_callers 值

allowed_callers 是一個陣列，接受以下任意組合：

"code_execution_20260120" 與 "code_execution_20260521" 在 allowed_callers 中皆可接受且可互換：使用任一程式碼執行工具版本的請求，都能滿足列出任一呼叫者的工具。無論請求宣告的是哪個版本，回應區塊一律將呼叫者標記為 code_execution_20260120。

從陣列中省略 "direct"（例如 "allowed_callers": ["code_execution_20260120"]）會引導 Claude 僅從程式碼執行內部呼叫該工具。回應的 tool_use 區塊包含一個 caller 欄位，用以識別是哪個呼叫者呼叫了該工具。完整說明（包括 caller 回應格式與錯誤行為）請參閱程式化工具呼叫。

defer_loading 與提示快取

設有 defer_loading: true 的工具會在計算快取鍵之前，從已轉譯的工具區段中移除。它們完全不會出現在系統提示前綴中。當工具搜尋發現某個延遲載入的工具並為其回傳 tool_reference 時，該工具的完整定義會在對話主體中的該位置就地展開，而非在前綴中。

這表示 defer_loading: true 能保留您的提示快取。您可以在請求中加入延遲載入的工具而不會使既有的快取項目失效，且快取在工具被發現的那一輪與工具被呼叫的那一輪之間皆維持有效。

若要了解如何將 defer_loading 與 cache_control 斷點結合使用，請參閱工具搜尋工具的提示快取指引。