Cline / Roo-Code / OpenCode 实战手册
最后更新：2026-09-01
怎么把这三个客户端连上 Coding-Plan，看 接入指南；通用操作流程看 标准工作流 SOP。本篇讲接上之后日常怎么用：界面在哪、模式怎么切、diff 怎么审、上下文怎么喂、三家怎么选。
三个客户端都接同一个云端大脑（ark-code-latest），差别在交互形态和编排能力。模型一样，产出差距主要来自你会不会用客户端的模式和上下文控制。
一、三兄弟的关系
- Cline：这一类工具的开山鼻祖，VSCode 扩展，交互克制、每步必审批，适合谨慎的大工程；
- Roo-Code：Cline 的功能增强分支，加了多模式（Code/Architect/Ask/Debug 等）、Boomerang 子 Agent、自定义模式，能力最全；
- OpenCode：另起炉灶的开源项目，终端 TUI + 编辑器扩展双形态，配置用
opencode.json，适合喜欢终端、要脚本化/CI 的人。
三者都用 OpenAI 兼容协议接 Coding-Plan（
/api/coding/v3）。Claude Code 走 Anthropic 兼容协议，单独有 完整教程。
二、通用核心操作（三家都一样）
不管用哪个，这几个动作是每天都要用的：
| 操作 | 怎么做 | 为什么重要 |
|---|---|---|
| 引用上下文 | 输入框里打 @，选文件/目录/符号（@src/auth/、@login()） | 主动指路，避免 Agent 满库 grep，省 token 少幻觉 |
| 审 diff | 每次写文件会弹出 diff 视图，逐块看改动 | 拦住夹带改动、误删；这是你最重要的把关动作 |
| 审批命令 | 终端命令弹出确认，危险命令（rm/push/装包）重点看 | 生产环境绝不开"自动批准命令" |
| 切换模式 | 在模式下拉里选 Ask / Plan(Architect) / Code | 只读分析 vs 动手改代码必须分开 |
| 中断/纠偏 | 任务跑偏时点停止，补一句方向再继续 | 防止发散空烧额度 |
| 看额度 | 状态栏/面板看本轮请求与套餐消耗 | Agent 一个任务几十轮，留意 Coding-Plan 额度 |
配置项层面的"自动批准"开关：Cline/Roo-Code 都有"自动执行命令/自动写文件"选项。建议全程关闭，至少在大型工程、生产代码库里关闭。
三、Cline：稳健派，逐步审批
定位：交互最克制，默认每一次文件修改、每一条命令都弹窗等你确认。适合芯片 EDA、C++ 大型工程这类"改错代价高"的场景。
日常用法：
- 侧边栏打开 Cline 面板，确认底部 Provider 是 OpenAI Compatible、模型是
ark-code-latest； - 输入任务，用
@把相关文件/目录贴进来； - 它先读文件、思考，然后逐步提出"要改这个文件 / 要跑这条命令"，你逐条 Approve；
- 每步看 diff，确认无误再放行下一步。
特点：没有花哨的多模式，就是"说任务→它一步步做→你一步步批"。这种单调恰恰是它在高风险场景的优点——每一步都在你眼皮底下。
四、Roo-Code：全能派，多模式 + 子 Agent
定位：Cline 的增强分支，能力最全。核心增值是多模式和子 Agent 并行。
4.1 模式怎么选
| 模式 | 能做什么 | 什么时候用 |
|---|---|---|
| Code | 读写文件、跑命令，完整 Agent 能力 | 明确要动手改代码时 |
| Architect | 只分析、出方案，不直接改，可把方案交给 Code 模式执行 | 复杂任务先规划（对应 SOP 第 2 步 Plan） |
| Ask | 只读问答，解释代码、回答问题 | 读代码、理解项目，不想它动任何文件 |
| Debug | 聚焦定位问题、复现验证 | 修 bug 时缩小授权范围 |
| 自定义模式 | 你可定义专属角色/工具权限 | 团队固化特定工作流 |
典型链路：Architect 出方案 → 你审阅 → 切 Code 执行，和 六步法 的"先 Plan 后 Act"完全对应。
4.2 子 Agent（Boomerang）
Roo-Code 可以派生子 Agent 去并行做子任务（例如同时让三个子 Agent 分别梳理三个模块），主 Agent 汇总结果。适合超大代码库的探索阶段。子 Agent 复用同一 Provider 配置，无需重复填 Coding-Plan 信息。子 Agent 的职责设计见 Agent vs Skill。
五、OpenCode：终端派，可脚本化
定位：开源，提供终端 TUI 和编辑器扩展两种形态，配置集中在 opencode.json。适合习惯终端、想在脚本/CI 里调 Agent 的人。
- 配置：Provider 写在全局或项目根的
opencode.json（字段见 接入指南 第四章），Key 走环境变量ARK_API_KEY； - 使用：终端里启动后进对话界面，
@引用文件、斜杠命令调功能；同一套配置在编辑器扩展里也生效； - 优势：终端原生、可在无头环境/管道里用，和 Claude Code 一样适合自动化场景，但它走 OpenAI 兼容端点、配置更透明。
想要 CI/CD 里非交互跑任务，终端派（OpenCode / Claude Code
-p）比 VSCode 扩展更合适。
六、三家横向对比与选型
| 维度 | Cline | Roo-Code | OpenCode |
|---|---|---|---|
| 形态 | VSCode 扩展 | VSCode 扩展 | 终端 TUI + 编辑器扩展 |
| 接入协议 | OpenAI 兼容 | OpenAI 兼容 | OpenAI 兼容 |
| 默认审批严格度 | 最严，逐步弹窗 | 可配，逐步审批 | 可配 |
| 多模式 | 较弱 | 最全（Code/Architect/Ask/Debug/自定义） | 基础 |
| 子 Agent 并行 | 无 | 有（Boomerang） | 有限 |
| 配置方式 | 扩展设置面板 | 扩展设置面板 | opencode.json 文件 |
| 终端 / CI 脚本化 | 不适合 | 不适合 | 适合 |
| 开源 | 是 | 是 | 是 |
| 最适合 | 高风险大工程、芯片/C++ | 超大项目、复杂任务、要并行 | 终端党、自动化、CI |
选型一句话：求稳用 Cline，求全用 Roo-Code，求终端/自动化用 OpenCode；已在 Claude 生态、要 Agent/Skill/钩子完整体系的，用 Claude Code（走 Anthropic 兼容端点）。
七、常见问题
| 现象 | 排查 |
|---|---|
| 客户端连不上 / 401 | Key 带了空格换行；Base URL 要 /api/coding/v3（见 接入指南排错章） |
| 套餐次数不掉、产生按量费 | 误用普通 /api/v3，改成 /api/coding/v3 |
| 模型报不存在 | 模型名填 ark-code-latest，不要填 ep-xxx |
| Agent 乱改文件 | 关自动批准、切 Ask/Architect 先分析、任务拆小（见 SOP） |
| 大库找代码慢、烧额度 | 挂 CodeGraph，用 @ 主动指路 |
| 三家里不知道模式怎么切 | Cline 模式简单；Roo-Code 在模式下拉；OpenCode 用斜杠命令 |
界面字段名可能随版本微调，若和你屏幕上的标签对不上，以客户端当前版本为准；配置端点/模型/Key 这三项是不变的核心。
相关文档
| 文档 | 内容 |
|---|---|
| 接入指南 | 三家 + Claude Code 的端点、模型、Key 具体填法 |
| 标准工作流 SOP | 接上之后从头到尾怎么用 |
| 我们的技术栈 | 这三个客户端在整体架构里的位置 |
| Claude Code 教程 | 终端 CLI 派的完整手册 |
| Agent vs Skill | Roo-Code 子 Agent / Skill 的职责设计 |
一句话总结
Cline、Roo-Code、OpenCode 接的是同一个云端大脑，差别在手感：Cline 像步步请示的稳健实习生，Roo-Code 像带团队的全能执行者（多模式 + 子 Agent），OpenCode 像住在终端里可脚本化的极客。 无论用哪个，核心动作不变：
@喂上下文、模式分清"只看"与"动手"、diff 逐条审、危险命令必批。