DeepSeek V4.1 接入 Roo Code 完整指南

DeepSeek V4.1 接入 Roo Code 完整指南

Roo Code 是从 Cline 分支出来的开源插件，保留了我们喜欢的全部核心能力——自主 Agent、分步批准、Git 检查点——同时把「模式」做成了它的招牌：同样的一个需求，可以拆给不同模式、挂不同模型分阶段完成。配合 DeepSeek 高低搭配的模型线，这个分工刚好能把成本打到最优。

本篇覆盖：接入配置、五种模式的分工逻辑、自定义模式和团队共享。

为什么是 Roo Code + DeepSeek

Roo Code 的独特价值在模型分工：让贵的模型只干它擅长的活，便宜的模型跑量。这是纯省钱视角下最实用的设计。

第一步：安装

1. VS Code 扩展市场搜索 Roo Code，安装后重启 VS Code
2. 首次启动会弹出模式选择向导（Code / Architect / Ask 等），按需选一个默认模式进入
3. 后续要改配置：点侧边栏 Roo Code 图标，面板右上角有设置入口；老版本在侧边栏底部 Settings 标签

第二步：创建 API Key

1. 登录 DeepSeek 开放平台，完成实名认证
2. API keys 页面创建新密钥，当场复制，完整 Key 只显示一次
3. 赠送额度够跑通全部测试

第三步：配置 DeepSeek

面板设置里 Provider 选 OpenAI Compatible，填三项：

要点：

1. Base URL 不带 /v1——Provider 自己拼 /chat/completions，多写一层 404，最高频错误
2. 模型 ID 用现行名——旧资料的 deepseek-chat/deepseek-reasoner 是上一代名字，别用
3. 保存后不会立刻发请求，发第一条消息时才建立连接——验证配置要发句话，不是看保存有没有报错

第四步：五种模式怎么分工

Roo Code 的模式是它和 Cline 最大的差异，每种模式可以单独配置模型（模式选择器旁边就有模型设置）：

一套「Architect 出方案 → Code 执行 → Ask 答疑」的流水线走下来，贵模型只用在方案环节，整体成本比全程挂大模型省一半以上。

第五步：自定义模式（团队利器）

Roo Code 支持用 .roomodes 文件把固定工作流固化成模式。在项目根目录建 .roomodes：

1customModes:
2  - slug: review
3    name: 代码审查
4    roleDefinition: 你是严格的代码审查员。只读代码，不修改任何文件。按安全、性能、可维护性三类输出问题清单，每个问题给出文件、行号和修改建议。
5    groups:
6      - read
7      - browser
8  - slug: docs
9    name: 文档撰写
10    roleDefinition: 你是技术文档写作者。根据代码生成中文 API 文档，包含接口说明、参数表格和调用示例。
11    groups:
12      - read
13      - edit

提交进仓库，全组共用同一套模式定义。这是 Roo Code 被团队看重的核心能力——工作流即代码。

团队共享配置

个人配置走 VS Code 的 settings.json，项目约定走 .roomodes，两边分层：

1{
2  "rooCode.apiProvider": "openai-compatible",
3  "rooCode.baseUrl": "https://api.deepseek.com",
4  "rooCode.apiModelId": "deepseek-flash"
5}

注意：API Key 不要提交进仓库，让每个人填自己的，或用环境变量。模型偏好这类团队约定可以放项目级配置，个人实验模型放用户级，互不覆盖。

成本控制

1. 模型分工是最大的省钱项：见上表，Architect 和 Orchestrator 才值得挂 pro
2. 控制自动批准：读操作常开，写文件和执行命令保持手动——Roo 同样支持 Git 检查点回滚，但回滚也要花时间和 token
3. 别在长任务里反复重开对话：DeepSeek 的上下文缓存对连续会话有效，重开等于放弃缓存

与其他方案怎么选

常见问题排查

安全习惯同样重要：Roo Code 能执行终端命令和改文件，重要项目先提交 Git 再让它跑大任务；API Key 别进版本库。