Roo Code

Roo Code是什么？

Roo Code是一款运行在Visual Studio Code中的开源AI编程代理，前身与Cline生态有关，当前由Roo Code团队独立维护。它把大语言模型接入编辑器，让用户用自然语言分析项目、修改多文件、执行命令、调试错误和拆分复杂任务。

Roo Code不是一个自带固定模型的聊天插件。扩展负责代理工作流、工具、上下文和编辑，推理由Roo Router、外部模型API、云网关或本地模型提供。

多文件代码编辑

Roo可以读取项目文件、搜索代码、创建新文件并应用精确修改。每次工具调用都会在对话中展示，用户可审阅差异、保存或拒绝一组编辑。

跨文件修改适合新增功能、接口迁移、测试补齐和重构，但模型可能改变无关代码。任务应写明目标目录、禁止修改项和验收命令。

终端命令执行

代理可以在VS Code终端运行安装、构建、测试、Lint和Git命令，并根据输出继续修复。用户可逐次批准，也能为特定动作配置自动批准。

自动批准会放大误操作风险。不要对删除、部署、包管理器脚本和含生产凭据的命令开放无限权限，建议设置连续请求上限。

Code模式

Code模式面向常规实现任务，允许读取、编辑和执行命令，适合直接开发功能、修复Bug与重构。它通常拥有较完整的工程工具权限。

需求不明确时不要直接进入Code模式。先用Ask或Architect确认范围，可以减少反复修改和模型费用。

Architect模式

Architect模式偏向理解代码库、设计方案、拆分任务和评估技术选择，默认限制直接写代码的能力。当前版本会智能选择搜索和上下文工具，包括可用的语义检索。

架构建议仍需结合项目限制、团队经验和真实性能数据。完成方案后可切换到Code模式实施。

Ask与Debug模式

Ask模式用于解释代码、回答技术问题和阅读项目，不以写入为中心；Debug模式则帮助分析日志、错误栈、运行结果和可能根因，并提出或执行验证步骤。

调试时应提供最小复现、实际错误和环境版本。让模型在缺少证据时直接改代码，容易掩盖真正原因。

自定义模式

用户可以创建自定义模式，定义角色说明、工具权限、文件范围和专属指令，例如安全审查、测试工程师、React组件、文档作者或只读Reviewer。项目级模式可与仓库一起共享。

自定义模式应遵循最小权限，只开放任务所需工具。过长或互相冲突的指令会降低模型执行稳定性。

任务拆分与子任务

Roo能够创建子任务并指定模式，让复杂任务按研究、规划、实现和测试阶段推进。历史视图可显示递归子任务树，帮助用户查看委派链路。

多层委派会增加模型调用、上下文切换和状态丢失风险。每个子任务都应有清晰输入、输出与停止条件。

Todo列表

复杂任务可使用Todo列表记录待办、进行中和已完成步骤，减少长会话中遗漏工作。代理会结合列表继续推进。

Todo状态只是代理记录，不是测试通过证明。最终仍要以代码差异、构建、测试和运行结果验收。

Checkpoints检查点

Roo使用独立的影子Git仓库为工作区创建快照，不依赖项目主Git历史。用户可比较或恢复检查点，适合尝试不同方案和撤销不满意改动。

检查点会跟踪工作区文件，和限制AI读取的rooignore规则相互独立。大型仓库、缓存与Git LFS内容应配置排除，检查点也不能替代正式版本控制和备份。

代码库索引

代码库索引通过嵌入和Qdrant向量数据库建立语义检索，帮助代理在大型项目中找到含义相关的实现。首次索引成本较高，后续增量更新通常更便宜。

该功能需要嵌入模型密钥和Qdrant，并会额外产生存储与推理成本。敏感代码应确认向量数据库位置和访问权限。

上下文引用

用户可用引用语法加入文件、文件夹、终端、错误列表和其他项目信息，避免模型猜测。API配置文件还能为不同任务选择不同提供商、模型和参数。

加入整个文件夹会快速扩大上下文。优先提供接口、错误和相关文件，避免把无关数据与密钥发送给模型。

MCP外部工具

Roo Code支持Model Context Protocol，可连接数据库、API、文档、浏览器自动化和自定义脚本。MCP服务器可以在全局或项目配置中管理，工具可单独启用、禁用和审批。

MCP服务器在本机或远程执行实际操作，安装前要审查来源、命令、网络和密钥权限。项目配置不应包含明文令牌。

浏览器自动化变化

早期Roo Code内置Puppeteer浏览器工具，可打开网页、点击和截图。自3.48版起，该内置浏览器工具已被移除，当前应通过Playwright或其他MCP服务器实现浏览器操作。

旧教程中的browser_action和内置会话面板已不再适用于新版本。浏览器MCP同样需要审批并防范网页中的恶意提示。

Marketplace市场

Roo Marketplace提供经过整理的MCP和模式，用户可安装到当前项目或全局环境，用于扩展框架开发、文档、数据库和自动化能力。

被收录不等于没有安全风险。安装后应查看生成的配置文件、依赖与工具权限，并锁定可复现版本。

支持的模型提供商

Roo Code支持Anthropic、OpenAI、Amazon Bedrock、Google Vertex AI、Gemini、DeepSeek、Moonshot、Mistral、OpenRouter、Requesty、Vercel AI Gateway、xAI、Z AI、LiteLLM以及OpenAI兼容服务等。

提供商名单会随版本增删。3.48版已经移除部分低使用率的内置配置表单，原有凭据会保留但需要迁移到其他网关或兼容接口。

Roo Code Router

