快速获得帮助 → 加入 Discord • 更喜欢异步交流？→ 加入 r/RooCode

Roo Code

您的 AI 驱动开发团队，就在您的编辑器中

v3.52.0 版本更新内容

• 新增 Poe 作为 AI 提供商，您现在可以直接在 Roo Code 中使用 Poe 的模型。
• 改进了 xAI 提供商，包括 Responses API 的迁移、可复用的转换工具以及更新后的 Grok-4.20 默认设置。
• 修复了 MiniMax 模型的列表显示及上下文窗口处理问题，使配置更加可靠。

🌐 可用语言

• English
• Català
• Deutsch
• Español
• Français
• हिंदी
• Bahasa Indonesia
• Italiano
• 日本語
• 한국어
• Nederlands
• Polski
• Português (BR)
• Русский
• Türkçe
• Tiếng Việt
• 简体中文
• 繁體中文
• ...

---

Roo Code 能为您做些什么？

• 根据自然语言描述和规范生成代码
• 通过多种模式灵活适应：代码模式、架构模式、提问模式、调试模式以及自定义模式
• 重构和调试现有代码
• 编写和更新文档
• 回答关于代码库的问题
• 自动化重复性任务
• 利用 MCP 服务器

模式

Roo Code 可以根据您的工作方式灵活调整：

• 代码模式：日常编码、编辑和文件操作
• 架构模式：规划系统、规格说明和迁移方案
• 提问模式：快速解答问题、提供解释和文档
• 调试模式：追踪问题、添加日志并定位根本原因
• 自定义模式：为您的团队或工作流程构建专用模式

了解更多：使用模式 • 自定义模式

教程与功能视频

更多快速教程和功能视频...

资源

• 文档： 官方指南，助您安装、配置并精通 Roo Code。
• YouTube 频道： 观看教程，了解功能的实际应用。
• Discord 服务器： 加入社区，获取实时帮助与讨论。
• Reddit 社区： 分享您的经验，看看其他人正在构建什么。
• GitHub 问题： 报告错误并跟踪开发进度。
• 功能请求： 有想法吗？与开发者分享吧。

---

本地搭建与开发

1. 克隆仓库：

git clone https://github.com/RooCodeInc/Roo-Code.git

2. 安装依赖：

pnpm install

3. 运行扩展：

运行 Roo Code 扩展有多种方式：

开发模式 (F5)

对于活跃的开发工作，可以使用 VSCode 内置的调试功能：

在 VSCode 中按下 F5（或进入 Run → Start Debugging）。这将打开一个新的 VSCode 窗口，其中运行着 Roo Code 扩展。

• 对 Webview 的更改会立即生效。
• 对核心扩展的更改也会自动热重载。

自动化 VSIX 安装

要构建扩展并将其作为 VSIX 包直接安装到 VSCode 中：

pnpm install:vsix [-y] [--editor=<command>]

此命令将执行以下操作：

• 提示选择要使用的编辑器命令（code/cursor/code-insiders），默认为 'code'。
• 卸载已存在的扩展版本。
• 构建最新的 VSIX 包。
• 安装新构建的 VSIX。
• 提示您重启 VSCode 以使更改生效。

选项：

• -y：跳过所有确认提示并使用默认值。
• --editor=<command>：指定编辑器命令（例如 --editor=cursor 或 --editor=code-insiders）。

手动 VSIX 安装

如果您更倾向于手动安装 VSIX 包：

1. 首先，构建 VSIX 包：

   pnpm vsix
   

2. 将会在 bin/ 目录下生成一个 .vsix 文件（例如 bin/roo-cline-<version>.vsix）。
3. 使用 VSCode CLI 手动安装：

   code --install-extension bin/roo-cline-<version>.vsix
   

---

我们使用 changesets 进行版本管理和发布。请查看我们的 CHANGELOG.md 以获取发布说明。

---

免责声明

请注意，Roo Code, Inc 对于与 Roo Code 相关、任何第三方工具或由此产生的任何输出所涉及的代码、模型或其他工具不作任何陈述或保证。您需自行承担使用此类工具或输出所产生的全部风险；此类工具均按“现状”和“可获得性”提供。相关风险可能包括但不限于知识产权侵权、网络安全漏洞或攻击、偏见、不准确、错误、缺陷、病毒、服务中断、财产损失或损坏以及人身伤害等。您应对使用此类工具或输出的行为全权负责（包括但不限于其合法性、适当性及其结果）。

---

贡献

我们非常欢迎社区贡献！请阅读我们的 CONTRIBUTING.md，开始您的贡献之旅。

---

许可证

