Skip to main content
Codex CLI 和 Codex App 通过 OpenAI Responses 接入 BetterToken。配置文件是 ~/.codex/config.toml，API Key 通过 BETTERTOKEN_API_KEY 环境变量提供。

​
重点信息

​
准备工作

​
安装

​
命令行配置

BetterToken Automatic setup 脚本会写入 Codex provider 配置。脚本需要 Node.js；如果没有通过参数提供 API Key 或 Model ID，运行时会交互式提示输入。
运行后打开 ~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml），确认 model、review_model 和 BetterToken provider 已正确写入，然后完全重启 Codex。

​
手动配置

GPT、Kimi 和 GLM 使用同一份 config.toml 结构，只需要把 YOUR_MODEL_ID 换成对应提供商的实际 Model ID。命令行一键配置目前仅用于 GPT。

​
设置 API Key

需要长期生效时，把这一行加入 ~/.zshrc 或 ~/.bashrc。
不要把 BetterToken API Key 写入 ~/.codex/auth.json。该文件用于 Codex 官方登录；自定义 provider 应通过 env_key 读取环境变量。

​
配置 config.toml

编辑 ~/.codex/config.toml：
model_provider = "custom" 必须与 [model_providers.custom] 的 table 名一致。将两个 YOUR_MODEL_ID 替换为当前可用的完整 Model ID。

​
验证连接

打开新终端并运行：
发送一条简短任务。能正常流式返回内容，且没有登录、401 或模型不存在错误，即表示配置成功。

​
切换模型

修改 model 和可选的 review_model，保存后结束当前 Codex 进程并重新启动。模型 ID 以 Setup 弹窗或模型广场为准。

​
常见错误

​
进阶配置

​
支持的提供商

状态仅针对本页介绍的 BetterToken 接入方式。
  • 命令行配置 + 手动配置：可以使用生成的一键命令，也可以按照完整步骤手动配置。
  • 手动配置：填写 API Key、Base URL 和 Model。
  • 不支持：当前没有经过验证的直接配置方式。

​
Codex Extension

Codex VS Code Extension 与 CLI/App 共享 config.toml，但保留官方登录时使用不同鉴权配置。请查看 Codex Extension 配置指南。
CLI/App 配置与 Extension 保留官方登录配置是两个方案。不要把两个同名 [model_providers.custom] table 同时粘贴到一个 TOML 文件。

​
相关 FAQ

​
官方参考

​
技术说明

Codex 使用 OpenAI Responses。base_url 填写 https://bettertoken.ai/v1，wire_api 固定为 responses。Codex 会自行请求 /responses。