Qoder CLI 使用指南（入门版）
引言
在现代软件开发流程中，越来越多团队开始采用命令行工具和 AI 辅助来提升效率。 Qoder CLI 是 Qoder 平台推出的一款命令行界面工具，旨在让开发者直接在终端环境中使用自然语言生成代码、审查代码、自动化任务、管理记忆文件等。本文将从安装、使用、团队协作流程、实战案例等多个维度，带你快速掌握 Qoder CLI，并指导团队如何把它纳入日常工作流程。
一、为什么使用 Qoder CLI？
轻量启动：相比传统 IDE 插件，它无需复杂 UI 配置，直接在终端即可调用。
自然语言驱动：你只需用一句话描述需求，工具就可以生成代码、创建文件结构、甚至审查代码。
团队记忆 &规范共享：通过记忆文件（例如 AGENTS.md）保存团队规范、上下文信息，所有成员可共享。
多模式支持：除交互式模式外，还支持非交互脚本模式，方便 CI/CD 集成。
工具链集成：支持权限控制、子 Agent（Subagent）、工作树（Worktree）并行任务等高级功能，非常适合团队协作。
总之，Qoder CLI 是「在终端中就让 AI 成为开发助手」的工具，非常适合希望提升开发效率、统一团队流程的团队使用。
二、安装与初次登录
2.1 系统准备
确保你的开发环境为 macOS、Linux，或 Windows（建议用 Windows Terminal）即可。
2.2 安装方式
你可以选择以下任一方式安装：
# 通用方式（curl 脚本） curl -fsSL https://qoder.com/install | bash # macOS / Linux（Homebrew） brew install qoderai/qoder/qodercli --cask # npm 全局安装 npm install -g @qoder-ai/qodercli
安装完成后，运行：
qodercli --version
确认安装成功。
2.3 登录
在项目根目录中运行：
qodercli
首次启动将提示你登录账号。登录完成后即可使用 TUI 模式、非交互模式等功能。
三、基本使用模式
3.1 交互式 TUI 模式
在项目目录直接执行 qodercli，你会进入一个终端交互界面。
在该界面中，支持以下几种输入方式：
对话模式：直接输入自然语言，例如 “生成一个 Express API”。
斜杠命令模式：以
/开头输入内置命令，如/help。Bash 模式：在对话中输入
!+ shell 命令，如!ls。记忆模式：输入
#可将多行文本追加到团队记忆文件（AGENTS.md）。
3.2 非交互／脚本化模式
对于自动化脚本、CI/CD 流程，可以使用：
qodercli -p "生成一个使用 Express 的 API 服务" --output-format=json
-p参数：用于指定 prompt。--output-format：可选text|json|stream-json。
此模式适合无人工交互、自动执行的场景。
四、常用命令速查
在交互式 TUI 模式中，你可以输入以下斜杠命令来执行常见操作：
| 命令 | 功能说明 |
|---|---|
/login | 登录 Qoder 账号 |
/help | 显示帮助信息 |
/init | 在项目中初始化或更新 AGENTS.md 记忆文件 |
/memory | 编辑 AGENTS.md 记忆文件 |
/quest | 根据任务规格分配任务 |
/review | 审查本地代码改动 |
/resume | 查看／恢复指定会话 |
/clear | 清除当前会话历史上下文 |
/compact | 对当前会话进行摘要／压缩 |
/usage | 查看账户状态（Credits、模型使用情况等） |
/status | 查看 CLI 状态（版本、模型、工具状态） |
/config | 显示系统／用户／项目配置 |
/agents | 管理子 Agent（查看、创建、删除） |
/bashes | 查看当前后台运行的 Bash 任务 |
/release-notes | 显示 CLI 更新日志 |
/vim | 打开外部编辑器编辑当前输入 |
/feedback | 反馈 Qoder CLI 相关问题 |
/quit | 退出 TUI |
/logout | 注销当前账号 |
五、团队协作流程建议
5.1 记忆文件 （Memory）管理
在项目根目录建议建立 AGENTS.md 作为团队共享记忆文件。内容可以包括：
项目架构说明
团队开发规范
常用 Agent 定义
团队成员在 TUI 中输入#即可将内容追加到该文件，实现共享记忆。
5.2 子 Agent (Subagent)配置
对于反复任务（如代码审查、单元测试生成、迁移脚本等），建议预定义子 Agent。文件目录如：
project/ agents/ code-review.md unit-test-gen.md
每个 Agent 文件内容示例：
--- name: code-review description: 专注于代码质量审查和安全性检查 tools: Read, Grep, Bash --- 你是一位资深代码审查专家，负责检查代码质量、安全风险、规范一致性…
团队成员可直接调用这一 Agent 来执行任务，从而统一流程。
5.3 权限控制与工具策略
建议在项目目录下加入 .qoder/settings.local.json 并加入 .gitignore，以管理敏感配置。示例配置：
{
"permissions": {
"deny": ["Edit(src/config/production.json)"],
"allow": ["Read(src/**)", "Write(src/**)"]
}
}这样可防止 AI 不经意修改生产配置文件。
5.4 将 Qoder CLI 纳入开发流程
每位成员在本地环境安装 CLI 并登录。
在每次迭代开始时，通过
qodercli生成初始代码、任务文档。在 CI 流程或代码合并中，使用非交互模式自动执行代码生成或审查脚本。
团队会议中定期分享 CLI 使用心得、子 Agent 扩展经验。
六、实战案例：生成用户管理 API + 代码审查
案例背景
项目：用户管理服务（Node.js + Express）
目标：
通过 Qoder CLI 生成 GET /users 和 POST /users 接口，连接 MongoDB。
对已生成代码进行代码审查，提出优化建议。
操作步骤
初始化项目：
mkdir user-service && cd user-service npm init -y
生成接口代码：
qodercli -p "生成一个 Node.js + Express 的用户管理服务，包含 GET /users 和 POST /users，使用 MongoDB，遵循 ESLint 团队规范" --output-format=text
安装依赖并启动：
npm install express mongoose node index.js
引入代码审查：启动 TUI 模式执行：
qodercli # 输入 /review
工具将分析当前代码变更并提供建议，如性能、结构、命名、异常处理等。
将审查结果整理进 AGENTS.md 中，作为团队规范参考。
七、注意事项与最佳实践
虽然 Qoder CLI 功能强大，但建议它作为辅助工具，不应完全替代 IDE 或人工审查。
执行 AI 自动生成或改动前，务必在 Git 中做 commit／分支备份。
敏感或生产环境的配置文件，强烈建议加权限控制或设为 deny。
团队应定期维护 AGENTS.md 和子 Agent 清单，保持内容同步、规范有效。
在 CI 或自动化脚本场景使用非交互模式时，建议加入回退机制、防止误执行。
总结
如果你的团队希望在“终端+自然语言+AI”这一趋势中抢占效率优势，那么 Qoder CLI 是一个非常值得引入的工具。从快速生成代码、统一规范、自动审查，到脚本化流程、团队记忆共享，它都提供了丰富能力。配合本文中的安装、使用、团队流程及案例，你即可带领团队快速进入状态。期待你们在开发中取得更高效率、更优质的代码成果！
