<!-- Lazu · Codex 配置自定义接口：用 config.toml 接入 GPT-6、GPT-5.6 · https://lazu.ai/zh/blog/codex-custom-provider -->

# Codex 配置自定义接口：用 config.toml 接入 GPT-6、GPT-5.6

2026-09-30 · Lazu 团队

先说结论：在 `~/.codex/config.toml` 里加一个 `model_providers.lazu` 表，`base_url` 填 `https://api.lazu.ai/v1`，`wire_api` 填 `responses`，Key 放进环境变量 `LAZU_API_KEY`，Codex 就会把请求发到 Lazu。CLI 和桌面版读的是同一份配置。不想手写，可以直接跑下面的一行脚本。

## 最快的办法：一行脚本

在 [控制台 › API Keys](https://lazu.ai/console/token) 里选一把 Key，点「接入」，选 Codex，复制「一键脚本」。它长这样：

```bash
curl -fsSL https://api.lazu.ai/setup/codex | sh -s -- --model gpt-6-sol
```

脚本会在终端里问你要 Key，所以 Key 不会出现在命令行和历史记录里。然后它会写好 `config.toml`，并把 `LAZU_API_KEY` 写进你的 shell 启动文件。Windows 用同一个弹窗里的 PowerShell 版本。

## 手动配置

打开 `~/.codex/config.toml`，加上这几行：

```toml
model_provider = "lazu"
model = "gpt-6-sol"

[model_providers.lazu]
name = "Lazu"
base_url = "https://api.lazu.ai/v1"
env_key = "LAZU_API_KEY"
wire_api = "responses"
```

再把 Key 放进环境变量。以 zsh 为例，用编辑器在 `~/.zshrc` 末尾加一行，然后重开终端：

```bash
export LAZU_API_KEY="sk-lazu-..."
```

| 字段 | 作用 |
| --- | --- |
| `model_provider` | 让 Codex 默认使用下面定义的 `lazu` |
| `model` | 默认模型，填 [模型目录](/zh/models) 里的模型 ID |
| `base_url` | 请求发到哪里，注意末尾带 `/v1` |
| `env_key` | Codex 从哪个环境变量读 Key。Key 不要直接写进 TOML |
| `wire_api` | 用 Responses 接口通信，Codex 需要它 |

## 为什么 /model 里只看得到一个模型

Codex 不会向自定义 provider 请求模型列表，`/model` 里只列出本机模型目录里的模型。想在 Codex 里切换多个模型，需要一份模型目录文件，并在 `config.toml` 里用 `model_catalog_json` 指向它。

目录的格式跟着 Codex 版本变，手写很容易在升级后失效。所以一键脚本是先用 `codex debug models --bundled` 读出本机版本的格式，再生成 `~/.codex/lazu-models.json`。要多带几个模型，就加 `--also`：

```bash
curl -fsSL https://api.lazu.ai/setup/codex | sh -s -- --model gpt-6-sol --also gpt-5.6-sol --also gpt-5.6-terra
```

升级 Codex 之后，重新跑一次这行脚本即可。

## 在 Codex 里用优惠线路

Lazu 上的 GPT 模型有两条线路：

- **稳定线路**：走 OpenAI 官方 API，按标价计费，适合所有场景。
- **优惠线路**：是逆向渠道，由第三方供应商通过官方客户端接入，不是官方 API。价格低很多，但只建议在 Codex 里用，它也只接受 Codex 客户端发来的请求。

切换不用改 `config.toml`：在控制台编辑这把 Key，把对应 GPT 模型的线路切到「优惠」就行。自己写的程序、脚本和需要精确控制输出的场景，请继续用稳定线路。

下面是 `gpt-6-sol` 现在的价格，数据直接读取线上目录：


### [gpt-6-sol](https://lazu.ai/zh/models/openai/gpt-6-sol)

美元 / 百万 token

| 线路 | 输入 | 输出 | 缓存读 | 缓存写 5m |
| --- | --- | --- | --- | --- |
| OpenAI 官方价 | $2.00 | $10.00 | $0.20 | $2.50 |
| 输入超过 272k | $4.00 | $15.00 | $0.40 | $5.00 |
| Lazu 稳定 · 同官方 | $2.00 | $10.00 | $0.20 | $2.50 |
| Lazu 优惠 · −82% | $0.36 | $1.80 | $0.036 | $0.45 |

输入（含缓存）超过阈值的请求，整单按长上下文价计费。

— 表示未记录该项价格，不代表免费；实际费用以请求回执为准。

## 验证一下

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

有回答就说明接通了。在控制台「用量与日志」里能看到这次请求用了哪个模型、哪条线路、扣了多少钱。

## 常见问题

**报 401**：Codex 没读到 `LAZU_API_KEY`。先在新终端里 `echo $LAZU_API_KEY` 确认它存在；桌面版要重启一次才会读到新的环境变量。

**报模型不存在**：模型 ID 写错了，或者这把 Key 限定了可用模型。到 [模型目录](/zh/models) 复制 ID，或在控制台检查这把 Key 的模型范围。

**能不能在 Codex 里用 Claude 或 Gemini？** 目前不能。Codex 只走 Responses 接口，而 Lazu 上目前只有 GPT 模型支持这个接口，Claude 和 Gemini 模型会直接报错。Claude 模型请用 Claude Code，Gemini 模型请用 Antigravity。

## 接下来

- [Claude Code 配置第三方 API](/zh/blog/claude-code-custom-api)
- [价格与线路](https://lazu.ai/docs/zh/models/pricing)：两条线路的完整说明
- [模型目录](/zh/models)：所有模型和实时价格