Roo Code 教程：VS Code AI 编程助手接国产模型（2026）
发布于 2026年9月8日
Roo Code 是 VS Code 上最热门的开源 AI 编程助手之一，它的前身叫 Roo Cline——由知名开源工具 Cline 分支（fork）而来，如今在 agentic 编程圈里的活跃度甚至反超原版。它跑在 VS Code 里，用自然语言就能让 AI 读你的代码库、跨文件改代码、跑命令、修 bug，最大的卖点是模型完全自由：接 DeepSeek、GLM、Kimi 等国产模型只要几步配置，日常成本能压得很低。这篇 Roo Code 教程带你从安装、接国产模型、五种工作模式，到它和 Cline 到底怎么选，一次讲清楚。
Roo Code 是什么（和 Cline 什么关系）
Roo Code 是一个开源、免费的 VS Code 扩展，把一个 agentic 编程智能体嵌进编辑器：你下达自然语言需求，它自己规划步骤、读写文件、执行终端命令、按结果迭代。它源自 Cline（早期名为 Roo Cline），继承了 Cline 的核心交互，又在其基础上加了更多工作模式、自定义模式、更细的权限与自动批准控制，迭代节奏更激进。对喜欢在 VS Code 里干活、又想用国产模型跑真实项目的开发者特别友好。
一句话定位
Roo Code = Cline 的社区分支、跑在 VS Code 里的开源 AI 编程智能体。模型随便换、天然亲和国产 API，模式比原版更丰富，是 Cline 之外又一个值得装的平替。
安装：VS Code 里搜 Roo Code
Roo Code 通过 VS Code 应用市场安装，几步就好。注意发布者要认准 RooVeterinaryInc（扩展 ID 为 roo-cline），别装成同名山寨。用 Cursor、Windsurf、VSCodium 的同学可以在 Open VSX 市场里搜到同一个扩展。
- 1打开 VS Code，点左侧活动栏的扩展图标，或按 Ctrl+Shift+X 打开扩展面板。
- 2在搜索框输入 Roo Code。
- 3选择发布者为 RooVeterinaryInc 的那一个，点 Install 安装。
- 4装好后活动栏会出现一个袋鼠图标，点开就是 Roo Code 面板；按提示配置好模型后即可使用。
接 DeepSeek：最省心的国产选择
接国产模型里，DeepSeek 最省事——Roo Code 内置了 DeepSeek 提供商，不用手填网关地址。先到 DeepSeek 开放平台申请 API Key，再在 Roo Code 里配置：
- 1点开 Roo Code 面板，进入设置（齿轮图标），找到 API Provider（API 提供商）下拉框。
- 2在下拉里选择 DeepSeek。
- 3把申请到的 DeepSeek API Key 粘进 DeepSeek API Key 字段。
- 4在 Model（模型）下拉里选模型：deepseek-chat（通用对话）或 deepseek-reasoner（带推理），保存即可开用。
接 GLM / Kimi / 本地模型：OpenAI Compatible 通道
智谱 GLM、月之暗面 Kimi（Moonshot），以及本地 Ollama、LM Studio，大多提供「OpenAI 兼容」接口。这类模型走 Roo Code 的 OpenAI Compatible 提供商：在 API Provider 下拉里选 OpenAI Compatible，填三样东西——Base URL（厂商网关地址，注意不是 https://api.openai.com/v1）、API Key、Model ID（模型名）。下面是几个常见网关的示例值：
| 模型 / 厂商 | Base URL（示例，以官方为准） | Model ID（示例） |
|---|---|---|
| 智谱 GLM | https://open.bigmodel.cn/api/paas/v4 | glm-4.6 |
| Kimi / Moonshot | https://api.moonshot.cn/v1 | kimi-k2（版本号以官方为准） |
| 本地 Ollama | http://localhost:11434/v1 | 本地已拉取的模型名，如 qwen2.5-coder |
两个坑：网关会变 + 必须支持工具调用
① 上面的 Base URL 和模型名只是示例，各厂商接口地址、模型版本号迭代很快，配置前请以对应开放平台最新文档为准，填错会直接连不上或报 model not found。② Roo Code 全程依赖原生工具调用（native tool calling），所接模型/接口必须支持 OpenAI 风格的 function calling，否则 AI 无法读写文件、执行命令——选国产模型时优先挑明确支持工具调用的版本。
五种内置模式：Code / Ask / Architect / Debug / Orchestrator
Roo Code 内置五种工作模式，在面板底部一键切换，让 AI 在「只读思考」和「动手改码」之间切换，复杂任务还能自动拆解分派：
| 模式 | 定位与用途 |
|---|---|
| 💻 Code（默认） | 全能软件工程师，拥有完整工具权限，用于实际写代码、改代码。 |
| ❓ Ask | 技术问答助手，只解释不改代码，适合读代码、学原理。 |
| 🏗️ Architect | 技术负责人 / 规划者，先设计系统、出实现方案（可读文件、改 Markdown），想清楚再动手。 |
| 🪲 Debug | 排错专家，系统化定位与诊断问题，拥有完整工具权限。 |
| 🪃 Orchestrator | 又叫 Boomerang，把复杂任务拆成子任务、分派给上面几种模式协同完成。 |
除了这五种，你还能自定义模式：给它专属的系统提示、限定可用工具与权限，做成「只写测试」「只审代码」这类专用助手，团队之间还能共享。
Roo Code 和 Cline 有什么区别，怎么选
两者同源——Roo Code 是 Cline 的分支，核心交互一脉相承，都支持接任意模型、都支持 MCP。差别在风格：Cline 更精简克制，贴近「原版」；Roo Code 迭代更快、功能更多，内置了 Architect、Orchestrator 等更多模式，还有自定义模式、更细的自动批准（auto-approve）与检查点（checkpoint）控制，可玩性更高但设置项也更多。选择建议：想要简单稳定就用 Cline，想要更多模式和更强编排就用 Roo Code——两个是同一套配置思路，装哪个、接国产模型的步骤都差不多，站内有对应的 Cline 教程可以对照着看。
Roo Code 把「在 VS Code 里低成本用上 AI 编程」做得很顺，接国产模型也只是几步配置。但工具越顺手，越考验你会不会拆需求、审代码、把 AI 的产出稳定用进真实项目——这才是真正拉开差距的地方。想系统掌握用 AI 工具做出能交付产品的方法，欢迎来 IMAI 看看我们的体系化实战课程。
想系统学会用 AI 编程,从入门到做出真实产品?
查看系统课程