从注册到第一次请求，完整跑通 Codex API

一、先判断这种 API 方式是否适合你

如果你需要在 Codex CLI、Cursor、OpenAI SDK 或自动化脚本中按请求调用模型，自定义 API 是合适的使用方式。ChatGPT 账号或订阅与 API 用量不是同一个计费入口；这里使用的是独立的 API 额度和 API Key。

• 希望使用自定义 Base URL，而不是只在网页中对话
• 需要查看请求记录、余额和 Key 使用情况
• 愿意按实际 API 调用消耗额度

二、注册账号，不要先绕到登录页

如果系统要求邮箱验证码，按页面提示完成验证。注册成功后登录后台，即可看到余额、充值、API Key 和用量记录。

三、充值前看清额度和实付金额

支付成功后再进入下一步。若支付页面未打开或订单失败，可在订单记录中确认状态；不要连续重复支付同一笔订单。

四、创建 API Key 并只保存一次

export CODEXINFO_API_KEY="sk-你的APIKey"

Windows PowerShell 当前窗口可以使用：

$env:CODEXINFO_API_KEY="sk-你的APIKey"

五、在用户级 config.toml 配置自定义提供商

打开 ~/.codex/config.toml，加入下面的配置。把模型名替换为后台当前模型列表中的准确名称。

model = "从后台复制准确模型名"
model_provider = "codexinfo"

[model_providers.codexinfo]
name = "codexinfo.top API"
base_url = "https://api.codexinfo.top/v1"
env_key = "CODEXINFO_API_KEY"
wire_api = "responses"

根据当前 Codex 配置规则，提供商、Base URL 和认证属于用户级配置，不能依赖项目里的 .codex/config.toml 去重定向认证。这样也能避免把机器级密钥设置提交到项目仓库。

六、完成第一次请求

codex exec "只回复：连接成功"

如果返回正常，说明 Base URL、Key、模型名和 Responses API 路径已经连通。随后再进入真实项目，避免把配置问题和项目问题混在一起排查。

七、最常见的四个问题

401：API Key 无效

确认环境变量名称与 env_key 完全一致，重新打开终端后还要确认变量仍然存在。

404：Base URL 或接口路径错误

Base URL 使用 https://api.codexinfo.top/v1，不要填控制台地址，也不要手工再追加错误的响应路径。

模型不存在

从后台当前模型列表复制完整名称。模型会更新，旧教程中的名称不一定一直有效。

429 或余额不足

先检查余额、速率限制和请求记录。不要在客户端无限重试，否则只会放大错误。

需要更细的错误排查，可以继续阅读《Codex CLI 自定义 API 配置教程》。

八、购买前应该比较什么

• 目标地区能否稳定访问 API，而不只是能打开首页
• 是否支持 Codex 使用的 Responses API
• 模型名、价格和额度记录是否能在后台实时查看
• Key 是否可以单独创建、撤销和查看用量
• 支付失败或请求异常时是否有明确的客服入口

官方配置依据

本文关于用户级配置、自定义模型提供商、base_url、env_key 与 Responses API 的说明，依据 OpenAI Codex 官方配置文档核对：

• Codex Basic Configuration
• Codex Configuration Reference