工具 | 说明 | 是否需要权限 |
Agent | 否 | |
Artifact | 将本地单个 HTML 或 Markdown 文件发布为 artifact 并返回可分享的公网链接（Markdown 由服务端渲染为样式化页面）。传入 existingShareLink 可原地更新同一链接（仅刷新内容，不改动权限）。默认开启，可用 CODEBUDDY_ARTIFACT_ENABLED 或云端 productFeatures.Artifact 关闭（旧开关 CODEBUDDY_SHARE_LINK_ENABLED / productFeatures.ShareLink 仍兼容）。原名 ShareLink，旧名仅在权限规则（allow/deny、disallowedTools）中仍可匹配；hooks 的 matcher 与 --tools 白名单只认新名，需自行更新配置。参见环境变量 | 是 |
ArtifactControl | 对 Artifact 发布的 artifact 执行控制动作，当前仅支持取消发布（unpublish）：将公开链接设为私密。HTML 页面链接走取消发布；Markdown 文档链接会关闭公开访问并移除协作人。接受完整链接或裸 nodeId。原名 ShareLinkUnpublish（兼容范围同 Artifact） | 是 |
AskUserQuestion | 向用户提出多选问题，收集需求或澄清歧义 | 是 |
Bash | 是 | |
CronCreate | 否 | |
CronDelete | 按 ID 取消定时任务 | 否 |
CronList | 列出当前会话中所有定时任务 | 否 |
DeferExecuteTool | 执行通过 ToolSearch 发现的延迟加载工具 | 否 |
Edit | 对文件进行精确的字符串替换编辑 | 是 |
EnterPlanMode | 切换到计划模式，在编码前设计实现方案 | 否 |
EnterWorktree | 是 | |
ExitPlanMode | 提交计划供用户审批并退出计划模式 | 是 |
Glob | 基于 glob 模式查找文件 | 否 |
Grep | 在文件内容中搜索正则表达式模式 | 否 |
ImageGen | 根据文本描述生成图片，支持文生图和图生图 | 是 |
LeaveWorktree | 退出 worktree 会话并返回原始目录 | 是 |
ListMcpResources | 否 | |
LSP | 否 | |
MultiEdit | 在单个原子操作中对同一文件执行多步编辑 | 是 |
NotebookEdit | 修改 Jupyter notebook 单元格内容 | 是 |
NotebookRead | 读取 Jupyter notebook 单元格内容，可指定 cell_id 读单个 cell | 否 |
PowerShell | 在 Windows 上执行 PowerShell 命令。仅 Windows 可用，参见 PowerShell 工具行为 | 是 |
PushNotification | 否 | |
Read | 读取文件内容，支持图片、PDF 和 Jupyter notebook | 否 |
ReadMcpResource | 按 server + URI 读取指定 MCP 资源的内容，配合 ListMcpResources 使用 | 是 |
ReportFindings | 否 | |
SendMessage | 否 | |
Skill | 否 | |
SlashCommand | 是 | |
StructuredOutput | 返回符合 JSON Schema 的结构化输出 | 否 |
TaskCreate | 创建新任务到任务列表 | 否 |
TaskGet | 获取特定任务的完整详情 | 否 |
TaskList | 列出所有任务及其当前状态 | 否 |
TaskOutput | 获取后台任务或子代理的输出 | 否 |
TaskStop | 按 ID 终止正在运行的后台任务 | 否 |
TaskUpdate | 更新任务状态、依赖、详情或删除任务 | 否 |
TeamCreate | 否 | |
TeamDelete | 删除 Agent 团队及其任务目录 | 否 |
VideoGen | 根据文本描述或输入图片生成视频，支持文生视频和图生视频 | 是 |
ToolSearch | 否 | |
WaitForMcpServers | 等待指定的 MCP 服务器完成连接（默认等所有 pending 的服务器），最长 5 秒 | 否 |
WebFetch | 获取指定 URL 的内容并进行 AI 分析 | 是 |
WebSearch | 执行网络搜索 | 是 |
Workflow | 是 | |
Write | 创建或覆盖文件 | 是 |
disallowedTools；hooks 的 matcher 与 --tools 白名单只按工具真实名匹配）：工具 | 别名 |
TaskOutput | BashOutput |
TaskStop | KillShell |
PowerShell | pwsh、ps |
Artifact | ShareLink（更名前的旧名） |
ArtifactControl | ShareLinkUnpublish（更名前的旧名） |
CODEBUDDY_BASH_MAINTAIN_PROJECT_WORKING_DIR=1 可在每次命令后重置到项目目录。export 不会在下一条命令中生效。dangerouslyDisableSandbox 参数可逐条命令绕过沙箱（需要用户审批）。run_in_background 参数可将命令在后台运行，使用 TaskOutput 工具读取输出。适用于长时间运行的构建、测试等场景。&& 操作符仅 7+ 支持）。Invoke-Expression、Add-Type）会被阻止，系统修改类命令需要用户确认。环境变量 | 说明 |
CODEBUDDY_POWERSHELL_PATH | 显式指定 PowerShell 路径（优先于自动检测） |
CODEBUDDY_USE_POWERSHELL_TOOL | 设为 0 禁用 PowerShell 工具 |
PushNotification、ReportFindings）采用延迟加载机制。这些工具不会在初始工具列表中出现，需要通过 ToolSearch 发现和激活。一旦激活，工具在会话剩余时间内保持可用。文档反馈