使用 CLI

输入模式

TUI 提供多种输入模式：

内置工具

Qoder CN CLI 内置了 Grep、Read、Write 和 Bash 等工具，可用于文件/目录操作与执行 shell 命令。

斜杠命令

使用以下内置斜杠命令可快速访问功能和设置：

高级启动选项

启动 CLI 时，可使用以下选项来控制其行为：

参数

Qoder CN CLI 安装完成后即可在系统中使用 qoderclicn 命令，命令参数及功能介绍如下：

管理 MCP

• 使用 -t 设置 MCP 服务类型：stdio、sse、streamable-http，Stdio 类型 Server 在 TUI 启动时会被自动拉起。

• 使用 -s 设置范围：用户级或项目级，必要时可按项目配置 MCP 服务。

• 使用以下命令管理已添加的 MCP 服务：

# 列出 MCP 服务
qoderclicn mcp list
# 移除 MCP 服务
qoderclicn mcp remove playwright

MCP 服务文件

已添加的 MCP 服务会保存在项目中的以下文件中。

# 为当前用户或特定项目添加，不会被提交。
.qoder-cn.json
# 为当前项目添加，通常会被提交。
${project}/.mcp.json

推荐工具

• qoderclicn mcp add context7 -- npx -y @upstash/context7-mcp@latest

• qoderclicn mcp add deepwiki -- npx -y mcp-deepwiki@latest

• qoderclicn mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

配置

Qoder CN CLI 通过三种核心策略进行权限控制：Allow、Deny 和 Ask。它们可与特定工具的规则组合，用于针对项目或用户进行更精细的访问管理。默认情况下，CLI 对于所选项目目录之外的文件访问采用更安全的"Ask"策略，同时在启动时会在项目目录内自动创建标准的读/写规则。所有策略均可完全自定义，以适配你的工作流程。

{
  "permissions": {
    "ask": [
      "Read(!/Users/qodercn_user/Documents/codes/go-micro/**)",
      "Edit(!/Users/qodercn_user/Documents/codes/go-micro/**)"
    ],
    "allow": [
      "Read(/Users/qodercn_user/Documents/codes/go-micro/**)",
      "Edit(/Users/qodercn_user/Documents/codes/go-micro/**)"
    ],
    "deny": []
  }
}

不同类型的配置规则

读取与编辑（Read & Edit） 读取规则适用于所有读文件的工具，如 Grep、Glob 和 LS。模式遵循 gitignore 风格的匹配。支持的模式形式包括：

WebFetch 限制网络抓取工具可访问的域名。

• WebFetch(domain:example.com) 将抓取限制为 example.com

Bash 限制 shell 执行工具可运行的命令。

• Bash(npm run build) 匹配与 npm run build 完全相同的命令

• Bash(npm run test:*) 匹配以 npm run test 开头的命令

• Bash(curl http://site.com/:*) 匹配以 curl http://site.com/ 开头的 curl 命令

创建任务

切换到目标代码仓库根路径，执行如下命令启动任务，启动成功后默认进入容器内 CLI 的 TUI。

qoderclicn --worktree "Your job description"

• 添加 -p 参数任务以非交互模式在容器中运行，任务结束后停止容器。

• 添加 --branch 参数指定任务工作的代码分支。

• 其他 Agent 相关参数（如 --max-turns），将会透传给容器内启动的 CLI 命令。

你可以打开多个终端启动多个任务，多个任务之间通过 Worktree 隔离。

查看任务

可以通过 Jobs 子命令查看当前代码仓库已经创建的并行任务，如下所示：

$ qoderclicn jobs --worktree
Qoder CN jobs for workspace: /Users/linus/qodercn/qoderclicn
Worktree Jobs:
ID              INIT PROMPT  PATH                                    STATUS   CREATED
11758283139787  [I] 你好     ~/.qoder-cn/worktrees/11758283139787       running  5 minutes ago
11758283382928  [N] 你好     ~/.qoder-cn/worktrees/11758283382928       exited   1 minute ago
11758283399820  [N] 你好     ~/.qoder-cn/worktrees/11758283399820       exited   1 minute ago
Total: 3 worktree job(s)

字段说明：

• ID：任务唯一标识（非容器 ID）

• INIT PROMPT：初始的任务描述（未来会改成 AI 自动总结的标题）

• PATH：git worktree 目录

• STATUS：与容器状态一致

• CREATED：任务创建时间

删除任务

使用 rm 子命令删除任务（本质上是删除任务所运行的 worktree）：

qoderclicn rm <jobId>

自动生成记忆

CLI 提供了自动生成记忆文件的功能，在目标项目中启动 TUI 并输入 /init 命令，CLI 会自动生成一个记忆文件，并保存在项目目录下，默认名称为 AGENTS.md。

手动编辑记忆

• 在项目中创建 AGENTS.md 并编辑其内容。

• 在 TUI 中输入 # 进入记忆编辑模式，使用类似 Vim 的方式编辑项目记忆文件。

• 在 TUI 中输入 /memory 以选择并编辑用户级或项目级的记忆文件。

手动创建

首先，在以下位置创建一个 Markdown 文件：

• ~/.qoder-cn/agents/<agentName>.md：用户级，适用于所有项目

• ${project}/agents/<agentName>.md：项目级，适用于当前项目

接着定义你的 Subagent，Subagent 的 Markdown 文件必须包含一个 frontmatter 区块，其中定义 name、description 和 tools 字段，以及主系统提示词（system prompt）。例如：

---
name: code-review
description: 代码审查专家，检查代码质量和安全性
tools: Read, Grep, Glob, Bash
---

你是一位资深代码审查员，负责确保代码质量。

审查清单:
1. 代码可读性
2. 命名规范
3. 错误处理
4. 安全性检查
5. 测试覆盖
...

自动创建

在 TUI 中输入 /agents。按 Tab 选择 User 或 Project，然后选择 Create new agent，并输入你希望自动创建的 Subagent 的描述。

使用 Subagent

在 TUI 模式下，使用命令 /agent 查看 Subagent。你可以显式或隐式地调用 Subagent 来完成任务。例如：

> 使用 code-review subagent 检查代码问题     # 显示调用
> 分析这段代码有没有潜在性能问题             # 隐式调用
> 审查这个接口的相关实现                     # 隐式调用
> 先使用 design subagent 完成系统设计，再使用 code-review subagent 继续完成代码review  # 串联调用

创建命令

将命令定义存放在：

• ~/.qoder-cn/commands/.md：用户级，适用于所有项目

• ${project}/.qoder/commands/.md：项目级，仅适用于当前项目

示例

按以下方式定义一个命令，并将其保存到 ~/.qoder-cn/commands/quest.md 中。

---
description: "Intelligent workflow orchestrator that guides users through feature development using specialized subagents"
---

先使用 design subagent 完成系统设计，再使用 code-review subagent 继续完成代码review

使用命令

在 TUI 模式下，输入 /quest 触发指令，命令执行过程中会按照提示词先后调用两个 Subagent 完成任务。