Roo Code 怎么安装：停运说明与替代方案

小猫跳舞 技术创作者 2026-11-02 303 阅读

Roo Code 曾是 VS Code 的 AI 编程扩展；现已停运，替代品需另行安装。

Roo Code 文档在 2026 年 5 月 15 日更新并明确写明：“The Roo Code Extension was shut down on May 15th.” 同一官方首页现在主推的是可在自有基础设施运行的 Roomote，而不是旧的 Roo Code VS Code 扩展。因此，现在搜索到的 Marketplace 安装教程仍可能有效，却不能理解成官方仍在维护这条安装路径。值得现在处理安装问题，是因为继续照旧教程操作，很容易把“能下载”误认为“受支持”，甚至装入缺少后续更新的扩展。

先分清 Roo Code、Roomote 和社区分支

Roo Code 是一个开源 AI 编程代理扩展，运行在 VS Code 内，提供文件读写、终端控制、多步骤任务、模式切换和 MCP 等能力。它本身不是大模型，完整使用还需要接入一个 LLM 提供商。

但当前有三个容易混淆的名字：

名称 现在的定位 与旧 Roo Code 的关系
Roo Code 已于 2026 年 5 月 15 日停运的 VS Code 扩展 旧 Roo Code 文档仍可访问，也保留安装说明
Roomote 可自行部署的云端编程代理，当前官方首页主推 Roo Code 官方站点现在介绍的新产品
ZooCode Roo Code 社区启动的分支 官方停运公告直接推荐的替代方向之一

因此，搜索“Roo Code 官方仓库”时，看到的也不一定是旧扩展仍在继续发布。安装前先打开 Roo Code 官方文档首页，检查页面是否仍显示扩展停运公告；再根据用途选择社区分支或 Roomote。

旧扩展本身仍然值得了解，因为不同编辑器对应的安装入口并不相同，排查别人留下的配置时也会用到。

开始前只检查 3 项

  1. 确认编辑器版本：在 VS Code 中打开“帮助 → 关于”，确认版本不低于 1.84.0。这是旧版 Roo Code 官方安装页列出的最低版本要求。

  2. 确认编辑器类型：标准 VS Code 和 Cursor 优先走 Marketplace；VSCodium、Windsurf 等兼容编辑器优先检查 Open VSX。旧安装页明确把 Marketplace 标为标准 VS Code 和 Cursor 用户最快的路径。

  3. 准备模型服务：Roo Code 不是模型。安装扩展后，还需要在 Roo Code 面板中配置 LLM 提供商；涉及模型调用时会产生相应供应商费用。

历史安装说明可在 Roo Code 安装文档 和 2026 年 5 月 14 日版本的官方安装页 中交叉核对。

旧 Roo Code 扩展的 4 个安装入口

1. VS Code Marketplace

这是标准 VS Code 和 Cursor 用户的推荐路径。

打开 VS Code，点击活动栏中的“扩展”图标；Windows 和 Linux 可按 Ctrl+Shift+X，macOS 可按 Cmd+Shift+X。搜索 Roo Code，选择发布者为 RooVeterinaryInc 的扩展，点击“安装”。如果编辑器要求重新加载，执行重新加载。

2. Open VSX Registry

VSCodium、Windsurf 等无法正常访问 Marketplace 的编辑器，应改用 Open VSX。打开编辑器的扩展视图，搜索 Roo Code，找到对应条目后安装，并在提示时重新加载编辑器。

3. 手动安装 VSIX

需要离线安装或排查 Marketplace 下载问题时，可使用 VSIX：

扩展视图 → “...”菜单 → 从 VSIX 安装... → 选择下载的 .vsix 文件

中文安装页把这一入口称为“从 VSIX 安装”，并说明应从 Roo Code GitHub 发布页面查找官方版本。下载地址用扩展的发布页：RooCodeInc/Roo-Code 的 Releases（原引的 RooCodeInc/Roomote 是 Roomote 仓库、不放扩展资产，已更正）。到最新版本的 Assets 里下载 .vsix 文件，再按上面的菜单路径安装——不要从同名扩展或个人构建处拿包。

4. Roo Code Nightly

