RooCode：Cline分支，结构化模式AI编程

为什么需要 RooCode：单线程对话写代码 → 多角色结构化协作

传统 AI 编程助手（包括第一代的 Cline 本身）采用「一个助手对话到底」的模式：你在一个对话框中同时完成需求分析、架构设计、编码、调试、测试，模型在同一套系统提示词下切换角色，上下文越长行为越不稳定，经常出现「写代码的模型突然开始给方案、做设计的模型突然动手改文件」的混乱。

RooCode 用「模式」解决这一问题。每个模式是一份独立的系统提示词 + 工具权限 + 模型配置组合：Architect 模式只允许读取代码和输出方案，没有写文件权限；Code 模式聚焦具体实现；Ask 模式只回答不改动代码。角色边界清晰后，模型行为可预期性显著提升，复杂任务的上下文不再互相污染。

与 Cline 相比，RooCode 的气质差异在于「流程化」：Cline 是自由度更高的全能助手，RooCode 则鼓励把 AI 编码拆成流水线工序。如果你的团队已经摸索出一套「先评审设计、再写代码、最后自测」的 AI 编程 SOP，RooCode 的模式系统能把这套 SOP 固化为工具逻辑，而非依赖每个人的口头约定。

安装与环境配置：3 步就绪

步骤一·安装扩展：在 VS Code 扩展市场搜索「Roo Code」，选择发布者为 RooCode 的扩展安装；或使用命令行安装。该项目是 Cline 的分支，扩展 ID 为 RooCode.roovet。

步骤二·配置模型提供商：打开 RooCode 面板，在设置中选择 API 提供商（Anthropic、OpenAI、Google Gemini、OpenRouter、Ollama、OpenAI 兼容端点等），填入对应的 API Key 或端点地址。本机已安装 Ollama 时可直接选择 Ollama 并使用本地模型，无需额外配置密钥。

步骤三·验证连通性：在面板中选择 Ask 模式，输入「你好，请简述你的工作方式」，返回正常即说明链路可用。若调用失败，检查 API Key 是否有效、余额是否充足，以及网络是否能访问对应端点。

# 通过命令行安装 Roo Code（VS Code 官方扩展市场）code --install-extension RooCode.roovet # 验证扩展已安装code --list-extensions | grep RooCode

快速上手：10 分钟跑通第一个编码任务

RooCode 的最小可用流程遵循「选模式 → 交代任务 → 审查变更」三步。打开编辑器右侧的 Roo Code 图标进入面板，首次使用先在设置中配置好模型提供商；然后从模式下拉框选择「Architect」（架构模式），输入一段需求描述（例如「为现有 Python 项目新增日志脱敏模块，输出设计方案」），Architect 模式会读取项目文件并返回设计文档，但不会写入任何代码。

确认设计方案后，切换到「Code」模式，把 Architect 的结论粘贴进去（或直接说「按刚才的方案实现」），Code 模式会起草具体代码文件并通过文件编辑请求逐项征求你的批准。检查通过后，可切换到「Debug」模式描述遇到的报错，由该模式定位并修复问题。全程 AI 不会在未经批准的情况下修改文件，Plan/Act 分离机制保证每步变更可控。

进阶技巧：在项目根目录创建 .roo/ 文件夹，把团队统一的模式配置、忽略文件（.rooignore）放入其中并提交到 Git，所有克隆该仓库的成员自动继承相同的 AI 行为规范。RooCode 在 3.x 版本中加入了 Roofs 功能，可让多个不同模式的子任务并行运行，适合拆解大型重构任务。

核心能力详解：4 大支柱

支柱一·模式系统（Modes）。RooCode 的核心创新。内置 Architect、Code、Ask、Debug 四种模式，每种模式拥有独立的系统提示词、可用工具集与文件操作权限。例如 Architect 不配备编辑工具，只能读文件、搜索、输出方案；Code 具备完整编辑能力但需要逐项审批。模式隔离避免了「一个提示词干所有事」带来的角色混乱。

