Skip to content

Codex CLI 接入自定义 API ​

Codex CLI 通过用户级配置文件 ~/.codex/config.toml 定义模型供应商。接入 NiceAI 只需要新增一个自定义供应商,并把密钥放进环境变量。

如果你已经装了 CC Switch,可以直接用 CC Switch 一键导入,不用手动改配置。下面是手动配置的方法。

准备工作 ​

  1. 安装 Codex CLI(参考其官方文档)。
  2. 在 NiceAI 控制台「API 密钥」页面创建密钥,分组选择 OpenAI。

1. 编辑 config.toml ​

配置文件位置:

  • macOS / Linux:~/.codex/config.toml
  • Windows:%USERPROFILE%\.codex\config.toml

加入以下内容(已有的配置保留,同名项替换):

toml
model = "<模型名,见模型广场>"
model_provider = "niceai"

[model_providers.niceai]
name = "NiceAI"
base_url = "https://api.niceai.dev/v1"
wire_api = "responses"
env_key = "NICEAI_API_KEY"
配置项说明
model默认使用的模型,名称以 模型广场 为准
model_provider指向下面定义的供应商 ID,这里是 niceai
base_urlhttps://api.niceai.dev/v1,手写 config.toml 时要带 /v1
wire_api使用 Responses 接口,填 responses
env_keyCodex 从这个环境变量读取 API 密钥

供应商 ID 不要用 openai

openai、ollama 等是 Codex 内置供应商的保留 ID,自定义供应商请用其他名字,例如 niceai。另外这些设置要写在用户级的 ~/.codex/config.toml,写在项目目录的 .codex/config.toml 里会被忽略。

2. 设置密钥环境变量 ​

env_key 写的是哪个变量名,就设置哪个变量:

bash
export NICEAI_API_KEY="sk-你的密钥"
# 长期生效:把这一行追加到 ~/.zshrc 或 ~/.bashrc
powershell
# 当前窗口
$env:NICEAI_API_KEY = "sk-你的密钥"
# 长期生效(重新打开终端后可用)
[Environment]::SetEnvironmentVariable("NICEAI_API_KEY", "sk-你的密钥", "User")

3. 验证 ​

重新打开终端,运行:

bash
codex "用一句话介绍你自己"

能正常回复即接入成功。也可以先用 curl 确认密钥和地址可用:

bash
curl https://api.niceai.dev/v1/models \
  -H "Authorization: Bearer $NICEAI_API_KEY"

常见问题 ​

返回 404? ​

手写 config.toml 时 base_url 要带 /v1;在 CC Switch 里添加 Codex 供应商时则不要带 /v1,CC Switch 会自动补全。两者不要混用。详见 接口地址要不要加 /v1。

返回 401 或提示缺少密钥? ​

确认 env_key 的变量名和你设置的环境变量完全一致,并且是在设置之后新开的终端里运行 Codex。密钥分组需为 OpenAI。

仍然请求到了官方地址? ​

检查 model_provider 是否写在 config.toml 的顶层(不要放在 [model_providers.niceai] 表的下面),以及是否被 --profile 指定的配置文件覆盖。

TIP

Codex 的配置项会随版本更新,如果字段报错,请以 Codex 官方文档的 Configuration Reference 为准。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站