常用客户端
支持自定义 OpenAI Provider 的客户端通常都可以接入。界面名称可能不同,但核心字段相同。
OpenAI 兼容客户端
适用于 Cherry Studio、Cline、Roo Code、NextChat 和其他支持自定义 OpenAI Endpoint 的软件:
| 字段 | 推荐值 |
|---|---|
| Provider | OpenAI Compatible / Custom OpenAI |
| API Key | 你的 Codex Relay Key |
| API Base | https://codexapi.asia/v1 |
| Model | /v1/models 返回的准确 ID |
| Endpoint | 优先 Responses;不支持时使用 Chat Completions |
如果软件会自动追加 /v1,API Base 改为 https://codexapi.asia。最终请求路径只应出现一次 /v1。
配置后如何验证
- 关闭客户端内置的官方登录,确保请求使用自定义 Provider。
- 刷新模型列表,确认能看到与
/v1/models一致的模型。 - 先发一个不带工具的短文本请求。
- 再测试流式、工具调用或图像功能。
- 失败时记录 HTTP 状态码和请求 ID,隐藏 API Key 后再提交排查。
软件只显示内置模型
有些客户端不读取服务端模型列表。此时选择“自定义模型”并手动填写准确的模型 ID;如果软件完全不允许自定义模型,则需要更换兼容客户端。
