AI SDK - AnthropicTools

tools.ts

// packages/anthropic/src/anthropic-tools.ts

export const anthropicTools = {
  /**
   * bash 工具使 Claude 能够在持久的 bash 会话中执行 shell 命令，
   * 实现系统操作、脚本执行和命令行自动化。
   *
   * 支持图像结果。
   */
  bash_20241022,

  /**
   * bash 工具使 Claude 能够在持久的 bash 会话中执行 shell 命令，
   * 实现系统操作、脚本执行和命令行自动化。
   *
   * 支持图像结果。
   */
  bash_20250124,

  /**
   * Claude 可以分析数据、创建可视化、执行复杂计算，
   * 运行系统命令、创建和编辑文件，并直接在 API 会话中处理上传的文件。
   *
   * 代码执行工具使 Claude 能够在安全的沙盒环境中运行 Bash 命令并操作文件，
   * 包括编写代码。
   */
  codeExecution_20250522,

  /**
   * Claude 可以分析数据、创建可视化、执行复杂计算，
   * 运行系统命令、创建和编辑文件，并直接在 API 会话中处理上传的文件。
   *
   * 该代码执行工具允许 Claude 同时运行 Python 和 Bash 命令并操作文件，
   * 包括编写代码，且运行在安全的沙盒环境中。
   *
   * 这是增强 Bash 支持和文件操作的最新版本。
   */
  codeExecution_20250825,

  /**
   * Claude 可以通过计算机工具与计算机环境交互，
   * 提供屏幕截图能力及鼠标/键盘控制，实现自主桌面操作。
   *
   * 支持图像结果。
   *
   * @param displayWidthPx - 控制的显示器宽度（像素）。
   * @param displayHeightPx - 控制的显示器高度（像素）。
   * @param displayNumber - 要控制的显示编号（仅对 X11 环境相关）。若指定，工具定义中会包含该参数。
   */
  computer_20241022,

  /**
   * Claude 可以通过计算机工具与计算机环境交互，
   * 提供屏幕截图能力及鼠标/键盘控制，实现自主桌面操作。
   *
   * 支持图像结果。
   *
   * @param displayWidthPx - 控制的显示器宽度（像素）。
   * @param displayHeightPx - 控制的显示器高度（像素）。
   * @param displayNumber - 要控制的显示编号（仅对 X11 环境相关）。若指定，工具定义中会包含该参数。
   */
  computer_20250124,

  /**
   * memory 工具允许 Claude 通过内存文件目录在会话间存储与检索信息。
   * Claude 可以创建、读取、更新和删除在会话间持久存在的文件，
   * 使其能够随着时间积累知识，而无需将所有内容都放在上下文窗口中。
   * memory 工具运行在客户端——你可自行控制数据的存储方式和位置。
   *
   * 支持的模型：Claude Sonnet 4.5，Claude Sonnet 4，Claude Opus 4.1，Claude Opus 4。
   */
  memory_20250818,

  /**
   * Claude 可以使用 Anthropic 定义的文本编辑器工具查看和修改文本文件，
   * 协助调试、修复和改进你的代码或其他文本文档。
   * 这使 Claude 可以直接与文件交互，提供实际操作而不仅仅是提出建议。
   *
   * 支持的模型：Claude Sonnet 3.5
   */
  textEditor_20241022,

  /**
   * Claude 可以使用 Anthropic 定义的文本编辑器工具查看和修改文本文件，
   * 协助调试、修复和改进你的代码或其他文本文档。
   * 这使 Claude 可以直接与文件交互，提供实际操作而不仅仅是提出建议。
   *
   * 支持的模型：Claude Sonnet 3.7
   */
  textEditor_20250124,

  /**
   * Claude 可以使用 Anthropic 定义的文本编辑器工具查看和修改文本文件，
   * 协助调试、修复和改进你的代码或其他文本文档。
   * 这使 Claude 可以直接与文件交互，提供实际操作而不仅仅是提出建议。
   *
   * 注意：此版本不支持 "undo_edit" 命令。
   *
   * @deprecated 请使用 textEditor_20250728
   */
  textEditor_20250429,

  /**
   * Claude 可以使用 Anthropic 定义的文本编辑器工具查看和修改文本文件，
   * 协助调试、修复和改进你的代码或其他文本文档。
   * 这使 Claude 可以直接与文件交互，提供实际操作而不仅仅是提出建议。
   *
   * 注意：此版本不支持 "undo_edit" 命令，并新增可选的 max_characters 参数。
   *
   * 支持的模型：Claude Sonnet 4、Opus 4 和 Opus 4.1
   *
   * @param maxCharacters - 可选，文件可查看的最大字符数。
   */
  textEditor_20250728,

  /**
   * 创建 web 抓取工具，让 Claude 能直接访问实时网页内容。
   *
   * @param maxUses - max_uses 参数限制 web 抓取次数
   * @param allowedDomains - 只允许从这些域名抓取
   * @param blockedDomains - 禁止从这些域名抓取
   * @param citations - 与 web search 必须启用引用不同，web fetch 可选择是否启用引用。设置 "citations": {"enabled": true} 让 Claude 能从抓取的文档中引用具体段落。
   * @param maxContentTokens - max_content_tokens 参数限制将包含在上下文中的内容数量。
   */
  webFetch_20250910,

  /**
   * 创建 web 搜索工具，让 Claude 能直接访问实时网页内容。
   *
   * @param maxUses - 对话期间 Claude 可执行的最大 web 搜索次数。
   * @param allowedDomains - 可选，只允许 Claude 搜索的域名列表。
   * @param blockedDomains - 可选，Claude 搜索时应避开的域名列表。
   * @param userLocation - 可选，用户位置信息，为你提供地理相关的搜索结果。
   */
  webSearch_20250305,

  /**
   * 创建工具搜索工具，基于正则表达式查找工具。
   *
   * 工具搜索工具使 Claude 能够通过动态发现并按需加载工具，
   * 轻松处理数百到数千个工具，无需在上下文窗口中一次性加载全部工具定义。
   * Claude 会搜索你的工具目录，仅加载所需工具。
   *
   * 对其它工具使用 `providerOptions: { anthropic: { deferLoading: true } }`
   * 可标记为延迟加载。
   *
   * 支持的模型：Claude Opus 4.5、Claude Sonnet 4.5
   */
  toolSearchRegex_20251119,

  /**
   * 创建工具搜索工具，基于 BM25（自然语言）查找工具。
   *
   * 工具搜索工具使 Claude 能够通过动态发现并按需加载工具，
   * 轻松处理数百到数千个工具，无需在上下文窗口中一次性加载全部工具定义。
   * Claude 会搜索你的工具目录，仅加载所需工具。
   *
   * 对其它工具使用 `providerOptions: { anthropic: { deferLoading: true } }`
   * 可标记为延迟加载。
   *
   * 支持的模型：Claude Opus 4.5、Claude Sonnet 4.5
   */
  toolSearchBm25_20251119,
};