NexoToken 技术指南中心
Codex API 与 Base URL 配置
区分接口根地址、协议路径和模型配置,用最小任务验证 Codex 请求是否真正到达。
配置 Codex API 时,先确认当前客户端使用的兼容协议,再把平台提供的 Base URL 写入对应 provider,而不是同时修改多个地址字段。保存后只运行一个不含敏感数据的最小任务,并用请求时间、模型和用量记录确认配置真正生效。
适用于需要为 Codex CLI 或桌面客户端配置自定义兼容接口、检查 Base URL 和完成首次请求验证的开发者。
最后核验
操作步骤
确认客户端当前版本采用的接口协议和 provider 配置位置。
把真实凭证存入本机环境变量,不写入仓库。
在自定义 provider 中填写平台展示的 Base URL,避免重复追加路径。
从模型广场复制当前模型 ID,不根据展示名猜测。
运行只解释一个短函数的最小任务,并核对平台使用记录。
安全示例
export OPENAI_API_KEY="YOUR_API_KEY"
# Base URL 请从平台当前接入说明复制
# 先运行不修改文件的最小验证任务为 GPT 开启 Codex WebSocket(WSS)
打开 Codex 的 config.toml。macOS 和 Linux 默认在 ~/.codex/config.toml,Windows 默认在 %USERPROFILE%\.codex\config.toml。已接入 NexoToken 的用户,在当前使用的 [model_providers.<名称>] 配置段中添加或更新 supports_websockets = true。保留原来的密钥配置,Base URL 使用 https://www.nexotoken.net/v1,wire_api 使用 "responses"。
首次接入可使用下面的 GPT 示例。先把有该模型权限的 NexoToken API Key 存入本机的 NEXO_API_KEY 环境变量,再从能读取该变量的环境启动 Codex。
model_provider = "nexotoken"
model = "gpt-6.1-sol"
[model_providers.nexotoken]
name = "NexoToken"
base_url = "https://www.nexotoken.net/v1"
wire_api = "responses"
env_key = "NEXO_API_KEY"
supports_websockets = true确认 WSS 已连通
保存后启动新的 Codex 会话。在使用同一份配置和凭证的终端运行 codex doctor --network-only。确认 Responses WebSocket 检查对 wss://www.nexotoken.net/v1/responses 报告握手成功(HTTP 101)。
然后在新会话发一句「只回复 OK」验证 GPT 能正常生成。客户端可以回退到 HTTPS/SSE,因此收到回复只证明模型调用成功。若客户端日志显示已回退到 HTTP,该次请求使用 HTTPS/SSE。
切回普通 HTTPS/SSE
把同一个 provider 配置段中的 supports_websockets 改为 false,保存后重新启动 Codex,并在新会话发一句「只回复 OK」验证。继续使用原来的 Base URL、wire_api、模型和密钥。
查看 OpenAI 官方 Codex 诊断命令说明常见错误与排查顺序
- 401:确认环境变量在当前终端生效,避免打印真实值。
- 404:检查 Base URL 是否重复路径以及模型 ID 是否准确。
- 无记录:确认请求没有落到客户端旧 provider。
- 响应异常:先缩短任务,再分别检查网络、模型和协议。
完成检查清单
- 凭证未进入源码、截图或终端历史。
- Base URL 与客户端协议对应。
- 最小任务获得相关结果。
- 平台记录能对应请求时间与模型。
限制与边界
- 不同 Codex 版本的字段名称可能变化,应以当前客户端文档为准。
- 接口兼容不代表所有模型都支持图片、工具调用或超长上下文。