Roo Code (VS Code)

文档说明

VS Code 中的 AI 开发团队 - 支持多模式配置的智能编程助手

概述

Roo Code 是一款强大的 VS Code AI 编程助手插件，为您提供一个完整的 AI 开发团队。它最大的特色是多模式配置，允许针对不同的开发任务使用不同的 AI 模型，实现最佳的开发效率。

核心优势

🎯 多模式配置：为架构、编码、调试等不同任务分配专门的模型
🤖 Agent 智能体：自动规划和执行复杂的开发任务
🔄 多文件操作：理解项目结构，智能修改多个文件
💰 完全免费：开源免费，只需支付 AI 模型使用费用
🌐 广泛兼容：支持 400+ 主流 AI 模型
🔌 MCP 支持：通过 Model Context Protocol 连接外部工具

Roo Code vs Cline

Roo Code 是 Cline 的一个分支项目，保留了 Cline 的核心功能，同时添加了独特的多模式配置系统。如果您需要为不同开发阶段使用不同模型，Roo Code 是更好的选择。

快速安装

方式一：VS Code 扩展商店（推荐）

在 VS Code 中按 Ctrl+Shift+X (Windows/Linux) 或 Cmd+Shift+X (macOS) 搜索 "Roo Code" 并点击安装

text

**扩展 ID**：`RooVeterinaryInc.roo-cline`

安装完成后，点击左侧活动栏的 Roo Code 图标

方式二：Open VSX Registry

访问 Open VSX Registry 搜索 Roo Code 进行安装。

配置 FastAiToken

基础配置

点击 Roo Code 侧边栏的齿轮图标（设置按钮）在 API Provider 下拉菜单中选择 OpenAI Compatible Base URL: https://fastaitoken.com/v1

text

**API Key**: 您的 FastAiToken 密钥（格式：`sk-***`）

**Model Name**: 输入您要使用的模型名称

点击保存，Roo Code 会自动验证连接 Base URL 配置要求：

必须使用 https://fastaitoken.com/v1（包含 /v1 路径）
不要使用 https://fastaitoken.com（缺少 /v1 会导致连接失败）

获取 FastAiToken 密钥

多模式配置（核心特性）

Roo Code 的独特之处在于可以为不同的开发模式分配不同的 AI 模型，实现专业化分工。

五大开发模式

架构模式 - 用于系统设计和架构规划

text

**适合模型**：

* Claude Sonnet（推理能力强，擅长架构设计）
* GPT-4o（全面的技术知识）
* DeepSeek V3（深度思考，性价比高）

**典型任务**：

设计一个微服务架构的电商系统：
- 用户服务
- 商品服务
- 订单服务
- 支付服务
使用 Docker + Kubernetes 部署

**编码模式** - 用于实际代码生成和编写

适合模型：

Claude Sonnet（代码质量高）
DeepSeek Coder（专业编程模型）
Qwen Coder（中文注释友好）

典型任务：

text

实现用户认证模块：
- JWT token 生成和验证
- 密码加密（bcrypt）
- 登录/注册接口
- 权限中间件

    **问答模式** - 用于技术咨询和实现规划

**适合模型**：

* GPT-4o-mini（快速响应，成本低）
* Gemini Flash（速度快）
* DeepSeek Chat（性价比高）

**典型任务**：

问：如何优化 React 组件的渲染性能？
问：Redux 和 Zustand 的区别是什么？
问：如何处理 Node.js 中的内存泄漏？

**调试模式** - 用于错误排查和问题修复

适合模型：

GPT-4o（理解复杂错误）
Claude Sonnet（代码分析能力强）
DeepSeek V3（深度分析）

典型任务：

text

调试这个错误：
TypeError: Cannot read property 'map' of undefined

帮我找出以下代码中的内存泄漏问题
分析为什么这个异步函数没有正确执行

    **编排模式** - 用于复杂任务的分解和协调

**适合模型**：

* Claude Opus（处理复杂任务）
* GPT-4o（全局规划能力强）
* DeepSeek V3（逻辑推理）

**典型任务**：

将整个项目从 JavaScript 迁移到 TypeScript：

分析现有代码结构
创建类型定义文件
逐步转换各模块
更新配置文件
运行测试验证

text


配置多模式

    在 Roo Code 设置中找到 **Mode Configuration** 区域

    可以为每个模式单独配置：

* API Provider
* Model Name
* Temperature（创造性参数）
* Max Tokens

    在 Roo Code 界面中，通过模式选择器切换当前使用的模式

  **推荐配置策略**：

Architect/Orchestrator → 使用高质量模型（Claude Sonnet, GPT-4o）
Code → 使用专业编程模型（DeepSeek Coder, Claude Sonnet）
Ask → 使用快速经济模型（GPT-4o-mini, Gemini Flash）
Debug → 使用分析能力强的模型（Claude Sonnet, GPT-4o）

