跳到主要内容
NexoToken
← 返回指南中心

NexoToken 技术指南中心

Codex API 与 Base URL 配置

区分接口根地址、协议路径和模型配置,用最小任务验证 Codex 请求是否真正到达。

配置 Codex API 时,先确认当前客户端使用的兼容协议,再把平台提供的 Base URL 写入对应 provider,而不是同时修改多个地址字段。保存后只运行一个不含敏感数据的最小任务,并用请求时间、模型和用量记录确认配置真正生效。

适用范围

适用于需要为 Codex CLI 或桌面客户端配置自定义兼容接口、检查 Base URL 和完成首次请求验证的开发者。

最后核验

操作步骤

  1. 确认客户端当前版本采用的接口协议和 provider 配置位置。

  2. 把真实凭证存入本机环境变量,不写入仓库。

  3. 在自定义 provider 中填写平台展示的 Base URL,避免重复追加路径。

  4. 从模型广场复制当前模型 ID,不根据展示名猜测。

  5. 运行只解释一个短函数的最小任务,并核对平台使用记录。

安全示例

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 诊断命令说明

常见错误与排查顺序

  1. 401:确认环境变量在当前终端生效,避免打印真实值。
  2. 404:检查 Base URL 是否重复路径以及模型 ID 是否准确。
  3. 无记录:确认请求没有落到客户端旧 provider。
  4. 响应异常:先缩短任务,再分别检查网络、模型和协议。

完成检查清单

  • 凭证未进入源码、截图或终端历史。
  • Base URL 与客户端协议对应。
  • 最小任务获得相关结果。
  • 平台记录能对应请求时间与模型。

限制与边界

  • 不同 Codex 版本的字段名称可能变化,应以当前客户端文档为准。
  • 接口兼容不代表所有模型都支持图片、工具调用或超长上下文。