Codex CLI 自定义 API 配置教程：Base URL 与 API Key

开始之前

你需要准备以下三项：

1. 已安装 Codex CLI。安装方式请参考 Codex CLI 官方页面。
2. 一个可用的 API Key。新用户可以先注册 codexinfo.top，已有账号可从顶部导航登录，然后在后台创建 Key。
3. 后台当前支持的模型名。模型会随服务更新，请以价格与模型列表为准。

第一步：创建 API Key

1. 进入 codexinfo.top 后台并登录。
2. 打开 API Key/令牌管理页面。
3. 创建一个新 Key，并妥善保存；页面通常只会完整展示一次。
4. 确认账户有可用额度。

注册并创建 Key

第二步：设置环境变量

Codex 官方配置支持通过 env_key 指定“从哪个环境变量读取 API Key”。本文统一使用 CODEXINFO_API_KEY。

macOS / Linux：当前终端临时生效

export CODEXINFO_API_KEY="sk-你的APIKey"

macOS / Linux：永久保存

如果使用 Zsh，把配置加入 ~/.zshrc；如果使用 Bash，则加入 ~/.bashrc：

echo 'export CODEXINFO_API_KEY="sk-你的APIKey"' >> ~/.zshrc
source ~/.zshrc

Bash 用户把上面的 ~/.zshrc 替换成 ~/.bashrc。

Windows PowerShell：当前窗口临时生效

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

Windows PowerShell：保存到当前用户

[Environment]::SetEnvironmentVariable(
  "CODEXINFO_API_KEY",
  "sk-你的APIKey",
  "User"
)

执行后请关闭并重新打开 PowerShell。

第三步：编辑用户级 config.toml

配置文件位置：

把下面配置加入用户级 config.toml：

model = "gpt-5.5"
model_provider = "codexinfo"

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

gpt-5.5 是本文撰写时后台可见的示例模型。若模型列表发生变化，只需把第一行替换成后台当前可用的精确模型名。

每一项是什么意思？

第四步：验证配置

先确认 Codex CLI 能正常运行：

codex --version

然后进入一个测试目录并启动 Codex：

mkdir codex-api-test
cd codex-api-test
codex

也可以使用非交互命令验证一次请求：

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

成功后，可以在 codexinfo.top 后台查看对应的调用和用量记录。

常见错误排查

401：Invalid token / Unauthorized

• 检查环境变量名称是否与 env_key 完全一致。
• macOS/Linux 运行 echo $CODEXINFO_API_KEY，确认当前终端能读取到变量。
• PowerShell 运行 $env:CODEXINFO_API_KEY。
• 重新复制 Key，避免多余空格、换行或只复制了一部分。
• 永久环境变量设置后，需要重新打开终端。

404：Responses endpoint not found

• 确认 base_url 是 https://api.codexinfo.top/v1。
• 不要把地址写成后台网页地址或遗漏 /v1。
• 确认使用的是支持 Responses API 的接入地址。

Model not found / Unsupported model

• 模型名区分字符，必须与后台列表完全一致。
• 不要直接照搬旧教程中的模型名。
• 打开模型价格页确认当前名称。

429：Too many requests / Insufficient quota

• 检查账户余额和 Key 的剩余额度。
• 确认 Key 是否设置了请求限制、模型限制或 IP 白名单。
• 减少并发请求，稍后重试。

修改配置后没有生效

• 确认编辑的是用户级 ~/.codex/config.toml。
• 检查 TOML 拼写、引号和表名是否正确。
• 关闭当前 Codex 会话，重新打开终端后再启动。
• 不要把自定义提供商只写在项目级 .codex/config.toml。

安全建议

• 不要将 API Key 提交到 Git。
• 不要在教程截图、录屏或报错日志中展示完整 Key。
• 为不同设备或项目创建不同 Key，方便单独撤销。
• 发现泄露后立即删除旧 Key，并创建新 Key。
• 按需设置 Key 的额度、模型和 IP 限制。

常见问题

官方参考

本文配置字段依据 OpenAI Codex Configuration Reference 和 Codex Basic Configuration 校验。可用模型与服务价格以 codexinfo.top 后台实时信息为准。