Source: https://wiki.niceai.dev/guide/codex

# Codex CLI 接入自定义 API

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

如果你已经装了 CC Switch，可以直接用 [CC Switch 一键导入](https://wiki.niceai.dev/guide/cc-switch)，不用手动改配置。下面是手动配置的方法。

## 准备工作

1. 安装 Codex CLI（参考其官方文档）。
2. 在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥，分组选择 **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` | 默认使用的模型，名称以 [模型广场](https://niceai.dev/model-plaza) 为准 |
| `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` 写的是哪个变量名，就设置哪个变量：

**-group**

```bash [macOS / Linux]
export NICEAI_API_KEY="sk-你的密钥"
# 长期生效：把这一行追加到 ~/.zshrc 或 ~/.bashrc
```

```powershell [Windows 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](https://wiki.niceai.dev/guide/v1-404)。

### 返回 401 或提示缺少密钥？

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

### 仍然请求到了官方地址？

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


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


## 下一步

- [Claude Code 接入](https://wiki.niceai.dev/guide/claude-code)
- [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)
