> 说明：我是 APIVAI 的运营者，下面示例里的地址是 APIVAI 的。配置方法对任何同时兼容 Anthropic 和 OpenAI 格式的网关都一样，换成你自己用的地址即可。

[Roo Code](https://roocodeinc.github.io/Roo-Code/providers/openai-compatible) 是 VS Code 里的开源 AI 编程 Agent，和 Cline 同源，但多了「模式」（Code、Architect、Ask、Debug）和「配置档案」。这两样用好了，可以让规划、写代码、提问各用各的模型，省钱又不降质量。这篇讲接 API 的两种方式、怎么建档案按模式分模型，以及常见报错。

## 两种 Provider 怎么选

| | OpenAI Compatible | Anthropic |
|---|---|---|
| Base URL | `https://api.apivai.com/v1` | `https://api.apivai.com`（不带 `/v1`） |
| 能用的模型 | Claude 和 GPT | 只有 Claude |
| 选模型的方式 | 手动填模型 ID | 从 Roo Code 的列表里选 |
| 优点 | 混用 Claude 和 GPT、能用最新 ID | 自动打提示缓存标记，长会话更省 |

第二列的「提示缓存」值得单独说一下：Roo Code 的 Anthropic 提供方会在系统提示和最近的消息上加 `cache_control`，重复发送的上下文按缓存读取价计费，比完整输入价便宜得多。Agent 每一步都会重发大量上下文，所以**只用 Claude 时，Anthropic 提供方通常更省**。

## 第 1 步：配置 OpenAI Compatible

1. 在 VS Code 打开 Roo Code 面板，点齿轮，进入 **Providers**。
2. **API Provider** 选 **OpenAI Compatible**。
3. 按下表填写并保存。

| 字段 | 值 |
|---|---|
| **Base URL** | `https://api.apivai.com/v1` |
| **API Key** | 你的 Key |
| **Model** | `claude-sonnet-4-6`（或 `GET /v1/models` 返回的任意 ID） |
| **Max Output Tokens** | 8192 或更高（至少 4096） |

Base URL 以 `/v1` 结尾、只出现一次，Roo Code 会自己拼上 `/chat/completions`。**Context Window**、**Image Support**、**Computer Use** 没特别理由就保持默认。Input / Output Price 只影响面板里的费用估算，不影响实际扣费。

Roo Code 只用原生工具调用（function calling），所以选的模型必须支持工具调用，主流的 Claude 和 GPT 模型都可以。

查当前 Key 能用哪些模型 ID：

```bash
curl https://api.apivai.com/v1/models \
  -H "Authorization: Bearer 你的Key"
```

## 第 2 步：再建一个 Anthropic 档案（只用 Claude 时推荐）

1. 在 **Providers** 里点配置档案下拉框旁边的 **+**，起个名字，比如「APIVAI Claude」。
2. **API Provider** 选 **Anthropic**。
3. Key 填进 **Anthropic API Key**。
4. 勾选 **Use custom base URL**，填 `https://api.apivai.com`。
5. 在 **Model** 下拉框里选一个 Claude 模型。

这里**不要**加 `/v1`：Roo Code 把这个地址交给 Anthropic SDK，SDK 会自己拼上 `/v1/messages`，多写一个 `/v1` 就变成 `/v1/v1/messages`，直接 404。

## 第 3 步：按模式分配档案

Roo Code 会记住每个模式上次用的档案，也可以在模式设置里给某个模式指定档案。比较合理的分工：

| 模式 | 推荐模型 | 理由 |
|---|---|---|
| Architect（规划） | `claude-opus-5-5` | 规划错了后面全白干，值得用最强的 |
| Code / Debug | `claude-sonnet-4-6` 或 `claude-sonnet-5-5` | 日常主力，性价比最好 |
| Ask（提问） | `claude-haiku-4-5` 或 `gpt-6-luna` | 只是问问题，便宜快就行 |

所有档案可以共用同一个 Key。某个任务在 Sonnet 上反复兜圈子时，临时把这个任务切到 Opus，而不是把 Opus 设成默认。GPT 模型只能走 OpenAI Compatible 档案。

## 常见报错

- **401 / Key 无效**：Key 没复制全，或者已经被删了。用 Anthropic 提供方时确认勾了 **Use custom base URL**，否则 Key 会直接发给 Anthropic 官方。
- **402 / insufficient_quota**：这个 Key 的预算用完了，或者剩得太少、不够贵的模型（Opus、Sonnet 4.6 等）发一次请求。Architect 模式用 Opus 时最容易碰到，给 Key 加点预算，或者先换便宜的模型。Key 在还剩一点钱时就会停用，这部分不会丢，删掉 Key 会退回账户余额。
- **404**：`/v1` 写错了。OpenAI Compatible 填 `https://api.apivai.com/v1`，结尾不要加 `/chat/completions`；Anthropic 填 `https://api.apivai.com`，不带 `/v1`。
- **找不到模型**：用准确的模型 ID（如 `claude-sonnet-4-6`），不是显示名称，用 `GET /v1/models` 核对。
- **工具调用报错**：换一个支持 function calling 的模型。
- **回复为空或被截断**：思考默认开启，会占输出 token，把 **Max Output Tokens** 调到 8192（至少 4096）。
- **429**：默认每个 Key 每分钟 60 次请求，长任务容易碰到，稍等一下或者多建几个 Key 分开用。

有问题欢迎评论区交流。


说明：我是 APIVAI 的运营者，下面示例里的地址是 APIVAI 的。配置方法对任何同时兼容 Anthropic 和 OpenAI 格式的网关都一样，换成你自己用的地址即可。

Roo Code 接入 Claude / GPT API：两种 Provider 怎么填、按模式分配模型

Roo Code 接入 Claude 和 GPT 的两种方式：OpenAI Compatible 与 Anthropic 提供方怎么填、Base URL 要不要带 /v1，用配置档案按模式分配模型，以及 401、402、404 等常见报错。

开发工具

人工智能

后端

RooCode接入APIVAI网关的完整教程：教你配置OpenAI Compatible和Anthropic两种Provider，按模式分配Claude/GPT模型节省成本。涵盖BaseURL填写、提示缓存优势、报错排查（401/402/404等），实现规划用Opus、编码用Sonnet、提问用Haiku的最优分工。

代码解释

AI编程

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Roo Code 接入 Claude / GPT API：两种 Provider 怎么填、按模式分配模型-腾讯云开发者社区-腾讯云

Roo Code 接入 Claude / GPT API：两种 Provider 怎么填、按模式分配模型

Roo Code 接入 Claude / GPT API：两种 Provider 怎么填、按模式分配模型

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