Apache 2.0 © 2025 Roo Code, Inc.

---

尽情享受 Roo Code 吧！ 无论您是将其严格控制在有限范围内，还是让它自主运行，我们都迫不及待地想看看您能创造出什么。如果您有任何问题或功能建议，欢迎访问我们的 Reddit 社区 或 Discord。祝编码愉快！

Roo Code 快速上手指南

Roo Code 是一款集成在 VS Code 中的 AI 驱动开发助手，能够根据你的自然语言描述生成代码、重构项目、调试错误以及管理文档。它支持多种工作模式（如编码、架构设计、调试等），是你的智能结对编程伙伴。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：Windows、macOS 或 Linux
• 编辑器：Visual Studio Code (推荐最新稳定版)
• 网络环境：由于需要连接 AI 模型服务，请确保网络畅通。如需访问 Discord 社区或特定模型接口，可能需要配置网络代理。
• 前置依赖（仅针对本地开发/贡献者）：
  • Node.js (建议 LTS 版本)
  • pnpm 包管理器

注意：普通用户直接使用 VS Code 插件市场安装即可，无需安装 Node.js 和 pnpm。以下步骤主要针对想要从源码构建或参与开发的开发者。

安装步骤

方式一：通过 VS Code 市场安装（推荐普通用户）

1. 打开 Visual Studio Code。
2. 点击左侧活动栏的 扩展 (Extensions) 图标（或按 Ctrl+Shift+X / Cmd+Shift+X）。
3. 在搜索框中输入 Roo Code。
4. 找到由 Roo Veterinary Inc 发布的插件，点击 安装 (Install)。
5. 安装完成后，点击侧边栏出现的 Roo Code 图标即可启动。

方式二：从源码构建安装（适合开发者）

如果你希望体验最新版本或参与贡献，可以通过以下命令从 GitHub 克隆并构建：

1. 克隆仓库：

   git clone https://github.com/RooCodeInc/Roo-Code.git
   cd Roo-Code
   

2. 安装依赖：

   pnpm install
   

   (国内用户若下载依赖缓慢，可配置 pnpm 使用国内镜像源：pnpm config set registry https://registry.npmmirror.com)

3. 运行扩展（开发模式）： 在 VS Code 中打开该项目文件夹，按下 F5 键（或选择 运行 (Run) -> 启动调试 (Start Debugging)）。

   • 这将启动一个新的 VS Code 窗口，其中已加载正在开发的 Roo Code 扩展。
   • 代码修改会自动热重载。

4. 打包安装（可选）： 若需生成 .vsix 安装包手动安装到正式版 VS Code：

   pnpm vsix
   

   生成的文件位于 bin/ 目录下，随后使用命令行安装：

   code --install-extension bin/roo-cline-<version>.vsix
   

基本使用

安装完成后，Roo Code 会出现在 VS Code 的侧边栏。以下是快速开始的核心流程：

1. 配置 AI 提供商

首次使用时，你需要配置 AI 模型提供商（如 OpenAI, Anthropic, xAI, Poe 等）：

• 点击 Roo Code 图标打开面板。
• 进入 设置 (Settings)，选择你拥有的 API 密钥对应的服务商。
• 输入 API Key 并保存。
• 注：v3.52.0+ 版本已支持直接接入 Poe 模型。

2. 选择工作模式 (Modes)

Roo Code 提供多种预设模式以适应不同任务，点击模式切换按钮进行选择：

• Code Mode：日常编码、文件编辑和操作（默认推荐）。
• Architect Mode：用于系统规划、规格说明和迁移方案。
• Ask Mode：快速获取代码解释、文档查询。
• Debug Mode：追踪问题、添加日志、定位根因。
• Custom Modes：自定义专属工作流。

3. 发起第一个任务

在对话框中输入自然语言指令，例如：

请在当前目录下创建一个名为 utils.js 的文件，并导出一个用于格式化日期的函数 formatDate(date)。

或者让 AI 分析当前打开的文件：

解释一下这个函数的逻辑，并指出是否有潜在的性能问题。

Roo Code 将自动读取上下文，生成代码或提供建议。你可以直接点击 Apply 按钮将更改应用到文件中，或在对话框中继续迭代修改。

4. 进阶功能

• 代码库索引 (Codebase Indexing)：启用后可让 AI 理解整个项目结构，回答跨文件的问题。
• MCP 服务器：连接外部工具和数据源，扩展 AI 能力边界。
• 检查点 (Checkpoints)：随时回滚到之前的对话状态或代码版本。

现在，你可以在 VS Code 中享受高效的 AI 辅助开发体验了！