工具参考
Anthropic 提供的工具目录以及可选工具定义属性的参考。
本页是 Anthropic 提供的工具以及你可以在任何工具定义上设置的可选属性的参考。有关工具使用的概念介绍，请参阅Claude 的工具使用。有关在应用程序中实现工具使用的指导，请参阅定义工具。
Anthropic 提供的工具
Anthropic 提供两种工具：在 Anthropic 的基础设施上执行的服务器端工具，以及 Anthropic 定义 schema 但你的应用程序处理执行的客户端工具。两种工具都与任何用户定义的工具一起出现在请求的 tools 数组中。
| 工具 | type | 执行方式 | 状态 |
|---|---|---|---|
| 网络搜索工具 | web_search_20260209web_search_20250305 | 服务器端 | GA |
| 网页抓取工具 | web_fetch_20260209web_fetch_20250910 | 服务器端 | GA |
| 代码执行工具 | code_execution_20260120code_execution_20250825 | 服务器端 | GA |
| 顾问工具 | advisor_20260301 | 服务器端 | Beta: advisor-tool-2026-03-01 |
| 工具搜索工具 | tool_search_tool_regex_20251119tool_search_tool_bm25_20251119 | 服务器端 | GA |
| MCP 连接器 | mcp_toolset | 服务器端 | Beta: mcp-client-2025-11-20 |
| 内存工具 | memory_20250818 | 客户端 | GA |
| Bash 工具 | bash_20250124 | 客户端 | GA |
| 文本编辑器工具 | text_editor_20250728text_editor_20250124 | 客户端 | GA |
| 计算机使用工具 | computer_20251124computer_20250124 | 客户端 | Beta: computer-use-2025-11-24computer-use-2025-01-24 |
有关模型兼容性，请参阅每个工具的页面。支持的模型因工具和工具版本而异。
工具搜索的 type 值也接受不带日期的别名：
tool_search_tool_regex 和 tool_search_tool_bm25。这些解析为
最新的带日期版本。
工具版本控制
大多数 Anthropic 提供的工具在 type 字符串中带有 _YYYYMMDD 后缀。当工具的行为、schema 或模型支持发生变化时，会发布新版本。旧版本仍然可用，以便现有集成继续工作。
当工具有多个活动版本时，它们之间的关系各不相同：
- 功能键控：
web_search_20260209和web_fetch_20260209在其前身之上添加了动态内容过滤。code_execution_20260120添加了从沙箱内进行程序化工具调用。在每种情况下，新版本和旧版本都是当前的；你使用哪个取决于你是否需要新功能。 - 模型键控：
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。
| 属性 | 用途 | 可用于 | 详细指南 |
|---|---|---|---|
cache_control | 在此工具定义处设置提示缓存断点 | 所有工具 | 提示缓存 |
strict | 保证工具名称和输入的 schema 验证 | 除 mcp_toolset 外的所有工具 | 严格工具使用 |
defer_loading | 从初始系统提示中排除工具；当工具搜索返回该工具的 tool_reference 时按需加载 | 所有工具（对于 mcp_toolset，请参阅工具配置） | 工具搜索工具 |
allowed_callers | 限制哪些调用者可以调用该工具 | 除 mcp_toolset 外的所有工具 | 程序化工具调用 |
input_examples | 提供示例输入对象以帮助 Claude 理解如何调用该工具 | 用户定义和 Anthropic-schema 客户端工具。服务器端工具不可用。 | 定义工具 |
eager_input_streaming | 为此工具启用细粒度输入流（true）或保持标准缓冲流（false） | 仅限用户定义工具 | 细粒度工具流 |
allowed_callers 值
allowed_callers 是一个接受任意组合的数组：
| 值 | 含义 |
|---|---|
"direct" | 模型可以在 tool_use 块中直接调用此工具。如果省略 allowed_callers，这是默认值。 |
"code_execution_20260120" | 在 code_execution_20260120 沙箱内运行的代码可以调用此工具。 |
从数组中省略 "direct"（例如 "allowed_callers": ["code_execution_20260120"]）意味着该工具只能从代码执行内部调用。响应的 tool_use 块包含一个 caller 字段，标识哪个调用者调用了该工具。有关完整处理，包括 caller 响应形状和错误行为，请参阅程序化工具调用。
defer_loading 和提示缓存
带有 defer_loading: true 的工具在计算缓存键之前会从渲染的工具部分中移除。它们根本不会出现在系统提示前缀中。当工具搜索发现延迟工具并返回其 tool_reference 时，该工具的完整定义会在对话主体中的该点展开，而不是在前缀中。
这意味着 defer_loading: true 保留了你的提示缓存。你可以向请求添加延迟工具而不会使现有缓存条目失效，并且缓存从发现工具的回合到调用工具的回合之间保持有效。
有关如何将 defer_loading 与 cache_control 断点结合使用，请参阅工具搜索工具提示缓存指导。