OpenAI 兼容客户端怎么选？先看配置矩阵
只有当前官方文档明确支持自定义端点或 Base URL 的客户端，才列入这份清单。先看矩阵，再用 /v1/models 验证 Key；不要一上来就在客户端界面里反复试错。
哪些客户端有明确的自定义端点配置？
下表按 2026-08-02 的官方文档逐项核对。“已核对”只表示客户端或 SDK 提供 Base URL / 自定义 provider 字段，不代表每个模型都支持工具调用、图片、流式输出或客户端偏好的 API transport。
| 客户端 | 已核对的配置入口 | 需要注意的边界 |
|---|---|---|
| Cline | OpenAI Compatible、Base URL、API Key、Model ID | 仍需核对模型能力 |
| Roo Code | OpenAI Compatible、Base URL、API Key、Model ID | 要求原生 OpenAI 风格工具调用 |
| Codex CLI | model_providers、base_url、env_key、wire_api | 网关必须支持选定的 wire API |
| Hermes Agent | Custom Endpoint 向导或命名 provider | transport 和模型要与端点匹配 |
| OpenAI Python SDK | base_url 参数或 OPENAI_BASE_URL | 由应用选择 Responses 或 Chat Completions |
配置前应该先验证什么？
先在客户端外测试 API。使用准备保存到客户端的同一个 Key，再从响应中复制完整模型 ID，不要凭记忆填写。
curl https://monkeytheme.com/v1/models \ -H "Authorization: Bearer ***"
| 响应 | 说明 |
|---|---|
| 200 且返回模型列表 | 端点与 Key 可以完成模型发现 |
| 401 JSON | 路由可达，但凭据缺失或被拒绝 |
| 404 或 HTML | 检查路径，以及客户端是否会自动追加 /v1 |
Cline 和 Roo Code 要填哪些字段？
两个项目的官方文档都列出了四个基础字段：选择 “OpenAI Compatible”，填写 Base URL、API Key 和 Model ID。MonkeyAI 可从 https://monkeytheme.com/v1 开始。
Roo Code 还有一条明确限制：它只使用原生工具调用，没有 XML fallback。某个模型即使能正常聊天，只要不支持 OpenAI 兼容的 function calling，仍然无法作为 Roo 编程 Agent 使用。
Codex CLI、Hermes 和 SDK 应用有什么区别？
Codex CLI 与 Hermes 是可配置的 Agent runtime，并非普通桌面聊天工具。Codex 自定义 provider 有 wire_api；Hermes 会询问 transport。填写的值必须与网关实际实现一致。
OpenAI Python SDK 更底层。其 README 明确提供 base_url 构造参数和 OPENAI_BASE_URL 环境变量；具体调用哪个 API、密钥保存在哪里，仍由应用代码决定。
为什么 Claude Code 不在 OpenAI 兼容矩阵里？
Claude Code 可以接入 LLM gateway，但 Anthropic 当前文档说明的是受支持的 API format 与 ANTHROPIC_BASE_URL。只有 OpenAI 兼容端点还不够；网关必须提供 Claude Code 所需的 Anthropic 协议，或完成正确转换。
请使用单独的 Claude Code API Gateway 教程，不要直接套用本页的 OpenAI 客户端字段。
本轮核对的官方资料
常见问题
OpenAI 兼容客户端应该怎么选？
VS Code 编程 Agent 可选 Cline 或 Roo Code；终端 Agent 可选 Codex CLI 或 Hermes；自己开发应用时使用 OpenAI SDK。
MonkeyAI 的 Base URL 填什么？
从 https://monkeytheme.com/v1 开始；如果客户端明确会自动追加 /v1，则按其说明填写。
/v1/models 返回 200 就能证明工具调用可用吗？
不能。它只能验证端点、凭据和模型发现；工具调用与流式输出需要用选定模型发起真实请求。
为什么普通聊天正常，Roo Code 仍可能失败？
Roo Code 要求原生 OpenAI 兼容工具调用。只支持聊天或兼容层不完整的模型无法满足此要求。
Claude Code 能直接套用 OpenAI 兼容配置吗？
不能直接套用。Claude Code 需要受支持的 gateway API format，通常是 Anthropic 协议，或能够正确转换协议的网关。