AI API 中转站使用说明：Claude Code / Codex / OpenAI 兼容客户端配置、购买前须知与错误排查。

Cline / Roo Code 配置入口

Cline、Roo Code 等 AI 编程工具接入 OpenAI 兼容 API 中转站的 Base URL、API Key、Model ID、连接测试矩阵与 tool calling 验证。

Cline / Roo Code 配置入口

Cline、Roo Code 这类 VS Code / Cursor 扩展通常不读取 Claude Code 的 ANTHROPIC_BASE_URL，也不读取 Codex 的 ~/.codex/config.toml。它们更常见的接入方式是：在扩展设置里选择 OpenAI Compatible provider，然后填写 Base URL、API Key 和 Model ID。

推荐配置

字段推荐值说明
Provider / API ProviderOpenAI Compatible不选官方 OpenAI 专用项，除非你明确要直连官方 OpenAI
Base URLhttps://YOUR_API_DOMAIN/v1OpenAI 兼容接口常见带 /v1
API Key控制台生成的项目 Key不要提交到 Git、截图或公开文档
Model / Model ID控制台展示的 model id不猜模型名，不复制别的平台教程里的名称

Cline / Roo 连接测试矩阵

工具ProviderBase URLModel ID最小验证 prompt失败时下一跳
ClineOpenAI Compatiblehttps://YOUR_API_DOMAIN/v1控制台展示 model id请只回复“Cline 配置已生效”401 / 429
Roo CodeOpenAI Compatiblehttps://YOUR_API_DOMAIN/v1明确支持 tool calling 的 model id请读取当前目录并说明你看到了什么Model Not Found / tool calling 验证

这张表的重点不是“字段长得一样”，而是 Roo Code 对模型能力要求更高：能聊天，不等于能跑工具。

Cline 配置步骤

  1. 打开 VS Code / Cursor 里的 Cline 面板。
  2. 点击设置齿轮。
  3. API Provider 选择 OpenAI Compatible。
  4. Base URL 填：
https://YOUR_API_DOMAIN/v1
  1. API Key 填控制台生成的 Key。
  2. Model / Model ID 填控制台展示的模型名。
  3. 点击 Verify / 测试连接；如果没有按钮，就发送一句短消息：
请回复“Cline 配置已生效”。

Roo Code 配置步骤

  1. 打开 VS Code / Cursor 里的 Roo Code 面板。
  2. 进入 Roo Code settings。
  3. API Provider 选择 OpenAI Compatible。
  4. Base URL 填：
https://YOUR_API_DOMAIN/v1
  1. API Key 填控制台生成的 Key。
  2. Model 选择或输入控制台展示的模型名。
  3. 先发送短消息验证，再做工具调用验证。

Roo native tool calling：必须单独验证

Roo Code 官方文档强调，它使用 OpenAI native tool calling。也就是说：

  • 模型能普通聊天，不代表 Roo Code 就一定能正常工作；
  • 兼容接口看起来像 OpenAI，不代表 tool calling 已完整实现；
  • 只有在真实工具动作里通过，才能说明这条线路适合 Roo Code。

推荐验证顺序

  1. 聊天验证：
请只回复“Roo 聊天已生效”。
  1. 轻量工具验证：
请读取当前工作区的顶层目录，并告诉我你看到了哪些文件夹。
  1. 约束型工具验证：
请不要修改任何文件，只列出你打算如何检查 package.json 和 src 目录。

如果第 1 步通过、第 2 或第 3 步失败，优先怀疑：

  • 当前模型不支持 OpenAI native tool calling；
  • 兼容接口没有完整实现工具调用；
  • 你填的是能聊天的模型，但不是适合代理 IDE 工具链的模型。

验证顺序

建议按这个顺序排查，别一上来就换模型：

  1. 当前面板确认是 Cline 或 Roo Code，不是 Cursor 原生 AI、Claude Code 或 Codex。
  2. Provider 确认选中 OpenAI Compatible。
  3. Base URL 确认是 https://YOUR_API_DOMAIN/v1，没有多余空格。
  4. API Key 确认来自控制台，且没有复制丢字符。
  5. Model ID 确认和控制台完全一致。
  6. 完全重启编辑器后再测一次，避免旧进程缓存。
  7. Roo Code 额外确认模型支持 OpenAI native tool calling。

常见排错

现象可能原因处理方式
Invalid API Key / 401Key 错、复制不完整、填到了错误扩展重新生成 Key，并确认填在 Cline / Roo 当前 profile
Model Not Found模型名不在账户权限内，或填了别的平台模型别名回控制台复制完整 model id
连接失败Base URL 缺 /v1、网络不可达、服务地址填错改为 https://YOUR_API_DOMAIN/v1 后重启扩展
Cline 能聊但效果异常模型参数或上下文窗口设置不匹配先恢复默认高级参数，只保留 provider / base / key / model
Roo Code 工具调用失败模型不支持 OpenAI native tool calling，或兼容接口 tool calling 实现不完整切换到支持 tool calling 的模型，再测文件读取 / 编辑
改完没反应扩展仍在读旧 profile 或旧进程完全退出 VS Code / Cursor 后重新打开

和其他插件的区别

  • Cursor 原生 AI：看 Cursor API 配置入口
  • Claude Code 扩展：看 ~/.claude/settings.json、Claude Code env 和 IDE Extension settings
  • Codex 扩展：看 ~/.codex/config.toml、provider、profile 和 wire_api
  • Cline / Roo Code：看扩展内 OpenAI Compatible provider 表单

如果你在同一个 Cursor 里装了多个 AI 扩展，排错时先确认当前报错来自哪个面板。不同扩展的登录态和配置文件不会自动同步。

相关页面