在 Codex CLI 里使用

在 ~/.codex/config.toml 配置自定义 model_provider（wire_api = responses），并指定模型。

Codex 是 OpenAI 的编程 Agent（CLI 与桌面端）。它支持自定义 model provider，把 provider 指向 OLETOKEN，就能用本站的密钥与模型额度。

准备工作

已创建 API 密钥并保存了完整密钥。
在模型广场挑一个模型 ID。
本机已安装 Node.js 与 npm。

配置

Codex 的自定义 provider 必须写在用户级 ~/.codex/config.toml：项目级 .codex/config.toml 里的 model_provider 与 model_providers 不生效。

model = "gpt-5.6-terra"
model_provider = "oletoken"

[model_providers.oletoken]
name = "OleToken"
base_url = "https://<your-base-url>/v1"
env_key = "OLETOKEN_API_KEY"
wire_api = "responses"

字段	说明
`model`	默认使用的模型 ID
`model_provider`	指向下面定义的 provider 名
`base_url`	OpenAI 兼容地址，要带 `/v1`（Codex 把请求发到 `{base_url}/responses`）
`env_key`	声明存放密钥的环境变量名；密钥不写进配置文件
`wire_api`	目前只支持 `responses`

导出密钥并启动：

export OLETOKEN_API_KEY="YOUR_API_KEY"   # 写进 ~/.zshrc 或 ~/.bashrc 可长期生效
npm i -g @openai/codex
codex

控制台「API 密钥」页的快速接入弹窗里，可以直接下载一份已填好密钥、模型与地址的脚本：它会追加缺失的配置（若 config.toml 里已有 model / model_provider，只提示不擅自改写）。

常见问题

现象	原因与处理
401	`OLETOKEN_API_KEY` 没有导出或值不对——`env_key` 只是声明变量名，密钥要在环境变量里
404	`base_url` 少了 `/v1`
provider 不生效	配置写在了项目级 `.codex/config.toml`，移到用户级 `~/.codex/config.toml`
模型不存在	模型 ID 不是本站已上架的，去模型广场复制
额度不足	先充值后再试

wire_api 目前仅支持 responses——Codex 会把请求发往 {base_url}/responses，请确认你的 Base URL 开放了该端点（未带密钥访问时返回 401 即说明路由存在）。