说明：
CodeBuddy Code 可用工具的完整参考，包括权限要求。
工具 | 说明 | 是否需要权限 |
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 | 创建或覆盖文件 | 是 |
工具别名
部分工具拥有别名，可在权限规则中互换使用（仅适用于权限规则 allow/deny/ask 与
disallowedTools；hooks 的 matcher 与 --tools 白名单只按工具真实名匹配）：工具 | 别名 |
TaskOutput | BashOutput |
TaskStop | KillShell |
PowerShell | pwsh、ps |
Artifact | ShareLink（更名前的旧名） |
ArtifactControl | ShareLinkUnpublish（更名前的旧名） |
Bash 工具行为
Bash 工具在独立进程中执行每条命令，具有以下持久化特性：
工作目录在命令间保持不变。设置
CODEBUDDY_BASH_MAINTAIN_PROJECT_WORKING_DIR=1 可在每次命令后重置到项目目录。环境变量不会持久化。一条命令中的
export 不会在下一条命令中生效。在启动 CodeBuddy Code 前激活你的 virtualenv 或 conda 环境。要使环境变量在 Bash 命令间持久化，启动前设置
CODEBUDDY_ENV_FILE 指向一个 shell 脚本，或使用 SessionStart Hook 动态填充。沙箱模式
通过
dangerouslyDisableSandbox 参数可逐条命令绕过沙箱（需要用户审批）。后台执行
通过
run_in_background 参数可将命令在后台运行，使用 TaskOutput 工具读取输出。适用于长时间运行的构建、测试等场景。PowerShell 工具行为
PowerShell 工具仅在 Windows 上可用，提供原生 PowerShell 命令执行能力。
与 Bash 工具的关系
有 Git Bash 时：Bash 工具和 PowerShell 工具同时可用，模型根据场景选择合适的工具
无 Git Bash 时：Bash 工具自动禁用，PowerShell 工具成为唯一的 shell 工具
macOS/Linux 上 PowerShell 工具不可用
版本适配
PowerShell 工具自动检测 PowerShell 版本，优先使用 PowerShell 7+（pwsh），其次使用 Windows PowerShell 5.1。prompt 中的语法指导会根据版本差异自动调整（如
&& 操作符仅 7+ 支持）。安全检查
PowerShell 工具内置安全检查器，覆盖代码注入、下载执行、提权操作、系统破坏等危险模式。危险命令（如
Invoke-Expression、Add-Type）会被阻止，系统修改类命令需要用户确认。环境变量
环境变量 | 说明 |
CODEBUDDY_POWERSHELL_PATH | 显式指定 PowerShell 路径（优先于自动检测） |
CODEBUDDY_USE_POWERSHELL_TOOL | 设为 0 禁用 PowerShell 工具 |
延迟加载工具
部分工具（如通过 MCP 服务器提供的工具，以及少数内置工具如
PushNotification、ReportFindings）采用延迟加载机制。这些工具不会在初始工具列表中出现，需要通过 ToolSearch 发现和激活。一旦激活，工具在会话剩余时间内保持可用。另请参阅
身份和访问管理：权限系统、规则语法和工具特定规则
子代理：为子代理配置工具访问权限
Hooks 钩子系统：在工具执行前后运行自定义命令
MCP 集成：通过 MCP 服务器扩展可用工具
定时任务：使用 CronCreate 调度自动化任务
Agent 团队：多代理协作的团队系统
