Roo Code 使用教程

Roo Code 是一款功能丰富的开源 AI 编程助手，支持多种工作模式和高度自定义。本文介绍安装、API 配置、工作模式选择和自定义工作流。

什么是 Roo Code？

Roo Code（原 Roo-Cline）是基于 Cline 分支开发的 VS Code AI 编程插件，在 Cline 基础上增加了更多特性：

• 多工作模式：预设 Code、Architect、Debug、Ask 等模式
• 自定义模式：可创建自己的工作流模式
• MCP 支持：集成 Model Context Protocol 扩展能力
• 检查点恢复：可回退到任意操作步骤
• 完全开源：Apache 2.0 许可证

安装

1. 打开 VS Code
2. 进入扩展市场（Ctrl+Shift+X）
3. 搜索 "Roo Code" 或 "Roo-Code"
4. 点击 Install
5. 侧边栏出现 Roo Code 图标

配置 API Provider

Roo Code 需要配置 AI 模型提供者才能使用。推荐使用 OpenAI 兼容接口：

OpenAI Compatible（推荐）

# Roo Code 设置
API Provider: OpenAI Compatible
Base URL: https://claude4u.com/v1
API Key: your-relay-key
Model ID: claude-sonnet-4-20250514

其他提供者

# Anthropic 直连
API Provider: Anthropic
API Key: your-anthropic-key

# Google Gemini
API Provider: Google Gemini
API Key: your-gemini-key

# 本地模型（Ollama）
API Provider: Ollama
Base URL: http://localhost:11434

工作模式详解

Roo Code 最大的特色是多工作模式，不同模式有不同的系统提示和工具权限：

Code 模式

• 默认模式，具备完整 Agent 能力
• 可读写文件、执行命令、浏览网页
• 适合日常编程任务

Architect 模式

• 专注于架构设计和技术方案
• 只读文件，不直接修改代码
• 适合前期设计和代码审查

Debug 模式

• 专注于错误诊断和修复
• 优先分析日志和错误信息
• 自动运行测试验证修复

Ask 模式

• 纯问答模式，不修改任何文件
• 适合学习和理解代码
• 成本最低（只读操作）

自定义工作模式

你可以创建自己的工作模式，定义专属的工作流：

// .roo/modes.json 自定义模式示例
{
  "customModes": [
    {
      "slug": "reviewer",
      "name": "Code Reviewer",
      "roleDefinition": "你是一个严格的代码审查员。分析代码质量、安全性和性能，给出改进建议。",
      "groups": ["read"],
      "customInstructions": "使用中文输出。关注安全漏洞、性能瓶颈和代码规范。"
    },
    {
      "slug": "tester",
      "name": "Test Writer",
      "roleDefinition": "你是一个测试工程师。为代码编写全面的单元测试和集成测试。",
      "groups": ["read", "edit", "command"],
      "customInstructions": "使用 Jest 测试框架，确保覆盖边界情况。"
    }
  ]
}

实用技巧

模式切换策略

• 先用 Architect 模式设计方案
• 再用 Code 模式实现代码
• 最后用 Debug 模式排查问题

检查点恢复

Roo Code 在每次文件修改前自动创建检查点，如果 AI 修改不满意：

• 点击对话历史中的 "Restore Checkpoint" 回退
• 或使用 git 回退更彻底

MCP 工具集成

通过 MCP（Model Context Protocol）可以扩展 Roo Code 的能力：

• 连接数据库查询
• 访问外部 API
• 集成内部工具链

Roo Code vs Cline

• Roo Code 优势：多工作模式、自定义模式、检查点恢复、MCP 支持更完善
• Cline 优势：社区更大、更新更快、文档更丰富
• 共同点：都免费开源，都支持所有 OpenAI 兼容 API