工具参考

本页面是 Anthropic 所提供工具的参考，以及您可以在任何工具定义上设置的可选属性的参考。有关工具使用的概念性介绍，请参阅使用 Claude 进行工具使用。有关在您的应用程序中实现工具使用的指导，请参阅定义工具。



Anthropic 提供的工具

Anthropic 提供两种类型的工具：在 Anthropic 基础设施上执行的服务器工具（server tools），以及由 Anthropic 定义架构但由您的应用程序处理执行的客户端工具（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 和文件操作功能。

mcp_toolset 类型不使用日期版本控制；版本控制改为通过 anthropic-beta 标头传递。



工具定义属性

tools 数组中的每个工具（包括用户定义的工具）都接受可选属性，这些属性控制工具的加载方式、谁可以调用它以及如何验证其输入。这些属性可以组合使用：您可以在同一个工具上同时设置 defer_loading、cache_control 和 strict。



allowed_callers 的取值

allowed_callers 是一个数组，可接受以下值的任意组合：

allowed_callers 中同时接受 "code_execution_20260120" 和 "code_execution_20260521"，且两者可互换：使用任一代码执行工具版本的请求都满足列出任一调用方的工具的要求。无论请求声明的是哪个版本，响应块始终将调用方标记为 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 断点结合使用，请参阅工具搜索工具的提示缓存指南。