外观
Codex CLI 接入自定义 API
Codex CLI 通过用户级配置文件 ~/.codex/config.toml 定义模型供应商。接入 NiceAI 只需要新增一个自定义供应商,并把密钥放进环境变量。
如果你已经装了 CC Switch,可以直接用 CC Switch 一键导入,不用手动改配置。下面是手动配置的方法。
准备工作
- 安装 Codex CLI(参考其官方文档)。
- 在 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_url | https://api.niceai.dev/v1,手写 config.toml 时要带 /v1 |
wire_api | 使用 Responses 接口,填 responses |
env_key | Codex 从这个环境变量读取 API 密钥 |
供应商 ID 不要用 openai
openai、ollama 等是 Codex 内置供应商的保留 ID,自定义供应商请用其他名字,例如 niceai。另外这些设置要写在用户级的 ~/.codex/config.toml,写在项目目录的 .codex/config.toml 里会被忽略。
2. 设置密钥环境变量
env_key 写的是哪个变量名,就设置哪个变量:
bash
export NICEAI_API_KEY="sk-你的密钥"
# 长期生效:把这一行追加到 ~/.zshrc 或 ~/.bashrcpowershell
# 当前窗口
$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 为准。