简短回答
在 Roo Code 中使用 APIVAI：打开 Roo Code 设置，进入 Providers，把 API Provider 设为 OpenAI Compatible，Base URL 填 https://api.apivai.com/v1，把 APIVAI 密钥粘贴到 API Key，再填写模型 ID，例如 claude-sonnet-4-6 或 gpt-5.5。如果只用 Claude，也可以选择 Anthropic 提供方，勾选 Use custom base URL 并填入不带 /v1 的 https://api.apivai.com，因为 Roo Code 的 Anthropic 客户端会自己加上 /v1/messages。截至 2026-10-07，通过 APIVAI 使用 Claude Sonnet 4.6 每百万输入 / 输出 token 为 $1.04 / $5.22，官方价为 $3.00 / $15.00。费用按 token 从预付余额扣除，无需订阅。
Roo Code 是什么？为什么要用自己的 API 密钥？
Roo Code 是一个开源的 VS Code AI 编程 Agent。它按模式工作，例如 Code、Architect 和 Ask，会读取和修改项目文件，并在你批准后运行命令。Roo Code 本身不带模型：你需要接入一个 API 提供方，任务中的每一步都是一次由该提供方计费的请求。
APIVAI 提供一个可调用 Claude 和 GPT 模型的密钥，按 token 计费且低于官方标价，从你自己充值的余额中扣除。同一个密钥同时支持 OpenAI 格式和 Anthropic 格式，因此适用于 Roo Code 中这两种提供方；你还可以给每个模式分配不同的模型，而不用管理多个账号。
在 Roo Code 中应该选哪个 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 | 长时间的 Claude 会话 |
选 OpenAI Compatible：需要 GPT 模型，或者要用 Roo Code 内置列表里还没有的 Claude ID。选 Anthropic：只用 Claude。Roo Code 的 Anthropic 提供方会在系统提示和最近的消息上加 cache_control 标记，重复的上下文可以按缓存读取价计费，Claude Sonnet 4.6 为每百万 token $0.10，而不是完整的输入价。缓存写入为每百万 $1.31。借助配置档案（见下文），两种方式可以同时保留，按模式切换。
如何一步步把 Roo Code 接入 APIVAI？
第 1 步：创建 APIVAI 密钥
- 在 apivai.com 用邮箱注册。
- 充值 $10 起，支持银行卡、加密货币、支付宝和微信支付。没有免费试用，也没有订阅。
- 在控制台创建密钥并复制。如果想严格限制 Roo Code 的花费，可以给密钥设置预算上限。
第 2 步：配置 OpenAI Compatible 提供方
- 在 VS Code 中打开 Roo Code 面板，点击齿轮图标，进入 Providers。
- 在 API Provider 中选择 OpenAI Compatible。
- 按下表填写并保存。
| 字段 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.apivai.com/v1 |
| API Key | 你的 APIVAI 密钥 |
| Model | claude-sonnet-4-6（或 GET /v1/models 返回的任意 ID） |
| Max Output Tokens | 8192 或更高（至少 4096） |
| Input Price / Output Price | 可选：Claude Sonnet 4.6 填 $1.04 / $5.22 |
Base URL 以 /v1 结尾且只出现一次；Roo Code 会自动加上 /chat/completions。模型设置里还有 Context Window、Image Support 和 Computer Use，没有特别理由就保持默认。价格字段只改变 Roo Code 显示的费用估算，实际扣费以控制台为准。
Roo Code 只使用原生工具调用，所以模型必须支持 function calling。APIVAI 在 /v1/chat/completions 上支持工具调用，下文推荐的 Claude 和 GPT 模型也都支持。
查看你的密钥可用哪些 ID：
curl https://api.apivai.com/v1/models \ -H "Authorization: Bearer YOUR_APIVAI_KEY"
模型会随时间上新或下线，请从这个列表或价格页复制 ID。
第 3 步（可选）：为 Claude 添加 Anthropic 配置档案
- 在 Providers 中点击配置档案选择框旁边的 + 按钮，给新档案命名，例如“APIVAI Claude”。
- 把 API Provider 设为 Anthropic。
- 把 APIVAI 密钥粘贴到 Anthropic API Key。
- 勾选 Use custom base URL，填入
https://api.apivai.com。 - 在 Model 下拉框中选择一个 Claude 模型。
不要加 /v1：Roo Code 会把这个地址交给 Anthropic SDK，SDK 自己会加上 /v1/messages，填 https://api.apivai.com/v1 会变成 /v1/v1/messages，返回 404。Anthropic 格式的说明见 Claude API 代理页面。
第 4 步：给每个模式分配配置档案
Roo Code 会记住每个模式上次使用的配置档案，也可以在模式设置中为某个模式明确指定档案。比较合理的分工：Architect（规划）用 Claude Opus 5.5，Code 用 Claude Sonnet 4.6，Ask 用便宜的 Claude Haiku 4.5 或 GPT-6 Luna。所有档案都可以使用同一个 APIVAI 密钥。
在 Roo Code 中该选哪个模型？
每百万输入 / 输出 token 价格，截至 2026-10-07：
| 模型 ID | 价格（输入 / 输出） | 适合的模式 |
|---|---|---|
claude-sonnet-4-6 | $1.04 / $5.22 | Code、Debug：日常默认 |
claude-sonnet-5-5 | $0.69 / $3.47 | Code：更新的 Sonnet |
claude-opus-5-5 | $1.39 / $6.96 | Architect、最难的 bug |
claude-haiku-4-5 | $0.35 / $1.74 | Ask、小改动 |
gpt-6-sol | $0.30 / $1.52 | Code 或代码审查的 GPT 方案 |
gpt-6-luna | $0.0144 / $0.0768 | 非常便宜的提问 |
GPT 模型需要使用 OpenAI Compatible 提供方。如果某个任务在 Sonnet 上反复兜圈子，就把这个任务的档案切到 Opus，而不是把 Opus 设为默认。
Roo Code 配合 APIVAI 要花多少钱？
Roo Code 任务的每一步都会重新发送对话和已读取的文件，所以输入 token 占大头。两个计算示例：
- 一个 Code 模式任务，使用 Claude Sonnet 4.6：约 25 次请求，每次约 35,000 输入和 2,000 输出 token。费用：APIVAI $1.17，官方价 $3.38。
- 一个工作月，每天三个这样的任务，共 22 天（1,650 次请求）：APIVAI $77.29，官方价 $223。如果每天 20 个 Ask 提问交给 Claude Haiku 4.5（每次 8,000 输入、800 输出 token，每月 440 次），只增加 $1.84。
以上数字未计入提示缓存；使用 Anthropic 提供方时，缓存会降低重复上下文的费用。思考 token 按输出 token 计费。每次请求的真实数据都在控制台里。更全面的对比见 2026 年 Claude API 价格对比。
Roo Code 常见报错怎么解决？
- 401 / 密钥无效： 密钥不完整、已删除或超出预算上限，请在控制台检查。使用 Anthropic 提供方时，确认已勾选 Use custom base URL，否则密钥会直接发给 Anthropic。
- 404 Not Found：
/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 Too Many Requests： 每个密钥默认每分钟 60 次请求。稍等片刻，或联系客服提高限额。
请求格式的更多说明见文档和 OpenAI 兼容 API 页面。
常见问题
在 Roo Code 中能用一个密钥同时使用 Claude 和 GPT 吗？
可以。一个 APIVAI 密钥适用于所有模型。可以每个模型建一个配置档案，也可以在 OpenAI Compatible 档案中修改 Model 字段。
选 OpenAI Compatible 还是 Anthropic 提供方？
GPT 模型以及 Roo Code 列表中没有的模型 ID 用 OpenAI Compatible。只用 Claude 时选 Anthropic，Roo Code 会请求提示缓存；基础地址不要带 /v1。
不同模式能用不同模型吗？
可以。Roo Code 把配置档案和模式关联起来，Architect 可以用 Opus，Code 用 Sonnet，全部使用同一个密钥。
APIVAI 会保存我的代码吗？
不会。请求和响应的内容不会被记录，只保留模型、token 数和费用等用于计费的使用数据。
同样的配置能用在 Cline 里吗？
几乎完全一样。请看 Cline 配置教程，字段名和地址都相同。
注册账号，充值 $10 起，把密钥粘贴到 Roo Code 即可。