本文介绍 Qoder CN CLI 提供的工具能力，包括搜索与探索、读取项目上下文、编辑文件、执行命令、管理上下文、分派与自动化、MCP 工具以及工具使用的控制方式。
Qoder CN CLI 通过工具处理本地工作区和外部信息源。工具可以搜索和读取项目内容、修改文件、执行命令、获取网页内容、维护上下文，并通过 MCP 接入外部服务。
工具可以在交互式 TUI 会话和非交互式 Print 模式中使用。实际可用的工具集合取决于当前会话、已启用的功能、MCP 配置和权限设置。
在 TUI 中使用 /tools 可以查看当前会话可用的工具。
搜索与探索
Qoder CN CLI 会使用搜索和探索类工具先理解当前任务，再决定下一步操作。
范围 | 说明 |
文件 | 在当前工作区中查找文件。 |
代码 | 搜索代码、文本和配置文件。 |
目录 | 浏览项目结构并定位相关路径。 |
Web | 当任务需要当前信息或公开资料时搜索网页。 |
网页内容 | 获取指定网页的内容。 |
读取项目上下文
Qoder CN CLI 可以读取文件和其他项目资产，为当前请求收集上下文。
功能 | 说明 |
查看文件 | 读取源代码、文档、配置和其他文本资产。 |
读取大文件 | 当文件过大时，只读取相关片段。 |
读取文档类资产 | 在支持时读取 PDF 等文档格式。 |
编辑文件
当任务需要变更时，Qoder CN CLI 可以在工作区中创建或修改文件。
功能 | 说明 |
修改文件 | 对已有文件进行定向修改。 |
创建文件 | 新增源代码、测试、文档或配置等文件。 |
编辑 Notebook | 在支持 Notebook 的场景中修改 Notebook 内容。 |
文件编辑会经过权限系统。根据权限模式和规则，Qoder CN CLI 可能直接应用变更、请求确认，或阻止操作。
执行命令
当任务需要本地执行时，Qoder CN CLI 可以运行 shell 命令。
功能 | 说明 |
运行命令 | 执行构建、测试、打包、Git 检查、项目排查或自定义 shell 命令。 |
运行长任务 | 跟踪耗时命令，例如测试套件或开发脚本。 |
Shell 命令通常比只读操作风险更高。建议用权限规则允许常规命令，并对敏感命令设置询问或拒绝。
管理上下文
部分工具用于帮助 Qoder CN CLI 维护当前任务和会话状态。
功能 | 说明 |
跟踪任务 | 在工作过程中维护轻量级计划或任务列表。 |
澄清问题 | 当缺少决策或关键信息时向用户提问。 |
管理记忆 | 在记忆能力可用时保存长期信息。 |
使用 Skills | 在配置后加载特定领域的说明或工作流。 |
规划工作 | 当任务需要先分析再执行时进入或退出 Plan 模式。 |
记忆和 Skills 会为模型提供上下文，但它们不是安全边界。需要强制策略时，请使用权限规则和 Hooks。
分派与自动化
当当前环境启用相关能力时，Qoder CN CLI 可以使用分派和自动化能力。
功能 | 说明 |
Subagents | 将特定工作分派给专门的 Agent。 |
Workflows | 运行已配置的可重复工作流。 |
Goals | 跟踪并执行较长周期的目标。 |
Worktrees | 当需要并行会话时，在独立 Git worktree 中工作。 |
定时任务 | 在调度能力启用时创建或管理定时任务。 |
具体可用范围取决于产品配置、功能开关和当前会话。
MCP 工具
Qoder CN CLI 可以连接 Model Context Protocol（MCP）服务，以使用外部工具和数据源。MCP 服务配置完成后，它们的工具会出现在同一个 /tools 视图中，并经过相同的权限系统。
MCP 工具适合接入 Issue 系统、代码托管平台、数据库、浏览器自动化、内部平台或企业自定义服务。
MCP 配置请参考 MCP 服务。
控制工具使用
工具是否可见和工具是否允许执行是两件事。
控制项 | 说明 |
| 限制当前会话中可见的工具。 |
| 预先允许指定工具或工具模式。 |
| 阻止指定工具或工具模式。 |
| 写在 settings 文件中的持久化权限规则。 |
| 启动时从发现结果中移除工具。 |
示例：
# 只读探索
qoderclicn --tools Read Grep Glob --allowed-tools 'Read,Grep,Glob'
# 允许常用状态检查命令
qoderclicn --allowed-tools 'Read,Grep,Bash(git status)'
# 在非交互式审查中禁止文件编辑
qoderclicn -p "review this repository" --disallowed-tools 'Write,Edit'