开始之前
在 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 进程，以便重新读取配置。使用本地路由时，供应商切换可作用于后续请求，但模型变更仍可能需要重启。