Roo Code

Roo Code 是一款免费开源的 VS Code 扩展，可将多代理 AI 开发团队直接引入您的编辑器。它基于 Cline 代码库构建，采用 Apache 2.0 协议发布，允许您连接来自 Anthropic、OpenAI、Google Gemini、OpenRouter、AWS Bedrock 或本地模型提供商的自有 API 密钥。您的项目文件始终保留在本地机器上；Roo Code 从不通过自有服务器路由代码。该扩展在 VS Code 市场达到了 300 万次安装和 23.8k 个 GitHub 星标，随后创始团队于 2026 年 4 月宣布归档该项目，以追求新的基于云的发展方向。截至 2026 年 5 月，一个社区团队正在维护该代码库，而 Kilo Code（一个直接的分支）则继续为需要受支持的继任者的用户提供活跃的开发更新。

让 Roo Code 成为高级用户首选的核心功能包括：基于角色的模式（Role-based modes），可在每个阶段限制 AI 的操作权限（Architect 用于规划，Code 用于实现，Debug 用于根本原因分析，Orchestrator 用于多代理委派）；基于差异的编辑（Diff-based editing），仅重写更改的代码行而非整个文件，与全文件重写工具相比，API 成本降低了约 30%；自定义模式（Custom Modes），允许团队定义具有特定工具权限的专属 AI 角色；Boomerang 任务，将大型工作分解为独立的子任务，每个子任务都有自己的上下文窗口；以及支持连接外部工具的 MCP 服务器。该扩展支持任何提供 OpenAI 兼容 API 的模型，使其比 Cursor 或 Windsurf 等大多数闭源竞品具有更广泛的兼容性。

2026 年初的 Roo Code 实际功能

Roo Code 作为自主代理在 VS Code 侧边栏中运行。您可以用自然语言描述任务，代理会读取文件、写入差异、运行终端命令并汇报结果，在执行每个关键操作前都会请求批准。审批模式是可配置的：严格（批准每次写入）、宽松（自动批准读取和终端命令），或针对特定模式完全自动化。

模式系统是大多数用户认为 Roo Code 对 AI 编程工具领域的决定性贡献。当您开启新会话时，需要选择一种模式。Architect 模式会激活以规划为导向的提示词，并完全禁止代码写入，因此您可以进行高层级的设计对话，而不必担心代理意外修改文件。Code 模式支持多文件编辑和终端访问。Debug 模式优先进行根本原因追踪。Orchestrator 模式基于早期的社区概念 Boomerang Mode 构建，它将大型任务分解为子任务：父任务暂停，子任务在不同模式（例如 Code）下启动，运行至完成后，向父任务返回摘要。父任务永远不会看到完整的实现细节，只接收摘要，从而避免其上下文窗口被填满。

自定义模式（Custom Modes）于 2026 年 2 月 12 日在 v3.2.0 版本中发布（该版本同时将扩展名称从 Roo Cline 更改为 Roo Code），允许团队在内置模式之外定义自己的角色。例如，“安全审查模式”可能只有只读工具访问权限，并预载了贵公司的安全策略提示词。“迁移模式”可能包含有关要避免的旧框架的特定规则。团队可以通过社区 Mode Gallery 发布和共享模式，该画廊已发展出数十种经过预先测试的配置，适用于 API 脚手架和测试生成等常见工作流。

差异编辑系统在 v2.1（2025 年 2 月）中作为实验性功能引入，并在随后的版本中逐渐稳定，它是降低 Token 成本的真正差异化优势。对于一个包含 10 行更改的 500 行文件，使用 Claude Sonnet 时，Roo Code 的搜索/替换差异方法每次编辑成本约为 $0.0003。而重写整个文件的 Cline，相同更改的成本约为 $0.0075。在跨越数十个文件的大型重构中，这能节省相当可观的费用。

“我尝试过 Cursor、Windsurf、Cline、Trae 等工具，虽然将 RooCode 与 OpenRouter 结合使用成本更高，但它的效率也高得多。” - 首席架构师，SourceForge 评论，2025

“功能丰富，几乎每天都有新更新，Discord 中有一个庞大的社区，并提供大量可用信息。” - 首席架构师，SourceForge 评论，2025

Roo Code 与 Cline 和 Aider 的定位对比

与它的上游父项目 Cline 的对比是社区中最常见的问题。两者都采用 Apache 2.0 协议，都支持自带模型（BYOM），并且都在 VS Code 内运行。两者的区别在于架构和理念。

Cline 使用“计划与执行”（Plan-and-Act）管道：它在启动时索引整个存储库以构建文件关系映射，然后在修改任何内容之前生成有序的执行计划供您批准。这使得 Cline 在大型代码库上具有更强的跨存储库推理能力（无需使用 @file 标记手动指定上下文）。Cline 还拥有用于终端工作流的 CLI 2.0、通过 Computer Use 实现的完整浏览器自动化，以及更成熟的企业功能集，包括 SSO、RBAC 和正式的 SOC 2/GDPR 文档。凭借 58k 个 GitHub 星标和超过 500 万次安装，它拥有庞大得多的安装基础。代价是：Cline 的迭代更为保守。Roo Code 几个月前就发布的特性（差异编辑、自定义模式）花了更长时间才在 Cline 中落地。

Roo Code 则走向了另一个方向：发布速度更快，更愿意进行实验，采用基于模式的架构而非单体式规划。上下文是显式的：您使用 @file 和 @dir 标记告诉 Roo 要查看哪些文件。这使操作范围仅限于您指定的内容，对于完整索引成本高昂的大型单一代码库（monorepo），一些开发者更倾向于这种方式。差异编辑降低了 Token 成本。与 Cline 简单的计划/执行切换相比，自定义模式赋予了团队更多的工作流控制权。代价是：前期需要更多配置，且稳定性表现参差不齐。

