工具教程
Codex API 配置与供应商切换教程
使用 NexoX 管理 Codex 的 API 地址、模型与供应商配置,区分 Responses 直连和协议转换,了解切换后的验证与排错方法。
快速回答
在 NexoX 中选择 Codex,添加供应商并填写 API 地址、密钥和模型,确认上游格式后启用。原生 Responses 服务可以直连;其他上游格式需要本地路由转换。切换后重启对应 Codex 进程并发起测试请求。
NexoX 桌面客户端的供应商配置流程;具体字段以已安装版本为准。
Codex 连接供应商需要哪些信息?
准备能够启动的 Codex 客户端、NexoX,以及供应商提供的 API 地址、密钥和模型 ID。这篇教程针对第三方 API 供应商配置;官方账号登录应使用对应官方预设。
最关键的是确认协议。Codex 的 Responses 请求需要上游原生支持,或由 NexoX 本地路由转换为上游接受的格式。不能因为供应商支持 Chat Completions,就直接假定它支持 Responses。
如何配置 API 地址、模型和上游格式?
同一家供应商的不同端点或套餐可能采用不同协议。优先使用匹配的预设,自定义连接则需要逐项核对。
- 在 NexoX 中选择 Codex,打开添加供应商面板。
- 选择对应预设或自定义连接,填写名称、API 地址和 API Key。
- 填写默认模型,模型 ID 应来自所选供应商的可用模型列表。
- 确认上游格式;需要协议转换时开启本地路由,并为 Codex 启用路由。
- 保存并启用供应商,重新启动实际使用的 Codex 进程。
| 上游格式 | 连接方式 |
|---|---|
| Responses | 原生格式可直接连接,无需为了协议转换开启本地路由。 |
| Chat Completions | 需要开启本地路由,将 Codex 请求与供应商响应进行转换。 |
| Anthropic Messages | 需要开启本地路由转换,不能直接作为 Codex 的 Responses 端点。 |
如何验证 Codex 已经使用新配置?
确认 NexoX 中的当前供应商,然后结束旧的 Codex 进程并重新启动。单纯在旧会话中继续发送消息,不足以证明启动配置已更新。
常规配置位于 ~/.codex/config.toml。NexoX 的当前实现会把第三方供应商密钥写入其供应商配置的 experimental_bearer_token 字段;官方账号登录凭据由另一套认证流程管理。自定义配置目录时,以实际目录设置为准。
检查 model_provider、默认模型和供应商 base_url 是否与预期一致,再发起一个简短请求。下面仅展示字段关系,使用 NexoX 时无需手工覆盖文件,也不要分享包含真实密钥的配置。
model_provider = "custom"
model = "YOUR_MODEL_ID"
[model_providers.custom]
name = "My provider"
base_url = "https://api.example.com/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"切换不生效或请求报错怎么办?
先确认报错来自配置读取、认证、模型选择还是上游协议,再针对具体原因处理。重新添加最新版预设有助于排除旧预设快照的问题,但不会修复供应商自身的服务故障。
| 现象 | 优先检查 |
|---|---|
| 仍使用旧连接 | 是否重启了 Codex 进程,以及 NexoX 和 Codex 是否读取同一配置目录。 |
| 401 / 403 | API Key、认证配置、账号权限,以及是否混用了官方登录与第三方凭据。 |
| 404 / Responses 不可用 | 供应商是否提供 Responses;若只提供其他协议,检查上游格式和路由接管。 |
| 模型不存在 | 默认模型 ID 是否有效,以及设置的模型映射是否符合供应商能力。 |
| 连接本机端口失败 | 选择路由模式时,确认 NexoX 本地路由仍在运行。 |
常见问题
为什么支持 OpenAI 兼容接口的供应商仍然报错?
OpenAI 兼容不一定包含 Responses。供应商可能只支持 Chat Completions,此时应选择对应上游格式并启用 NexoX 本地路由转换。
切换 Codex 供应商后需要重启吗?
常规配置切换后应重启实际使用的 Codex 进程,以便重新读取配置。使用本地路由时,供应商切换可作用于后续请求,但模型变更仍可能需要重启。