Qoder CLI——在终端里用自然语言驱动 AI 编程
Qoder CLI 是什么
Qoder CLI 是 Qoder 品牌下的 命令行 AI 编程助手——把 AI 编程能力直接带进你的终端。不需要离开命令行，就可以：
- 让 Qoder 理解整个代码库；
- 用自然语言描述需求，让它自己规划步骤；
- 读文件、改代码、跑命令、搜资料；
- 完成从探索到提交的完整开发流程。
一句话理解
| Qoder IDE | Qoder CLI |
|---|
| GUI 桌面端 | 终端命令行 |
| 有编辑器 | 没有编辑器，用你自己的编辑器 |
| 适合喜欢图形界面的开发者 | 适合终端工作流、Vim/Neovim 用户、CI/CD 集成 |
运行机制
Qoder CLI 的核心是一个 Agent——接收你的请求，规划步骤，调用工具完成任务，并在过程中不断根据结果调整策略。四个要素协同：
| 要素 | 说明 |
|---|
| Agent | 理解意图、规划步骤、决定下一步动作 |
| 工具 | Agent 通过工具与项目和环境交互（读写文件、执行命令、搜索代码） |
| 权限 | 执行有副作用操作前根据权限设置请求确认或自动放行 |
| 上下文 | 对话历史 + 项目说明（AGENTS.md）+ 长期记忆 |
内置工具
| 工具类别 | 具体能力 |
|---|
| 代码理解与生成 | 查询编辑大型代码库、跨文件理解结构、多模态输入（图片/PDF）、自然语言描述缺陷 → 定位修复 |
| 文件操作 | 文件读写与编辑、目录浏览 |
| 命令执行 | Shell 命令执行（可配置自动放行的命令） |
| 代码搜索 | Grep（全文搜索）、Glob（文件查找） |
| 信息检索 | Web 搜索与网页抓取 |
| Git 操作 | 提交生成、改动审查、PR 处理 |
| MCP 扩展 | 接入 MCP 服务和自定义工具 |
多种工作方式
同一个任务可以有不同的完成方式，Qoder CLI 提供多种模式：
| 模式 | 说明 | 适用场景 |
|---|
| 交互模式 | 边聊边做 | 最常用的默认方式 |
| Plan 模式 | 先规划再执行 | 想先确认方案再动手 |
| Goal 模式 | 持续完成目标 | 设定完成条件，让 Qoder 一直工作直到达成 |
| 定时任务 | 指定时间运行一次，或按日历计划重复 | 自动化运维、定时报告 |
| /loop | 按固定时间间隔重复运行 | 监控类任务 |
| Headless | 非交互模式，输出结构化结果 | 脚本中调用、CI/CD 集成 |
Headless 模式——CI/CD 集成
Qoder CLI 的 Headless 模式可以在非交互环境（如 GitHub Actions）中运行：
- 输入自然语言目标；
- Qoder 自动执行；
- 输出结构化 JSON 结果；
- 脚本可以读取结果决定下一步。
这意味着你可以把 AI 能力嵌入自动化流水线——比如 PR 自动审查、自动生成 changelog、自动修复 lint 问题。
可扩展性
| 扩展机制 | 说明 |
|---|
| Skills | 可重复执行的工作方法 |
| Plugins | 功能插件 |
| Subagents | 子智能体调度 |
| 钩子 | 自定义事件触发 |
| 自定义命令 | 添加 CLI 子命令 |
| 记忆 | 跨任务保留的偏好和约定 |
| 知识库 | 团队知识沉淀 |
适用场景
| 场景 | CLI 优势 |
|---|
| 理解陌生代码库 | 在终端里快速探索，不打断你的终端工作流 |
| 实现功能 / 修复缺陷 | 从需求到编码到验证，全在终端里完成 |
| 重构与批量修改 | 跨多个文件的一致结构调整 |
| 日常研发自动化 | 生成 commit message、审查改动、处理 PR |
| CI/CD 集成 | Headless 模式嵌入自动化流水线 |
| Vim / Neovim 用户 | 和编辑器无缝衔接 |
下一步