OpenAI Codex CLI 如何配置自定义 API 地址
简短回答:在 ~/.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 一键配置
- 启动 AI Helper,进入 Codex 面板,AI Helper 会自动探测
codexCLI 的位置。 - 选择预置节点或手动填写 API 地址,输入 API Key,选择模型(例如
gpt-5.6-sol)。 - 执行流式连通性测试,通过后保存。AI Helper 会写入上面示例中的字段;在 Windows 上,它还会把 Key 写入当前用户的
CUSTOM_OPENAI_API_KEY环境变量并通知系统刷新。 - 重新打开终端并运行
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 读取到的模型列表中重新选择模型。