内置工具

课程笔记

工具允许 LLM 在你的代码库中执行操作。OpenCode 内置了一组工具，你也可以通过 自定义工具 或 MCP 服务器 扩展。

默认情况下，所有工具都启用且无需权限即可运行。但你可以通过配置控制 权限。

配置

你可以全局或按代理配置工具。代理配置会覆盖全局设置。

默认所有工具设为 true。要禁用工具，设为 false。

全局配置

使用 tools 选项全局禁用或启用工具：

{
  "$schema": "https://opencode.ai/config.json",
  "tools": {
    "write": false,
    "bash": false,
    "webfetch": true
  }
}

按代理配置

在代理定义中使用 tools 覆盖全局设置：

{
  "$schema": "https://opencode.ai/config.json",
  "tools": {
    "write": true,
    "bash": true
  },
  "agent": {
    "plan": {
      "tools": {
        "write": false,
        "bash": false
      }
    }
  }
}

内置工具列表

bash

在项目环境中执行 shell 命令。

{
  "tools": {
    "bash": true
  }
}

允许 LLM 运行 npm install、git status 等终端命令。

edit

使用精确字符串替换修改现有文件。

{
  "tools": {
    "edit": true
  }
}

write

创建新文件或覆盖现有文件。

{
  "tools": {
    "write": true
  }
}

read

从代码库读取文件内容。

{
  "tools": {
    "read": true
  }
}

grep

使用正则表达式搜索文件内容。

{
  "tools": {
    "grep": true
  }
}

glob

通过模式匹配查找文件。

{
  "tools": {
    "glob": true
  }
}

list

列出的文件和目录在给定路径下。

{
  "tools": {
    "list": true
  }
}

lsp（实验性）

与配置的 LSP 服务器交互，获取代码智能功能如定义、引用、悬停信息和调用层次。

patch

对文件应用补丁。

{
  "tools": {
    "patch": true
  }
}

multiedit

批量修改同一个文件的多个位置。

{
  "tools": {
    "multiedit": true
  }
}

skill

加载 SKILL.md 文件并在对话中返回其内容。

{
  "tools": {
    "skill": true
  }
}

todowrite

在编码会话期间管理待办列表。

{
  "tools": {
    "todowrite": true
  }
}

todoread

读取现有待办列表。

{
  "tools": {
    "todoread": true
  }
}

webfetch

获取网页内容。

{
  "tools": {
    "webfetch": true
  }
}

websearch（实验性）

搜索网页内容，使用 OpenCode Exa AI 服务。

{
  "tools": {
    "websearch": true
  }
}

需要设置环境变量 OPENCODE_ENABLE_EXA=true 或使用 OpenCode Zen 托管模型。

codesearch（实验性）

搜索代码库和在线资源，查找相关 API、库和文档。

{
  "tools": {
    "codesearch": true
  }
}

需要设置环境变量 OPENCODE_ENABLE_EXA=true 或使用 OpenCode Zen 托管模型。

batch（实验性）

并行执行多个工具调用，优化性能。

{
  "tools": {
    "batch": true
  }
}

最多允许 25 个工具调用。不允许的工具：batch、invalid、patch。

内部实现

grep、glob 和 list 等工具底层使用 ripgrep。默认情况下 ripgrep 遵守 .gitignore 模式，因此 .gitignore 中列出的文件和目录会从搜索和列表中排除。

忽略模式

要包含通常会被忽略的文件，在项目根目录创建 .ignore 文件：

!node_modules/
!dist/
!build/

相关资源

• 自定义工具 - 创建自定义工具
• MCP 服务器 - 集成外部工具
• 权限配置 - 控制工具权限