Roo Router提供免手工配置多个API密钥的模型入口，用户充值额度后选择可用模型，推理按模型Token与当前路由价格消耗。它适合希望快速开始和统一账单的用户。

Router不是固定月费无限使用。实际费用受模型、上下文、缓存、推理Token和任务调用次数影响，最终账单以账户明细为准。

自备API密钥

用户可以直接连接Anthropic、OpenAI、OpenRouter、Bedrock、Vertex等账户，由对应提供商收费。API配置文件支持为不同模式保存不同模型、基础地址和速率限制。

密钥存入VS Code Secret Storage，不以明文显示，但导出、同步和插件环境仍需谨慎。不要在仓库配置中提交令牌。

本地模型

Roo支持Ollama和LM Studio，可在本机或自有服务器运行模型，减少代码发送到第三方云端。Ollama配置会读取模型自身上下文窗口。

代理依赖可靠的原生工具调用，普通聊天模型或不完整OpenAI兼容接口可能无法工作。长上下文本地模型还需要较大内存和显存。

VS Code模型API

实验性的VS Code Language Model API允许Roo使用GitHub Copilot或其他扩展提供的模型。可用模型、配额和价格由上游扩展决定，Roo无法直接控制成本。

该接口仍可能变化，不适合在未测试的情况下作为团队唯一模型来源。

成本显示与限制

Roo会在对话历史中显示输入、输出、缓存和部分推理Token的估算费用。用户可设置自动批准的最大连续请求数，在达到上限时暂停并重新确认。

显示金额只是估算，最终以提供商账单为准。减少无关上下文、拆分任务、使用缓存和按难度选择模型可以控制成本。

Roo Code CLI

项目还提供实验性Roo CLI，可在终端发起任务、恢复会话和传递任务配置。当前预发布版本要求Node.js 20及以上，主要提供macOS Apple Silicon和Linux x64、ARM64构建。

CLI仍在快速变化，部分版本默认自动批准工具与命令，生产使用前应检查当前参数并明确开启人工批准。

安装方式

最常用方式是在VS Code扩展市场安装Roo Code，打开侧边栏后选择模型提供商并配置密钥。也可从官方GitHub Release下载VSIX进行离线或受控部署。

企业应固定扩展版本、审查更新说明并通过VS Code策略统一配置。版本升级可能移除工具、提供商或改变审批行为。

Roo Code价格

VS Code扩展本身免费，没有必须购买的固定Pro订阅。使用外部API时按模型提供商价格结算；Roo Router则采用额度和按用量扣费；本地模型需要自行承担硬件与运维成本。

旧Cloud套餐和促销模型信息变化较快，当前官网已更多转向自托管云代理Roomote。购买前应以账户内实时模型单价和新产品页面为准。

Roo Code Cloud与Roomote

Roo团队的云端代理方向正在演进为Roomote，它是可自托管、模型无关的工程队友，可连接仓库、Issue、监控和数据系统，在隔离环境中执行任务并返回PR与预览。

Roomote与本地Roo Code扩展不是同一产品。其代码采用延迟转Apache 2.0的Fair Core许可证，不能把它误标为与Roo Code扩展相同的纯Apache开源授权。

GitHub与开源状态

Roo Code扩展官方仓库采用Apache License 2.0，源码、Issue和Release公开，允许按许可证使用、修改和分发。项目主要使用TypeScript开发。

扩展开源不代表连接的Claude、GPT、Gemini等模型开源，也不代表Roo Router推理免费。云端Roomote有独立许可证。

隐私与安全

Roo会处理用户提供的代码、提示、终端输出和工具结果，并发送给选定的模型提供商。项目提供可选遥测和rooignore文件限制AI读取范围。

忽略文件不能阻止检查点保存相同文件，也不能替代操作系统权限。企业应同时设置模型数据政策、MCP允许列表、网络控制和秘密扫描。

适合哪些用户？

• 希望在VS Code中使用代理式编程的开发者；
• 需要自由切换Claude、OpenAI、Gemini和本地模型的用户；
• 想用不同模式控制规划、实现与调试权限的团队；
• 需要MCP连接数据库、文档和浏览器工具的高级用户；
• 重视开源、检查点和可配置审批流程的工程师。

产品优势

• Apache 2.0开源并保持模型无关；
• 模式、子任务和工具权限配置灵活；
• 支持多文件编辑、终端、索引与检查点；
• MCP和Marketplace扩展外部能力；
• 支持云API、路由器和本地模型；
• 可显示Token与成本并限制自动调用。

限制与注意事项

Roo功能多、设置复杂，对完全不懂模型API和权限的新手有一定门槛。模型与MCP费用可能因长任务迅速增加。

自动批准、实验性CLI和外部MCP都可能执行危险操作。应使用Git分支、最小权限、请求上限、测试和人工审查。

常见问题

Roo Code免费吗？

扩展免费开源；模型API、Roo Router额度和本地硬件由用户承担费用。

Roo Code支持Claude吗？

支持Anthropic直连，也可通过Bedrock、Vertex、OpenRouter和其他网关使用Claude。

Roo Code支持本地模型吗？

支持Ollama和LM Studio，但模型必须可靠支持原生工具调用。

Roo Code有浏览器功能吗？

新版已移除内置浏览器工具，需要安装Playwright等MCP服务器实现浏览器自动化。

Roo Code支持MCP吗？

支持，可在全局或项目范围配置服务器，并分别控制工具启用与审批。

Roo Code开源吗？

开源，VS Code扩展采用Apache 2.0许可证；Roomote云代理使用不同许可证。