Bob AI Helper LogoBob AI Helper

OpenAI Codex CLI 如何配置自定义 API 地址

适用于 AI Helper v1.0.88 · Windows 与 macOS · 最后更新 · 作者 TF49

简短回答:在 ~/.codex/config.toml 中声明一个自定义 provider([model_providers.custom],写入 base_url 和存放 Key 的环境变量名 env_key),再把顶层 model_provider 指向它、model 设为模型名。AI Helper 会自动写入这些字段,并把 API Key 放进 CUSTOM_OPENAI_API_KEY 环境变量。

方法一:手动修改 config.toml

打开(或新建)~/.codex/config.toml,Windows 上对应 C:\Users\你的用户名\.codex\config.toml:

model = "gpt-5.6-sol"
model_provider = "custom"

[model_providers.custom]
base_url = "https://你的-api-地址/v1"
env_key = "CUSTOM_OPENAI_API_KEY"

然后把 API Key 设到环境变量 CUSTOM_OPENAI_API_KEY 中(Windows 可在「系统属性 → 环境变量」中添加用户变量;macOS / Linux 可写入 shell 配置文件),重新打开终端后运行 codex。

方法二:用 AI Helper 一键配置

  1. 启动 AI Helper,进入 Codex 面板,AI Helper 会自动探测 codex CLI 的位置。
  2. 选择预置节点或手动填写 API 地址,输入 API Key,选择模型(例如 gpt-5.6-sol)。
  3. 执行流式连通性测试,通过后保存。AI Helper 会写入上面示例中的字段;在 Windows 上,它还会把 Key 写入当前用户的 CUSTOM_OPENAI_API_KEY 环境变量并通知系统刷新。
  4. 重新打开终端并运行 codex,或直接在 AI Helper 中启动 Codex。
AI Helper 只管理名为 custom 的 provider。你在 config.toml 中定义的其他 provider、profile、sandbox 设置都会保留。登录 Bob API 账号使用「一键配置」时,Codex 会使用「Codex-不降质」分组(Bob API 账号下 Codex 专用的令牌分组,分组说明)的 Key,推荐模型为 gpt-5.6-sol。

如何恢复原来的配置

AI Helper 首次修改 Codex 配置前会保存快照,包括 config.toml 和相关环境变量。在设置页使用一键恢复即可还原。

常见问题

Codex 提示找不到 API Key?

Codex 从 env_key 指定的环境变量读取 Key。已打开的终端不会自动获得新设置的环境变量,请关闭后重新打开终端。

返回 model_not_found?

说明当前 API Key 所在的分组或服务商不提供该模型。请从 AI Helper 读取到的模型列表中重新选择模型。

参考:Codex 官方文档

下载 AI Helper

相关教程:Claude Code 切换 API 地址 · Cursor 配置第三方模型