大家好，我是晞木，来自 Qoder 团队，主要负责 CLI 产品的技术研发。今天我想和大家分享我们 Qoder 产品家族中的一款智能终端工具 —— Qoder CLI。
我们的核心理念很简单：把 Qoder 的智能能力带到每一个终端里。无论你是在本地开发，还是在远程服务器上调试，我们都希望 AI 能成为你终端里的得力助手。
也许有些朋友已经用过类似的产品，比如 Gemini CLI 或 Claude Code；也有些朋友可能第一次听说“终端智能”这个概念。没关系，接下来我会从 Qoder CLI 是什么、怎么用、以及背后的设计思路几个方面，带大家快速了解它。
Qoder CLI 是什么？
Qoder CLI 是一个结合了 AI 能力的命令行工具。你可以用自然语言告诉它你想做什么，比如“帮我修复这个模块的 bug”或者“写一个数据清洗脚本”，它就会理解你的意图，并自动完成相应的开发任务。
虽然它运行在终端里，但体验其实和你在 IDE 中使用 AI 编程插件很像——你输入任务描述，AI 会以流式方式逐步反馈思考过程和执行结果。不同的是，Qoder CLI 更轻量、更灵活，能运行在任何支持命令行的环境中。
它和 IDE 有什么区别？
Qoder IDE 提供了完整的图形界面，适合深度开发场景，比如项目管理、可视化编辑、多轮对话等。而 Qoder CLI 则主打轻量与自动化。
举个例子：你可以在一台云服务器上一键安装 Qoder CLI，然后直接给它下达任务，比如“分析日志并生成报告”。它可以在后台默默执行，完成后通过通知告诉你结果。这种“黑屏运行”的能力，特别适合运维、批处理或 CI/CD 场景。
两者技术底座相似，但定位不同：IDE 重交互，CLI 重效率与集成。
我们面临的核心挑战
在设计 Qoder CLI 时，我们重点思考了三个问题：
如何真正提升开发效率？
不只是“能用”，而是要“好用”——让 AI 真正理解上下文，减少反复沟通。如何降低使用门槛？
很多人觉得命令行难上手，所以我们做了 TUI（终端用户界面）和 Slash 命令，让操作更直观。如何无缝融入现有工作流？
支持 headless 模式、管道、脚本调用，确保它不会打乱你已有的开发习惯。
为此，我们从零自研了整个架构，没有依赖现成的 Agent 框架，就是为了做到极致轻量——启动快、资源占用低，还能灵活扩展。
怎么使用 Qoder CLI？
我们提供了两种使用方式：
1. 交互模式（TUI）
打开后你会看到一个分三块的界面：
上方是消息区：展示你和 AI 的对话流；
中间是输入框：你可以输入自然语言，也可以用
/ 快捷命令（比如 /memory 编辑记忆文件）；底部是状态栏：显示当前使用的模型、加载的 MCP servers、上下文占比等。
2. 非交互模式（Headless）
直接在命令行里一句话下达任务，比如：
qodercli -p "生成一个 API 接口文档" --output-format=json结果可以输出到文件，或通过管道传给其他工具。非常适合自动化脚本。
关键功能亮点
✦ 记忆机制（AGENT.md）
这是提升 AI 表现的关键。AGENT.md 文件相当于 AI 的“项目笔记”，记录工程结构、编码规范、常见坑点等。你可以手动编辑它，告诉 AI：“我们这个项目里，用户服务都在 /svc/user 目录下，错误码统一用 4001 开头”。
配置好之后，AI 在执行任务时就能更精准地定位文件、遵循规范，减少试错，也节省 Token。
✦ 上下文管理
多轮对话会让上下文越来越长，AI 可能“变笨”。我们提供了：
/compact：让 AI 自己总结当前上下文，保留核心信息；
/clear：清空当前会话；
/resume：切换到另一个任务的上下文。
这些命令让你灵活控制对话状态。
✦ Slash 命令体系
我们内置了几十个 / 命令，分为三类：
上下文管理：如
/memory、/compact扩展管理：如
/agent（自定义智能体）、/mcp（管理mcp servers）特色能力：如
/quest（启动spec驱动的任务）、/review（一键代码审查）
你还可以通过 /config 进入交互式配置面板，调整主题、自动压缩策略、隐私协议等。
✦ 自定义命令与子智能体
- 自定义命令：用 Markdown 写一个任务说明，比如“如何部署测试环境”，AI 就能按步骤执行。门槛低，泛化强。
- 子智能体（Sub-Agent）：主 Agent 遇到复杂任务时，可以“派活”给专门的子 Agent。比如修复 bug 时，调用一个专精于错误诊断的子智能体。子任务的上下文完全隔离，不会污染主会话。
工具与扩展能力
Qoder CLI 内置了文件读写、网络请求、Bash 执行等基础工具，还支持通过 MCP 协议接入外部服务（比如私有 API、数据库工具等），突破安全或成本限制。
另外，我们还引入了 Hooks 机制：
在任务开始前插入逻辑，比如检测敏感词；
在需要用户授权时（如访问敏感文件），自动推送通知；
任务完成后，也能通过 Hook 发送完成提醒。
这样即使你离开终端，也不会错过关键节点。
配置体系：企业 → 用户 → 项目
所有配置（记忆文件、命令、子智能体等）都以 Markdown 形式存储，支持三级覆盖：
企业级：统一公司规范、SOP 流程；
用户级：个人偏好，存于
~/.qoder/；项目级：特定仓库配置，存于项目根目录
.qoder/。
优先级从高到低，方便团队统一管理，也保留个人灵活性。
特色场景能力
全平台支持
无论是 Windows、macOS、Linux，还是 Docker、K8s，甚至沙箱环境，Qoder CLI 都能运行。还支持 worktree，多个任务互不干扰。
智能代码审查
/review：审查本地未提交的代码；
/pr-review：拉取 GitHub PR 进行审查；
/setup-github：一键为仓库配置云端自动审查，结果直接评论到 PR 页面。
Quest 模式
当你有一个模糊想法时，可以用 /quest 启动结构化开发流程：
AI 会先和你多轮确认需求；
生成一份
task.md 设计文档；确认无误后，自动执行开发。
我们也集成了OpenSpec、Speckit 等开源框架，你安装后可以直接在CLI里使用它们的能力。
实际应用场景
快速验证想法：想到一个点子？打开终端，一句话让它实现，不用开 IDE。
嵌入自动化流程：在 CI/CD 中调用 CLI 自动修复代码、生成文档。团队协作提效：新人加入时，用 CLI 自动生成项目文档；统一AGENT.md 确保代码风格一致；自动识别技术债务并建议重构。
团队协作提效：新人加入时，用 CLI 自动生成项目文档；统一
AGENT.md 确保代码风格一致；自动识别技术债务并建议重构。
总的来说，Qoder CLI 不是一个炫技的玩具，而是我们为开发者打造的一个轻量、可靠、可嵌入的终端智能伙伴。它足够小，却足够聪明；足够简单，却能应对复杂任务。
如果你感兴趣，欢迎访问我们的官网体验，也欢迎加入社区一起交流！
谢谢大家。
