Roo Code 完整攻略：从新手到高手

是什么 / 适合谁

Roo Code 是 VS Code 生态中一款开源的 AI Agent 扩展，源自 Cline 项目的活跃分支。它继承了 Cline 的核心能力——让大语言模型直接操作你的开发环境，包括读写文件、执行终端命令、调用浏览器等。但与 Cline 相比，Roo Code 在功能迭代上更加激进，更早地支持了多模型切换、自定义 Agent 行为等特性。

简单理解：Roo Code 不是一个帮你补全代码的助手，而是一个能独立完成编程任务的“AI 程序员”。你给它一个任务描述，它会自动规划步骤、编写代码、运行测试、修复错误，直到任务完成。

适合谁：

• 有一定编程基础，想用 AI 加速开发流程的开发者
• 对 Cline 感兴趣但希望更快尝鲜新功能的用户
• 愿意接受一定不稳定性的早期采用者
• 需要本地化、开源、无订阅费的 AI 编程方案的人

不适合谁：

• 零编程基础的新手（需要理解 Agent 的输出并做判断）
• 追求极致稳定性的生产环境用户
• 只想要代码补全而非全自动 Agent 的人

阶段学习路径

第1天：安装与首次运行

1. 安装
   在 VS Code 扩展市场搜索 "Roo Code"，点击安装。无需额外配置环境，插件会自动检测可用的 API 提供商。

2. 配置 API
   打开命令面板（Ctrl+Shift+P），输入 "Roo Code: Open Settings"。在设置中填入你的 API Key。支持 OpenAI、Anthropic、Google Gemini 等主流模型。注意：国内用户请使用合规的云服务商 API，不要尝试任何非法网络访问。

3. 第一个任务
   在 VS Code 中打开一个空文件夹，按 Ctrl+Shift+I 调出 Roo Code 面板。输入：
   创建一个简单的 Python 计算器，支持加减乘除，并在终端运行测试
   观察 Agent 如何自动创建文件、编写代码、运行测试。如果遇到错误，它会自动读取错误信息并修复。

4. 理解工作流
   Roo Code 会以对话形式展示每一步操作：读取了哪些文件、执行了什么命令、修改了哪些代码。你可以随时中断、修改指令或回退到上一步。

第1周：日常使用技巧

1. 任务拆解
   不要一次给过于复杂的任务。例如：
   ❌ “写一个电商网站”
   ✅ “创建一个 Flask 应用，包含一个商品列表页面，数据从 JSON 文件读取”

2. 利用上下文
   在对话中，Roo Code 会记住之前的内容。你可以逐步追加需求：

   • 第1轮：“创建一个用户登录表单”
   • 第2轮：“添加表单验证，密码长度不小于8位”
   • 第3轮：“把登录信息保存到 SQLite 数据库”

3. 手动干预
   当 Agent 陷入循环或产生明显错误时，直接输入指令纠正：

   • “停，不要用 requests 库，改用 httpx”
   • “回退到上一步，重新生成”

4. 使用自定义指令
   在设置中配置“系统提示词”，让 Agent 遵循你的编码风格：

   • “所有函数必须写类型注解”
   • “优先使用 Vue 3 Composition API”
   • “测试覆盖率不低于 80%”

进阶：定制与自动化

1. 多模型切换
   在任务中动态切换模型：

   • 复杂逻辑用 Claude 3.5 Sonnet
   • 简单重构用 GPT-4o-mini（更便宜）
     在对话中输入 /model gpt-4o-mini 即可切换。

2. 自定义工具
   Roo Code 允许你添加自己的工具函数。例如，创建一个“部署到服务器”工具，让 Agent 在完成任务后自动执行部署脚本。

3. 批量任务
   通过配置文件，让 Roo Code 按顺序执行多个任务：

   • 先运行代码格式化
   • 再运行 lint 检查
   • 最后运行测试套件
     适合作为 CI/CD 流程的一部分。

4. 与 Git 集成
   让 Agent 自动创建分支、提交代码、创建 PR。指令示例：
   修复所有 lint 错误，创建新分支 fix-lint，提交并推送

优势

1. 开源免费
   完全开源，无隐藏收费。你只需支付 API 调用费用，相比 GitHub Copilot 等订阅制工具，长期使用成本更低。

2. 功能迭代激进
   比 Cline 更早支持多模型切换、自定义 Agent 行为、批量任务等特性。如果你喜欢尝鲜新功能，Roo Code 是更好的选择。

3. 深度控制
   你可以精确控制 Agent 的每一步操作：允许/禁止哪些终端命令、限制文件读写范围、设置最大 token 消耗。对于有安全顾虑的团队很友好。

4. VS Code 原生体验
   作为插件运行，与 VS Code 的编辑器、终端、文件系统无缝集成。无需切换工具，所有操作都在同一个界面完成。

短板

1. 与 Cline 高度重叠
   核心功能与 Cline 几乎一致，如果你已经在用 Cline，切换过来的价值有限。Roo Code 的优势主要体现在新功能上。

2. 稳定性中等
   作为激进分支，新功能可能引入 bug。在复杂任务中偶尔会出现 Agent 卡死、上下文丢失等问题。建议在非关键项目上试用。

3. 学习曲线
   相比 Copilot 的“即装即用”，Roo Code 需要你理解 Agent 的工作原理，并学会如何有效指挥它。新手可能会觉得难以控制。

4. 依赖 API 质量
   Agent 的表现高度依赖底层模型。使用弱模型时，输出质量会明显下降。而强模型（如 Claude 3.5）的 API 成本较高。

价格规划

Roo Code 本身完全免费。你的成本只有 API 调用费用：

• 低成本方案：使用 GPT-4o-mini，每次任务约 0.01-0.05 美元，适合简单任务
• 平衡方案：混合使用 Claude 3.5 Sonnet（复杂任务）+ GPT-4o-mini（简单任务），月均 5-20 美元
• 高性能方案：全程使用 Claude 3.5 Sonnet 或 GPT-4o，月均 20-100 美元，取决于任务量

省钱技巧：

• 在设置中限制最大 token 数
• 优先使用本地模型（如 Ollama 部署的开源模型）
• 利用缓存机制，重复任务不重复计算

不合适怎么办

如果 Roo Code 不适合你，以下替代方案值得考虑：

1. Cline
   如果 Roo Code 的稳定性让你困扰，回到 Cline 主分支。功能相似，但更稳定。

2. GitHub Copilot
   如果你只想要代码补全而非全自动 Agent，Copilot 的体验更流畅。订阅费 10 美元/月。

3. Cursor
   一款基于 VS Code 的 AI 编辑器，内置 Agent 功能。体验更集成，但需要订阅（20 美元/月）。

4. Continue
   另一个开源 VS Code AI 插件，专注于代码补全和对话，不如 Roo Code 激进，但更稳定。

5. 本地方案
   使用 Ollama 部署 CodeLlama 等开源模型，配合 Continue 插件。完全免费，但模型能力有限。

选择建议：

• 想要最激进的 Agent 体验 → Roo Code
• 追求稳定 → Cline 或 Continue
• 零配置即用 → GitHub Copilot 或 Cursor
• 完全本地化 → Ollama + Continue