Aider 则完全属于另一个类别。它在终端中运行，而不是在 VS Code 内，并将 Git 视为一等公民：AI 的每一次更改都会自动提交并附带描述性消息，让您可以使用标准的 git diff、log 和 revert 命令来管理 AI 的输出。对于希望在不知不觉中获得完整审计跟踪的开发者来说，这非常实用。Aider 基于 Python，拥有超过 44k 个 GitHub 星标（几乎是 Roo Code 的两倍），开发历史更长（始于 2023 年左右），在终端优先的开发者中拥有很高的采用率。它所没有的是：图形化侧边栏、基于角色的模式、可视化审批流，以及 Roo Code 通过 Boomerang 任务构建的那种多代理编排。选择在很大程度上取决于工作流：如果您习惯在终端中工作并希望保持干净的 git 历史记录，Aider 正是为此而生。如果您想要一个带有基于模式的控制和可视化对话界面的 VS Code 侧边栏代理，Roo Code（或其后续分支）更适合。与不支持 BYOM 或自定义代理角色的 GitHub Copilot 等闭源选项相比，两者都具有明显优势。

代理循环的实际体验

Atomic Object 的开发者 Gage Vander Clay 在 2025 年 3 月写下了一篇关于他采用 Roo Code 的真实记录。他的开场白是：“当我第一次尝试它时，我很难从中获得任何真正的价值。我退回到了我熟悉的方式：自己写代码。”在熟悉该工具后，他最终的工作流始终是从 Architect 模式开始制定实现计划，然后切换到 Code 模式进行执行。他将任务范围保持在较小规模（“LLM 提供的响应质量与输入的大小成反比”），保留手动写入批准以捕获死循环，并使用 Checkpoints 回滚糟糕的编辑。他还补充了一个适用于任何自主编程工具的警告：“我不建议让 Roo 去做任何你自己都不知道怎么做的事情。”

最后一点抓住了大多数高级用户使用 Roo Code 的核心体验。该工具放大了您已有的知识。它能很好地处理样板代码、多文件重构、测试生成和重复性的实现工作。当开发者无法评估其输出、代码库对于所选模型的上下文窗口来说太大，或者任务需要难以预先指定的判断时，它就会显得力不从心。

Boomerang/Orchestrator 模式改变了大型任务的计算方式。您无需给代理一个包含 20 个步骤的简报，然后眼睁睁看着它在执行到一半时耗尽上下文，而是给 Orchestrator 一个高层级目标。它会提出子任务分解方案供您批准。每个子任务都在自己干净的上下文窗口中独立运行，然后返回摘要。父任务将结果拼接在一起。这种由 Roo Code 普及并随后被包括 Kilo Code 在内的多个分支采用的模式，对于长达一周的重构或全功能构建非常实用。它还扩展到了通过 MCP 与外部工具的配对：Boomerang 子任务可以调用 MCP 服务器进行数据库查询、网页抓取或 API 调用，并将结构化结果返回给父任务。

Roo Code 适合哪些人群

Roo Code 专为希望最大程度控制其 AI 编程工作流而无需支付 SaaS 订阅费用的经验丰富的开发者而构建。理想的用户已经了解如何管理 API 密钥，对不同任务该使用哪种模型有自己的见解，并且能够审计代理生成的差异代码。符合这一描述的团队报告称，在重复性或样板代码繁重的工作中，生产力得到了显著提升。

它也适合需要在物理隔离（air-gapped）或隐私敏感环境中运行 AI 工具的开发者。由于 Roo Code 仅将数据发送给用户配置的模型提供商（没有任何数据会通过 Roo 自己的服务器路由），注重安全的团队可以将其指向本地的 Ollama 实例，并将所有内容保留在本地。.rooignore 文件允许您将敏感路径排除在代理的视图之外，类似于 .gitignore。

希望在源代码级别自定义工具的开源贡献者和团队也会发现 Roo Code 是一个自然的选择。其 Apache 2.0 许可证意味着您可以对其进行分叉、修改并在内部运行。几家公司在 Roo Code 代码库的基础上构建了内部工具。社区的 Mode Gallery 展示了当定制变得容易时会发生什么：在几个月内就积累了数百个针对特定技术栈和工作流的预测试配置。

Roo Code 不适合哪些场景

Roo Code 不是一款适合初学者的工具。其配置范围（模型选择、模式设置、上下文管理、Token 预算）需要开发者具备一定的经验。对于希望打开工具就能获得建议而无需配置的用户，GitHub Copilot 或带有默认设置的 Cline 扩展会是更好的选择。

它不是一项完全托管的订阅服务。没有团队仪表板，没有使用情况分析，也没有计费门户。API 成本直接计入您连接的任何帐户。如果您需要可预测的月度计费和供应商支持，Cursor 或 Continue.dev Pro 会更合适。

它不是一款终端工具。希望使用带有自动 git 提交的 CLI 优先工作流的开发者应该使用 Aider。Roo Code 需要 VS Code 或兼容的分支才能运行。

截至 2026 年 5 月 15 日，原始存储库已归档。新用户应评估 Kilo Code（最活跃的分支）。正如 Cline 首席执行官 Saoud Rizwan 所言，Cline 现在整合了 Roo Code 的许多贡献：“他们进行了创新，建立了一个令人难以置信的社区，并且对 Cline 的贡献超过了任何人。”