Roo Code 使用教程：从入门到上手

Roo Code 是什么

Roo Code 是 VS Code 上一款开源的 AI 编程助手，最初从 Cline 项目分支出来，目前由美国团队 Roo Code 独立维护。它本质上是一个 Agent 模式的扩展插件——你不需要切换编辑器，直接在 VS Code 里就能用。和很多 AI 编程工具不同，Roo Code 支持多步自主执行：你给一个任务，它能自己规划步骤、读写文件、执行终端命令，甚至调用浏览器调试页面。整个过程你可以在侧边栏里实时观察，每一步都能手动确认或打断。

核心功能怎么用

Roo Code 最核心的能力是 Agent 模式。安装后，你会看到对话输入框旁边有一个模式切换按钮，默认是“Code”模式，可以改成“Agent”。在 Agent 模式下，你只需要用自然语言描述需求，比如“帮我写一个 Python 脚本，批量重命名当前目录下的所有 .txt 文件，加上日期前缀”，它就会自动分析需求，生成代码，创建文件，然后执行。每一步都会在聊天面板里显示，你可以点“允许”让它继续，或者点“拒绝”让它修改。

它还支持 多模型配置。在扩展设置里，你可以添加多个 API 提供商，比如 OpenAI、Anthropic、Google Gemini 等。不同模型适合不同任务：复杂逻辑用 Claude 3.5 Sonnet，简单问答用 GPT-4o-mini 更省钱。切换模型只需要在对话窗口下拉菜单里选，不用重新配置。

第一次上手步骤

1. 安装扩展：在 VS Code 扩展市场搜索“Roo Code”，点击安装。安装后左侧会出现一个机器人图标。
2. 配置 API 密钥：点击机器人图标打开面板，会提示你输入 API Key。如果你用 OpenAI，去平台生成一个密钥填进去；如果用 Anthropic 的 Claude，同样操作。注意：这些 API 服务国内访问受限，如果连不上，可以看看国产替代方案（比如通义千问、DeepSeek 等兼容 OpenAI 接口的服务）。
3. 设置工作目录：默认会使用当前打开的文件夹。建议先在一个测试项目里试用，避免误操作。
4. 开始第一个任务：在输入框里输入“列出当前目录下所有文件，并告诉我每个文件的大小”，按回车。Roo Code 会先读取目录结构，然后执行命令。你可以观察它每一步的动作，第一次用建议点“允许”看清楚它做了什么。
5. 切换到 Agent 模式：试试更复杂的任务，比如“创建一个 Flask 应用，包含一个简单的登录页面，使用 SQLite 存储用户数据”。它会自动生成代码、安装依赖、启动服务。如果报错，它还会尝试修复。

适合什么场景

Roo Code 最适合 原型开发 和 自动化脚本 场景。比如你临时需要一个爬虫抓取数据，或者要批量处理几百个文件，直接描述需求就行，不用自己一行行写代码。它也适合 调试：把报错信息粘贴进去，让它分析日志、修改代码、重新运行，效率比手动排查高很多。

不太适合的场景包括：生产环境部署（它可能误操作），或者需要高度定制化架构的大型项目（它生成的代码风格可能不符合团队规范）。另外，如果你对代码质量要求极高，建议用它生成骨架后再手动优化。

价格说明

Roo Code 本身是 免费开源 的，你可以在 GitHub 上找到它的仓库，自己编译或者直接装 VS Code 版都行。但使用过程中调用的 AI 模型需要你自己付费——比如 OpenAI 的 API 是按 token 计费的，一个中等复杂度的任务大概花几分到几毛钱人民币。如果你用量不大，一个月几块钱就够了。如果不想用海外 API，可以换成国产模型的 API，同样兼容，价格更低。