Roo Code API 配置完整教程：VS Code AI 编程插件接入 Claude/GPT/Gemini（2026）
先说结论
- 主用 Claude 系列：选 Anthropic Provider，Base URL 填
https://api.ofox.ai/anthropic - 混用 GPT / Gemini / DeepSeek 等：选 OpenAI Compatible，Base URL 填
https://api.ofox.ai/v1 - Model ID 必须带
provider/前缀（anthropic/claude-sonnet-4.6），不带就 404 - Profile 功能可以存多套配置按需切换，这是 Roo Code 相比 Cline 用起来更顺手的地方
Roo Code 是什么
Roo Code 前身叫 Roo Cline，从 Cline fork 出来的 VS Code 扩展。定位和 Cline 差不多——不是普通的代码补全插件，更像是跑在编辑器里的 AI Agent，可以自主读写文件、执行终端命令、多步骤完成任务。
和 Cline 分道扬镳的地方在于多角色协作。Roo Code 内置了几种工作模式：Architect 负责架构设计、Code 负责编码实现、Ask 用来问问题、Debug 专门处理报错，每个 Mode 可以绑定不同的模型和系统提示。这样可以把贵的模型留给真正需要推理的任务，简单的问答用便宜的跑。Profile 管理也是这个逻辑——存几套配置，工作环境和个人项目分开用，不用每次手改。
Boomerang 是另一个特性：主任务可以自动拆分成子任务分配给不同 Mode 处理，适合跨文件重构这类工作。
BYOK 是前提——Roo Code 不提供内置模型，你得自己带 API Key。
安装
VS Code 扩展市场直接搜索 Roo Code 安装。安装后，左侧活动栏出现 Roo Code 图标，点击打开侧边栏。
首次使用会提示配置 API Provider。
准备 API Key
国内使用 Roo Code，最直接的方案是通过 OfoxAI 获取 API Key。一个 Key 可以调用 Claude Sonnet 4.6/Opus 4.6、GPT-5.4/mini/nano、Gemini 3.1 Pro/Flash、DeepSeek V4、Kimi、Qwen3 等 80+ 模型，支持 OpenAI 和 Anthropic 双协议，人民币按量充值。
注册后在控制台创建一个 API Key，复制备用。
配置方式一：OpenAI Compatible
混用多家模型、或者主要用非 Claude 模型的情况选这个。
Roo Code 侧边栏 → 齿轮图标 → API Provider 选 OpenAI Compatible，填入：
| 字段 | 值 |
|---|---|
| Base URL | https://api.ofox.ai/v1 |
| API Key | 你的 OfoxAI API Key |
| Model ID | anthropic/claude-sonnet-4.6 |
Model ID 必须带 provider/ 前缀。填 claude-sonnet-4.6 会 404，要填 anthropic/claude-sonnet-4.6。前缀是告诉网关转发给哪个供应商的。
其他常用模型 ID：
| 模型 | Model ID |
|---|---|
| Claude Sonnet 4.6 | anthropic/claude-sonnet-4.6 |
| Claude Opus 4.6 | anthropic/claude-opus-4.6 |
| Claude Haiku 4.5 | anthropic/claude-haiku-4.5 |
| GPT-5.4-mini | openai/gpt-5.4-mini |
| Gemini 3.1 Flash | google/gemini-3.1-flash-lite-preview |
| DeepSeek V4 | deepseek/deepseek-chat |
配置方式二：Anthropic Provider（主用 Claude 选这个）
主要用 Claude 的话选 Anthropic Provider。原因很简单：Roo Code 的文件操作、命令执行、多步推理都重度依赖 Tool Use，而 Anthropic 原生协议对 Tool Use 的支持比 OpenAI 协议要完整不少。OpenAI Compatible 能用，Anthropic 方式更稳。
设置 → API Provider 选 Anthropic，填入：
| 字段 | 值 |
|---|---|
| Base URL | https://api.ofox.ai/anthropic |
| API Key | 你的 OfoxAI API Key |
| Model | anthropic/claude-sonnet-4.6 |
两种方式对比：
| 对比项 | OpenAI Compatible | Anthropic Provider |
|---|---|---|
| Base URL | https://api.ofox.ai/v1 | https://api.ofox.ai/anthropic |
| 可用模型 | Claude + GPT + Gemini + 全部 | Claude 系列 |
| Tool Use | 基本可用 | 完整支持 |
| 最适合 | 多模型混用 | 专注 Claude |
Profile 配置管理
Profile 是 Roo Code 比 Cline 用着更顺手的地方。存几套 API 配置，切换时点一下就好，不用进设置页面改来改去。
我自己的用法：两个 Profile，“日常”和”省钱”。日常 Profile 默认 Claude Sonnet 4.6，Opus 4.6 留给真正复杂的任务；省钱 Profile 把默认换成 GPT-5.4-mini，只有明确需要 Claude 的时候才手动切换。
Roo Code 设置 → Configuration Profiles 区域 → + Add Profile，命名后为这个 Profile 独立配置 API Provider 和默认模型。
各 Mode 的模型搭配
Mode 功能的实际价值就是省钱。不是每个任务都需要 Opus，问个简单问题用 Opus 是在烧钱。
实测下来比较合理的搭配：
| Mode | 推荐模型 | 原因 |
|---|---|---|
| Architect | anthropic/claude-opus-4.6 | 架构决策不省这个钱 |
| Code | anthropic/claude-sonnet-4.6 | 编码均衡，日常主力 |
| Ask | openai/gpt-5.4-mini | 简单问答没必要上大模型 |
| Debug | anthropic/claude-sonnet-4.6 | 调试要读代码，Sonnet 够用 |
| Orchestrator | anthropic/claude-opus-4.6 | 任务拆解需要上下文理解 |
Code Mode + Claude Sonnet 占了日常工作量的大头。Opus 真正用到的机会不多，别随手就挂上去。
验证配置
在 Roo Code 对话框输入：
读取项目根目录的 package.json，列出主要依赖项Roo Code 应该主动去读文件，而不是口头告诉你怎么操作。如果它只是说”你可以打开 package.json 查看”而没有实际读取，Tool Use 没有正常工作——换 Anthropic Provider 试试。
常见报错
404 / 模型找不到：Model ID 没带 provider/ 前缀。去 OfoxAI 模型列表 核对完整 ID。
401 认证失败：Key 填错或失效。回控制台确认，复制时注意别截掉开头结尾。
Tool Use 不生效，Roo Code 光说不做：切换到 Anthropic Provider。已经是 Anthropic Provider 的话，检查 Base URL 是 https://api.ofox.ai/anthropic 还是 /v1——填成 /v1 就没有原生 Tool Use 支持了。
响应慢：Opus 4.6 本来就比 Sonnet 慢，长任务正常。真的超时的话换 Sonnet，或者在设置里调大超时阈值。
429 限流：OfoxAI 默认 200 RPM，Roo Code 跑复杂任务会连续发多个请求，偶尔碰到很正常，等几秒就好。频繁触发可以联系 OfoxAI 申请提额。
跟同类工具的区别
用 VS Code 的话，Roo Code、Cline、OpenClaw 三个都能接 OfoxAI API，同一个 Key 通用。
Roo Code 的优势是 Mode + Profile 组合，适合工作流比较固定、有多种任务类型要处理的开发者。Cline 更简单直接，上手快，没那么多要配置的东西。OpenClaw 不依赖 VS Code，是终端工具，适合喜欢命令行的场景。
更多对比见 2026 AI 编程工具大横评。Cline 的配置可以看 Cline VS Code API 配置教程，命令行工具看 OpenClaw 国内配置指南。
