CodeBuddy Code 内置一系列工具来帮助理解和修改代码库。下表中的工具名称即为权限规则、子代理工具列表和 Hook 匹配器中使用的标识符。
工具 | 说明 | 是否需要权限 |
| 生成具有独立上下文窗口的子代理来处理任务 | 否 |
| 将本地单个 HTML 或 Markdown 文件发布为 artifact 并返回可分享的公网链接（Markdown 由服务端渲染为样式化页面）。传入 | 是 |
| 对 | 是 |
| 向用户提出多选问题，收集需求或澄清歧义 | 是 |
| 在你的环境中执行 Shell 命令。参见 Bash 工具行为 | 是 |
| 在当前会话内调度定时或一次性任务（退出后失效）。参见定时任务 | 否 |
| 按 ID 取消定时任务 | 否 |
| 列出当前会话中所有定时任务 | 否 |
| 执行通过 | 否 |
| 对文件进行精确的字符串替换编辑 | 是 |
| 切换到计划模式，在编码前设计实现方案 | 否 |
| 创建隔离的 git worktree 并切换到其中 | 是 |
| 提交计划供用户审批并退出计划模式 | 是 |
| 基于 glob 模式查找文件 | 否 |
| 在文件内容中搜索正则表达式模式 | 否 |
| 根据文本描述生成图片，支持文生图和图生图 | 是 |
| 退出 worktree 会话并返回原始目录 | 是 |
| 列出已连接 MCP 服务器暴露的所有资源/模板，可选按服务器名过滤 | 否 |
| 通过语言服务器提供代码智能。文件编辑后自动报告类型错误和警告。还支持跳转定义、查找引用、获取类型信息、列出符号、查找实现、追踪调用层级等导航操作。需要代码智能插件及其语言服务器二进制文件 | 否 |
| 在单个原子操作中对同一文件执行多步编辑 | 是 |
| 修改 Jupyter notebook 单元格内容 | 是 |
| 读取 Jupyter notebook 单元格内容，可指定 | 否 |
| 在 Windows 上执行 PowerShell 命令。仅 Windows 可用，参见 PowerShell 工具行为 | 是 |
| 发送终端/桌面通知，用于长任务或后台任务完成时提醒用户。延迟加载工具，参见环境变量 | 否 |
| 读取文件内容，支持图片、PDF 和 Jupyter notebook | 否 |
| 按 server + URI 读取指定 MCP 资源的内容，配合 | 是 |
| 将代码审查发现的问题以结构化字段（文件、摘要、失败场景、可选分类）提交，渲染为专门的列表组件而非纯文本。延迟加载工具，参见环境变量 | 否 |
| 在 Agent 团队中向队友发送消息 | 否 |
| 在主对话中执行 Skill 技能 | 否 |
| 执行自定义斜杠命令 | 是 |
| 返回符合 JSON Schema 的结构化输出 | 否 |
| 创建新任务到任务列表 | 否 |
| 获取特定任务的完整详情 | 否 |
| 列出所有任务及其当前状态 | 否 |
| 获取后台任务或子代理的输出 | 否 |
| 按 ID 终止正在运行的后台任务 | 否 |
| 更新任务状态、依赖、详情或删除任务 | 否 |
| 创建 Agent 团队以协调多个代理协作 | 否 |
| 删除 Agent 团队及其任务目录 | 否 |
| 根据文本描述或输入图片生成视频，支持文生视频和图生视频 | 是 |
| 搜索并加载延迟加载的工具，支持内置工具和 MCP 工具；可结合 Defer(...)/NoDefer(...) 修饰符 按需调整工具的延迟加载状态 | 否 |
| 等待指定的 MCP 服务器完成连接（默认等所有 pending 的服务器），最长 5 秒 | 否 |
| 获取指定 URL 的内容并进行 AI 分析 | 是 |
| 执行网络搜索 | 是 |
| 启动 Dynamic Workflow 异步运行，立刻返回 runId 并在后台执行；通过 | 是 |
| 创建或覆盖文件 | 是 |
权限规则可通过 /permissions 命令或在权限设置中配置。另请参阅工具特定的权限规则。
部分工具拥有别名，可在权限规则中互换使用（仅适用于权限规则 allow/deny/ask 与 disallowedTools；hooks 的 matcher 与 --tools 白名单只按工具真实名匹配）：
工具 | 别名 |
|
|
|
|
|
|
|
|
|
|
Bash 工具在独立进程中执行每条命令，具有以下持久化特性：
工作目录在命令间保持不变。设置 CODEBUDDY_BASH_MAINTAIN_PROJECT_WORKING_DIR=1 可在每次命令后重置到项目目录。
环境变量不会持久化。一条命令中的 export 不会在下一条命令中生效。
在启动 CodeBuddy Code 前激活你的 virtualenv 或 conda 环境。要使环境变量在 Bash 命令间持久化，启动前设置 CODEBUDDY_ENV_FILE 指向一个 shell 脚本，或使用 SessionStart Hook 动态填充。
Bash 工具支持沙箱隔离，可限制文件系统和网络访问。启用沙箱时，命令在受限环境中执行，防止未授权的系统访问。
通过 dangerouslyDisableSandbox 参数可逐条命令绕过沙箱（需要用户审批）。
通过 run_in_background 参数可将命令在后台运行，使用 TaskOutput 工具读取输出。适用于长时间运行的构建、测试等场景。
PowerShell 工具仅在 Windows 上可用，提供原生 PowerShell 命令执行能力。
有 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）会被阻止，系统修改类命令需要用户确认。
环境变量 | 说明 |
| 显式指定 PowerShell 路径（优先于自动检测） |
| 设为 |
部分工具（如通过 MCP 服务器提供的工具，以及少数内置工具如 PushNotification、ReportFindings）采用延迟加载机制。这些工具不会在初始工具列表中出现，需要通过 ToolSearch 发现和激活。一旦激活，工具在会话剩余时间内保持可用。
身份和访问管理：权限系统、规则语法和工具特定规则
子代理：为子代理配置工具访问权限
Hooks 钩子系统：在工具执行前后运行自定义命令
MCP 集成：通过 MCP 服务器扩展可用工具
定时任务：使用 CronCreate 调度自动化任务
Agent 团队：多代理协作的团队系统
