Codex 配置

把 Codex CLI 指向 FluxToken：装工具、改 config.toml、选对分组。

这页的配置文件路径与字段名以 Codex 官方文档为准

Codex CLI 由 OpenAI 维护，它的配置文件名、路径和字段名会随版本变化。本页给的是常见形态，用来讲清「哪一项填什么」；如果你的版本读取不到配置， 以 Codex 官方文档的当前说明为准，不要照抄这里的字段名硬试。

本文档不写第三方工具的具体版本号，也不保证命令参数——那些会过期。

一、安装

Codex CLI 通常通过 npm 分发：

全局安装 Codex CLI

npm install -g @openai/codex

确认安装成功

codex --version

Node 环境检查在通用准备里。Unsupported engine 就是 Node 版本不够，升级后重装。

包名与安装方式

如果上面的包名在你的环境里拉不到，去 Codex 官方文档确认当前的安装方式—— 它可能改用其他分发渠道。文档这里只保证「它是个 Node/npm 工具」这一点。

二、端点：OpenAI 兼容接口要补 `/v1`

Codex 走的是 OpenAI 兼容接口，地址必须在末尾带 /v1：

国内加速 · OpenAI 兼容https://cn.fluxtoken.ai/v1用于 Codex、OpenAI SDK、Cherry Studio 兼容模式等。

港澳台及境外用户用全球站的对应地址 https://api.fluxtoken.ai/v1。国内加速异常时也可以回退过去。

不要漏掉 /v1

这是 Codex 与 Claude Code 最容易混的地方——两个工具的规则正好相反：

工具	该填的地址	原因
Codex	`https://cn.fluxtoken.ai/v1`	OpenAI 兼容接口，路径里要带 `/v1`
Claude Code	`https://cn.fluxtoken.ai`	Anthropic 兼容接口，客户端自己拼 `/v1`，填根地址

填反了的表现是 404 或连不上。

三、配置 `~/.codex/config.toml`

Codex 读的是用户目录下的 config.toml。核心是要声明一个自定义模型提供方，把它的 base_url 指向 FluxToken，并让它从环境变量里读令牌。

先让令牌能被读到——把令牌写进环境变量：

把令牌写进环境变量

export FLUXTOKEN_API_KEY=sk-你的令牌

然后在 ~/.codex/config.toml 里声明提供方并设为默认：

~/.codex/config.toml

model = "gpt-5.6"model_provider = "fluxtoken"[model_providers.fluxtoken]name = "FluxToken"base_url = "https://cn.fluxtoken.ai/v1"env_key = "FLUXTOKEN_API_KEY"wire_api = "chat"

三处要对照着改：

字段	填什么	注意
`base_url`	`https://cn.fluxtoken.ai/v1`	必须带 `/v1`
`env_key`	`FLUXTOKEN_API_KEY`	写变量名，不是令牌本身
`model`	模型 ID，如 `gpt-5.6`	逐字照抄，见模型列表

wire_api 与字段名别照抄

wire_api 这类字段的取值由 Codex 版本决定（常见取值指向 chat 或 responses 风格的接口）。上面的写法是常见形态，请以 Codex 官方文档为准。如果配好之后报接口形状相关的错误，先来这里对照。

同理，env_key 这个名字也只是常见形态——如果 Codex 用的是别的读法，按官方文档改，令牌串本身不变。

改完配置后要完全退出 Codex 再启动，否则它可能还持有旧配置。

四、分组建议

Codex 走的是 6 个 Codex 分组，这 6 个分组装的模型完全一样（都是那 8 个 GPT 模型），差别只在号池、倍率和调度优先级。所以选分组就是选价格与稳定性的档位。

场景	分组	官方说明（原文）
省钱优先	`【Codex】Pro · 惠享`	Pro 号池 · 性价比优先 · 高峰期可能排队
日常 / 长对话	`【Codex】Pro · 稳享`	Pro 号池 · 稳定优先 · 更适合日常与长对话
质量与稳定优先	`【Codex】满血 · 官Key`	GPT 满血官 key 直连渠道，缓存命中 100%，要求高质量和稳定性的强烈推荐。

【Codex】满血 · 官Key 的「缓存命中 100%」是它最实际的卖点： Codex 每次请求都带完整上下文，缓存命中率直接决定账单，详见缓存优化。

还有两个更便宜的档位，适合试水，但说明里已经写明了会波动：

分组	官方说明（原文）
`【Codex】反代 · 福利`	反代池 · 纯福利，不稳定时切换其他分组
`【Codex】Plus · 轻享`	限时Plus号池 · 价格友好 · 可用性随渠道波动

便宜档的波动是写在说明里的

说明写了「不稳定时切换其他分组」和「可用性随渠道波动」，就真的会波动。 关键任务不要建在这些分组上，出问题时那不叫系统故障，叫选错了档。

完整对比见 Codex / GPT 分组。

五、连通性验证

第一步：不带令牌，期望 401

端点连通性（期望 401）

curl -s -o /dev/null -w '%{http_code}' https://cn.fluxtoken.ai/v1/models; echo

第二步：带令牌，期望 200

令牌与分组（期望 200 与模型清单）

curl -s https://cn.fluxtoken.ai/v1/models -H "Authorization: Bearer sk-你的令牌"

返回的清单就是该分组的可用模型。如果 gpt-5.6 之类不在清单里，就是分组选错了。

第三步：启动 Codex

启动

codex

六、排查顺序

你看到的	先查这里
404	`base_url` 漏了 `/v1`，或端点填成了 Anthropic 的根地址
401	`env_key` 指向的变量没导出、名字拼错，或令牌本身失效
连不上 / 超时	端点选择问题，国内加速异常可回退全球站 · 源站直连https://api.fluxtoken.ai港澳台及境外用户请用此地址；国内加速异常时也可回退到这里。
`模型不存在`	令牌分组不含该模型，或模型 ID 拼错
改了分组没反应	完全退出 Codex 进程再启动

还不行：看服务状态页，按报错原文索引自查，或去 Codex 专题。

Codex 配置 ​

一、安装 ​

二、端点：OpenAI 兼容接口要补 /v1 ​

三、配置 ~/.codex/config.toml ​

四、分组建议 ​

五、连通性验证 ​

第一步：不带令牌，期望 401 ​

第二步：带令牌，期望 200 ​

第三步：启动 Codex ​

六、排查顺序 ​

相关页面 ​