Codex API 兑换与配置完整教程

Codex API 兑换码怎么用：兑换、生成 Key、写 config.toml，再接入 Codex CLI、Cursor 或 VS Code，附可用模型、配额查询和报错处理。

本教程适用

适用于本站 Codex API 的 10M / 50M / 100M Token 规格，有效期分别为 1 / 2 / 3 天，从兑换时开始计算。接口为 OpenAI 兼容格式，可用于 Codex CLI、Cursor、VS Code 的 Cline 或 Roo Code 扩展、9router 和自写脚本。

开始前准备

在订单详情复制兑换码。

确认已装 Node.js 18 以上：终端执行 node -v 能看到版本号。Codex CLI 通过 npm 安装。

第一步：兑换并激活

打开 Token 和到期时间。

提示无效时，先查有没有多复制空格、字母 O 和数字 0 是否看错，再核对订单；仍失败请联系客服，不要反复提交。

第二步：生成 API Key

打开

App 下拉选你用的工具，比如 Codex CLI；模型下拉选一个可用模型，比如 gpt-5.6-sol。

点生成，复制 sk- 开头的 Key 和页面给出的配置文本。两个都要保存，配置文本下一步要用。

第三步：写进 Codex CLI 配置

打开或新建配置文件：macOS / Linux 为 ~/.codex/config.toml，Windows 为 C:\Users\你的用户名\.codex\config.toml。

粘贴配置页给的文本。最小配置如下，env_key 的变量名可以自己改：

model = "gpt-5.6-sol"

model_provider = "custom"

[model_providers.custom]

name = "custom"

base_url = "

env_key = "CODEX_API_KEY"

wire_api = "responses"

把 Key 放进同名环境变量：

macOS / Linux：export CODEX_API_KEY="sk-你的Key"

Windows PowerShell：$env:CODEX_API_KEY="sk-你的Key"

要长期生效，写进 ~/.zshrc / ~/.bashrc 或系统环境变量。

不想用环境变量，可把 env_key 那行换成 experimental_bearer_token = "sk-你的Key"。这样 Key 会明文写在文件里，不要把文件提交到仓库。

在项目目录执行 codex，让它列出当前目录的文件，能正常返回就接通了。

报错对照：401 多半是 Key 不对或环境变量没生效，重开一个终端再试；404 检查 base_url 是否带了 /v1；model not found 说明模型名与规格不匹配，回配置页重新复制。

第四步：接入 Cursor / VS Code / 9router

Cursor

设置 → Models，展开 OpenAI API Key。

填入 sk-...，打开 Override OpenAI Base URL，填

手动添加模型名，比如 gpt-5.6-sol，选中后发消息测试。

VS Code + Cline / Roo Code

安装扩展后打开设置，API Provider 选 OpenAI Compatible。

Base URL 填 Key 填 sk-...。

Model ID 填 gpt-5.6-sol 或其他可用模型，保存后测试。

9router

Provider → Add OpenAI Compatible，填 Base URL 与 Key，点 Create。

Add API Key 显示 Valid 后保存，再点 Import Model 导入模型。

第五步：查配额与到期时间

在 查看已用 Token、剩余量和到期时间。到期后即使还有 Token 也会停止服务。

可用模型

gpt-6-astra

gpt-6-sol

gpt-5.6-luna

gpt-5.6-terra

gpt-5.6-sol

以配置页下拉列表为准，列表外的名字会报 model not found。

常见问题

codex 启动后仍要求登录 ChatGPT：配置没被读到。确认文件在 ~/.codex/ 下，文件名就是 config.toml，不是 config.toml.txt；model_provider 的值要和 [model_providers.xxx] 的段名一致。

改了配置没生效：Codex CLI 只在启动时读配置，改完退出重开。

401 / 403：Key 失效、环境变量没加载，或复制时带了引号。重新生成 Key 再试。

回复中断或超时：上下文太大。拆小任务，或换更轻的模型。

多台电脑能否共用一个 Key：可以，但共用同一份额度，建议每人一个 Key。

注意事项

Key 只放在本机环境变量或配置文件里，不要提交到 Git，不要贴到公开渠道。

兑换后请马上按上面步骤验证一次，避免临近到期才发现配置有问题。

Token 用尽或到期后请求会被直接拒绝。

仍不通，带订单号、规格和报错截图联系客服。