推荐模型Roo Code 通过 FastAiToken 支持 400+ 主流 AI 模型，包括 OpenAI、Google Gemini、Claude、DeepSeek、国产模型等。

  查看最新的编程模型推荐、性能对比和使用建议。包括顶级性能模型、高性价比模型、推理增强模型等详细分类。

  **为什么不在此列出具体模型？**

  AI 模型更新迭代速度非常快，为了确保您获取最准确的模型推荐信息，我们统一在 模型推荐页面 维护最新的模型列表、性能数据和使用建议。
核心功能Agent 智能体模式Roo Code 最强大的功能是 Agent 模式，AI 可以自主规划和执行复杂任务：
任务：创建一个完整的用户认证系统

Roo Code 会自动：
1. 分析需求，制定实现计划
2. 创建必要的文件和目录结构
3. 编写后端 API 代码
4. 创建前端登录/注册页面
5. 添加错误处理和验证
6. 生成单元测试
7. 更新相关文档多文件智能编辑理解项目结构，自动修改多个相关文件：
"将所有 API 调用从 axios 改为 fetch，并更新错误处理逻辑"

Roo Code 会：
- 找到所有使用 axios 的文件
- 转换为 fetch API
- 统一错误处理模式
- 更新类型定义（如果使用 TypeScript）代码生成
  ```python
# 输入描述

  """
  创建一个 FastAPI 端点，实现用户注册功能：
  - 接收 email 和 password
  - 验证邮箱格式
  - 密码加密存储
  - 返回 JWT token
  """

Roo Code 自动生成完整实现  from fastapi import APIRouter, HTTPException  from passlib.hash import bcrypt  import jwt
... 完整的代码实现

// 输入需求 // 创建一个 React Hook 用于管理表单状态 // 支持验证、错误提示、提交处理

// Roo Code 生成 import { useState, useCallback } from 'react';

export function useForm(initialValues, validationRules) { // ... 完整的 Hook 实现 }// 需求：实现一个并发安全的缓存 // 支持 Set、Get、Delete、清理过期数据

// Roo Code 生成完整的 Go 代码 package cache

import ( "sync" "time" )

type Cache struct {

// ... 完整实现

}

代码审查和优化审查这个 PR，关注：

代码规范
性能问题
安全漏洞
潜在 bug
可读性改进Roo Code 会提供详细的审查报告和改进建议。智能重构重构这个函数，要求：
提高可读性
优化性能
添加错误处理
改进类型安全测试生成为 UserService 类生成完整的单元测试，包括：
正常流程测试
边界条件测试
错误处理测试
Mock 外部依赖常用命令Roo Code 提供了丰富的命令面板命令：命令快捷键功能Roo Code: New TaskCtrl+Shift+L开始新任务Roo Code: ContinueEnter继续当前任务Roo Code: ApproveCtrl+Enter批准 AI 的更改Roo Code: RejectCtrl+Backspace拒绝更改Roo Code: Clear History-清除对话历史Roo Code: Switch Mode-切换开发模式 快捷键提示：可以在 VS Code 的键盘快捷方式设置中自定义 Roo Code 的快捷键。

高级功能API Configuration Profiles为不同项目或团队创建不同的 API 配置文件： { "roocode.apiProfiles": { "production": { "provider": "OpenAI Compatible", "baseUrl": "https://fastaitoken.com/v1", "apiKey": "sk-prod-key", "defaultModel": "claude-sonnet-4"

},
"development": {
  "provider": "OpenAI Compatible",
  "baseUrl": "https://fastaitoken.com/v1",
  "apiKey": "sk-dev-key",
  "defaultModel": "deepseek-chat"
}

} }Codebase IndexingRoo Code 会自动索引您的代码库，理解项目结构：

自动发现文件关系理解代码依赖智能上下文感知跨文件引用追踪

MCP 集成通过 Model Context Protocol 连接外部工具：

数据库查询 API 调用文件系统操作 Git 操作自定义工具集成

自定义提示词模板在设置中配置常用的提示词模板： { "roocode.customTemplates": { "codeReview": "详细审查代码，关注性能、安全、可维护性", "optimize": "优化代码性能和可读性，添加必要的注释", "test": "生成全面的单元测试，覆盖边界情况", "refactor": "重构代码，遵循 SOLID 原则和设计模式" } }使用技巧1. 提供清晰的上下文

"优化这个函数"

"优化这个函数的性能，重点关注循环效率和内存使用，添加适当的注释说明优化思路"

分步骤执行复杂任务对于复杂任务，建议分解为多个步骤：使用 Architect Mode 设计整体架构切换到 Code Mode 实现各个模块使用 Debug Mode 排查问题使用 Orchestrator Mode 协调整合
利用模式切换针对不同任务类型切换最合适的模式：

需要设计架构？→ Architect Mode 写代码实现？→ Code Mode 快速咨询？→ Ask Mode 遇到 Bug？→ Debug Mode 复杂重构？→ Orchestrator Mode

审查和批准更改 重要习惯：

始终审查 AI 生成的代码再批准理解每个更改的目的测试修改后的功能保持代码库的一致性

常见问题

**主要区别**：

多模式配置：Roo Code 的核心特性，Cline 不支持
代码库：Roo Code 是 Cline 的 Fork，但在独立开发
更新频率：Roo Code 更新更频繁，功能迭代快
社区：两者都有活跃的社区，但侧重点不同

如何选择：

需要多模式？→ Roo Code
需要稳定性？→ Cline
都可以免费试用，选择最适合自己的常见原因和解决方案：

Base URL 错误：

✅ 正确：https://fastaitoken.com/v1
❌ 错误：https://fastaitoken.com

API Key 无效：

检查 Key 是否正确复制（注意首尾空格）
确认账户余额充足
验证 Key 状态为「启用」

模型名称错误：

确保使用正确的模型名称
参考模型列表

网络问题：

检查网络连接
尝试重启 VS Code

打开 Roo Code 设置（齿轮图标）
找到 Mode Configuration 区域
为每个模式单独设置：

Architect Mode → claude-sonnet-4
Code Mode → deepseek-coder
Ask Mode → gpt-4o-mini
Debug Mode → claude-sonnet-4
Orchestrator Mode → gpt-4o

保存配置

在使用时，通过模式选择器切换即可。

**不会自动修改**，需要您的批准：

Roo Code 会先展示建议的更改
您可以：

查看 Diff（差异对比）
批准（Apply）更改
拒绝（Reject）更改
修改后再批准

所有更改都在您的控制之下

建议启用版本控制（Git），这样可以随时回退不满意的更改。

**省钱策略**：

智能选择模型：

简单任务用便宜的模型（GPT-4o-mini, DeepSeek）
复杂任务才用高级模型（Claude Opus, GPT-4o）

利用多模式配置：

Ask Mode → 用最便宜的模型
Code/Debug Mode → 用中等价位的专业模型
Architect Mode → 仅在需要时用高级模型

充值优惠：

FastAiToken 提供充值加赠（10%-22%）
查看充值活动

控制上下文长度：

清除不必要的对话历史
专注当前任务，减少无关上下文
Web: JavaScript, TypeScript, HTML, CSS, React, Vue, Angular
后端: Python, Java, Go, Rust, C++, C#, PHP, Ruby
移动: Swift, Kotlin, Dart (Flutter), React Native
数据: SQL, R, Julia
其他: Shell, YAML, JSON, Markdown

效果取决于：

选择的 AI 模型
模型的训练数据
语言的流行程度

对比其他工具特性Roo CodeClineCursorGitHub Copilot多模式配置✅❌❌❌Agent 模式✅✅❌❌多文件编辑✅✅部分❌自定义 API✅✅✅❌免费开源✅✅❌❌模型选择400+400+有限GitHub 独家学习曲线中等中等低低 选择建议：

需要多模式配置 → Roo Code 需要稳定成熟 → Cline 需要简单易用 → Cursor GitHub 深度集成 → GitHub Copilot

价格说明Roo Code 插件本身完全免费，您只需支付 AI 模型的使用费用。通过 FastAiToken 使用 AI 模型的费用取决于您选择的模型和使用量。

查看所有模型的详细定价和性价比对比

FastAiToken 提供充值优惠：充值越多，加赠比例越高（10%-22%）。首次充值还可获得额外加赠。查看充值活动详情。

相关资源 Roo Code 官方网站 Roo Code 官方文档 GitHub 仓库 VS Code 扩展商店 FastAiToken 快速开始模型推荐和价格

获取帮助

扫码添加或点击联系客服

配置问题、使用指导

**客服邮箱**：[[email protected]](mailto:[email protected])

商务合作：[email protected]

快速上手：按照本文的「快速安装」和「配置 FastAiToken」章节，5 分钟即可开始使用 Roo Code 进行 AI 辅助编程！

text

Roo Code (VS Code) ​

概述 ​

快速安装 ​

方式一：VS Code 扩展商店（推荐） ​

方式二：Open VSX Registry ​

配置 FastAiToken ​

基础配置 ​

获取 FastAiToken 密钥 ​

多模式配置（核心特性） ​

五大开发模式 ​

Roo Code (VS Code)

概述

快速安装

方式一：VS Code 扩展商店（推荐）

方式二：Open VSX Registry

配置 FastAiToken

基础配置

获取 FastAiToken 密钥

多模式配置（核心特性）

五大开发模式