Nightly 是每次合并到主分支时发布的预发布版本，不是另一家厂商的扩展。旧安装文档把它放在“高级用法”下（原文：请参阅高级用法部分中的 Roo Code Nightly 指南——本文未抓取该指南正文，安装前按下面两步现做）。它更适合需要提前验证修复或新功能的用户，不适合追求稳定性的日常安装。实操两步：① 打开旧安装文档的“高级用法 → Roo Code Nightly”指南确认当前安装方式；② 到 RooCodeInc/Roo-Code Releases 找 Nightly 预发布资产，下载后走与 VSIX 相同的“从 VSIX 安装”菜单。

可复制的安装入口信息如下：

扩展视图快捷键：Windows/Linux Ctrl+Shift+X
扩展视图快捷键：macOS Cmd+Shift+X
Marketplace 发布者：RooVeterinaryInc
VSIX 菜单路径：扩展视图 → “...” → 从 VSIX 安装...

扩展停运后，改装哪个分支

当前官方停运页面给出的直接替代方向是 ZooCode 和 Cline：前者是 Roo Code 社区启动的分支，后者是 Roo Code 的原始项目来源。不要仅凭名称安装，打开 ZooCode 官方 GitHub 仓库，核对仓库归属、README 中的编辑器支持和发布资产，再按仓库当前说明操作。实操顺序：仓库 → Releases/README 确认支持的编辑器与安装方式（VSIX 或其指明的扩展市场）→ 下载后走同一个“从 VSIX 安装”菜单 → 装完在扩展视图确认出现扩展名，再打开面板验证工具可用。

如果需求已经从“编辑器内辅助写代码”变成“让代理在服务器上运行、提交 PR 并提供预览”，则应看 Roomote 自托管文档。这是一条不同路径：官方首页称它运行在实际开发环境中，可自行部署、选择模型，并连接 GitHub、GitLab、Azure DevOps、Gitea 或 Bitbucket。它不是 Roo Code 扩展的更新包。实操入口：官方首页的 Get started 进入产品试用，自托管按 self-hosting 文档逐步部署——先起服务、再接代码托管、最后验证能创建 Agent 任务，三步都在该文档内。

这一区分很关键：等待旧扩展更新通常没有意义；社区分支解决的是“继续获得类似扩展”，Roomote 解决的是“把代理移到可自托管的云端环境”。

常见卡点：别把下载成功当成安装成功

最典型的误判来自停运状态。官方文档首页直接显示 “Extension Shutdown”，正文也写明扩展已于 5 月 15 日停运。如果 Marketplace 中仍能搜索到旧条目，或以前安装的 Roo Code 图标暂时还能显示，这只能证明扩展文件仍在，并不代表它仍在获得官方维护。

另一个官方故障排查条目是 “扩展不可见”。历史解法包括重新启动编辑器、确认扩展已列出并启用、禁用后再启用，以及从“视图 → 输出”选择“Roo Code”检查日志。但当页面已经明确显示停运时，最终处理应是迁移到 ZooCode 或 Cline，而不是反复重装同一个旧扩展。

接入模型阶段若界面没有可用模型，优先检查 Connect an LLM Provider。旧扩展的定位本来就是模型无关代理，没有配置提供商时，它只能显示界面，不能完成模型驱动的编程任务。

怎么确认安装结果

旧 Roo Code 扩展安装成功后，应能观察到两个状态：

  1. VS Code 活动栏出现 Roo Code 图标；
  2. 点击图标后能打开 Roo Code 面板，并进入模型提供商配置。

如果看到扩展停运公告，则当前可确认的结果不是“旧扩展已维护”，而是“已正确识别停运状态”。后续选择社区分支时，同样以编辑器扩展面板出现对应图标、点击后能打开面板为成功标志；选择 Roomote 时，则按自托管文档确认服务已经部署，并能从官方首页所列的代码托管平台连接仓库。

官方入口与维护边界

继续核对时，优先使用以下一手入口：

简而言之：旧 Roo Code 扩展的安装步骤仍可用于复现或迁移，但 2026 年 5 月 15 日停运才是现在最重要的安装前提。个人使用优先核对 ZooCode，团队希望自托管云端代理则转向 Roomote；不要把旧扩展下载成功误认为官方支持仍在继续。

参考来源

# AI# 知识

评论区

0 条评论

登录后可评论。

小猫跳舞 303 阅读