云智 Token Hub · 文档

配置 Codex

关键路径已验证 更新于 2026-09-13 适用 Codex CLI 0.154+helper 0.1.x
当前状态：Responses API 的 Codex 关键路径已验证 云智网关的 /v1/responses 已支持 Codex 所需的「数组 input + 流式」请求。Helper 会在探测成功后自动放行并写入配置，无需升级。

按官方方式安装 Codex

macOS / Linux / WSL 
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version   # 本教程实测：0.154.0

Windows PowerShell：powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"。npm 备用方式：npm install -g @openai/codex@latest。始终用原渠道更新，不要混用。

Provider 配置结构

Helper 会把 yunzhi Provider 写入用户级 $CODEX_HOME/config.toml：

toml 
cli_auth_credentials_store = "file"
model_provider = "yunzhi"
model = "glm-5.3"

[model_providers.yunzhi]
name = "Yunzhi Token Hub (MaaS)"
base_url = "https://maas.piteyun.com/v1"
wire_api = "responses"

API Key 写入 $CODEX_HOME/auth.json（权限 0600）。cli_auth_credentials_store = "file" 确保 Codex 读取 auth.json 而不是 keyring。写入采用临时文件 + 原子替换，已有其他 Provider 与凭据全部保留。

探测机制 Helper 进入 Codex 菜单时会先探测 /v1/responses：返回 JSON 说明已上线（放行配置流程），返回 HTML 兜底页则明确提示等待。注意云智的 404 页面是 HTTP 200 + HTML，Helper 按 content-type 判断，不看状态码。

验证真实请求（上线后）

  1. 创建空目录，以只读沙箱启动：codex --sandbox read-only -m glm-5.3。
  2. /status 确认活动模型、当前目录与沙箱模式。
  3. 发送：只回复"配置成功"，不要创建、修改或删除任何文件。
  4. /exit 退出，确认目录为空后删除临时目录。

-m 与 --sandbox 只覆盖单次启动，不重写全局配置。返回 402 时先检查控制台额度与密钥有效期，再判断是否为配置问题。

常见问题

设置了 CODEX_HOME 后找不到配置

CLI、IDE 扩展与 Helper 必须使用同一个 CODEX_HOME。Windows 桌面端默认 %USERPROFILE%\.codex，WSL 默认 ~/.codex，不自动共享；需要共享时在 WSL 中 export CODEX_HOME=/mnt/c/Users/<user>/.codex。

提示未登录或认证不可用

检查 auth.json 存在且权限 0600，config.toml 中有 cli_auth_credentials_store = "file"。手动设为 keyring 会导致 Codex 不读取 Helper 写入的凭据。

为什么不能用 wire_api = "chat"

Codex 0.154+ 在加载配置时直接拒绝 chat 协议，这是 Codex 上游移除了该模式。现在云智已上线 /v1/responses，按本页流程配置 wire_api = "responses" 即可。