支柱二·自定义模式（Custom Modes）。在项目根目录 .roo/modes/ 下放置 Markdown 文件即可定义新模式，文件名即模式名。模式文件中可配置 system prompt、工具权限（是否允许编辑/执行命令/读文件）、允许的文件类型、是否显示在模式切换器中。团队把编码规范、Commit Message 格式、安全清单写进自定义模式后，AI 行为即被约束到团队标准之内。

支柱三·Roofs 并行任务。3.x 引入的并发执行机制，允许同时运行多个独立任务流（例如一个模式做依赖升级、另一个模式补充测试用例）。Roofs 之间上下文隔离，避免互相干扰；适合仓库规模大、任务可拆分的场景。注意并行任务会成倍消耗 token，产生账单前需评估成本。

支柱四·BYOK 多模型接入与 MCP 生态。工具本体免费，模型通过自带 API Key 接入，兼容 Anthropic、OpenAI、Gemini、OpenRouter、Ollama 与任意 OpenAI 兼容端点，同一项目内可切换不同模型观察效果差异。同时支持 MCP（Model Context Protocol）服务器，可挂载外部数据源与工具，扩展 AI 检索内部文档、调用企业内部 API 的能力。

生产部署与监控：从上线到运维

团队级配置分发。将 .roo/ 目录（含自定义模式、.rooignore）纳入 Git 版本管理，配合分支策略实现 AI 编码规范的灰度发布：先在试点分支验证新模式的行为，再合入主分支。新成员克隆仓库后无需手动配置即可获得与团队一致的 AI 行为基线。

成本与安全治理。由于是 BYOK 模式，生产使用的核心是管好 API Key 与预算：通过 OpenRouter 或自建 API 网关统一代理请求，给不同成员分配虚拟 Key 并设置限额；在 RooCode 设置中开启任务转录（transcript）记录，便于审计 AI 执行了哪些命令、修改了哪些文件。禁止在 .roo/ 或代码仓库中提交明文 Key，应使用环境变量或密钥管理服务注入。

可观测性。RooCode 的任务运行过程会以转录形式记录在 VS Code 输出通道中，包含每次 API 调用、工具执行结果与 token 消耗。搭建每周 AI 编码成本报表（按成员、按模式维度统计 API 费用），可及时发现异常消耗——例如某成员长期在 Code 模式中让 AI 反复重写同一文件，或 Roofs 任务数超过合理阈值。结合 Git 提交记录与任务转录交叉核对，能定位质量问题的模式根源。

<p class=“para-label“>避坑清单：</p><ul class=”dash-list”><li>自定义模式不生效：模式文件必须放在项目根目录的 <code>.roo/modes/</code> 下（注意是「 modes 」复数），文件名不能含空格或中文，保存后需重新加载窗口才能被识别。</li><li>把 API Key 提交进仓库：.roo 目录会被 Git 跟踪，Key 写入设置文件后一旦提交即泄露；Key 应通过系统环境变量注入。</li><li>切换模型后行为不一致：不同模型对同一模式文件的遵循程度差异很大，团队内应固定「模式 + 默认模型」的组合，避免成员自行混用导致产出风格漂移。</li><li>Roofs 并行任务费用失控：并行执行会线性放大 token 消耗，大型项目拆任务前先预估每个子任务量级，必要时给 API 网关设置单日配额与告警阈值。</li><li>把 Architect 输出直接当最终设计：架构模式不会运行代码验证可行性，产物只是「建议」，仍需人工或 Code 模式落地验证。</li></ul>

版本迭代

RooCode 由社区开发者于 2024 年 10 月基于 Cline 创建分支（原名 Roo Cline），2025 年初随 2.0 大版本更名为 Roo Code 并重构自定义模式能力；3.x 引入 Roofs 并行任务与浏览器自动化，持续强化多任务编排能力（截至训练数据，可能已有更新版本）。

AI 应用场景

常见误区

面试题