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

先说结论：在 ~/.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 里选一把 Key，点「接入」，选 Codex，复制「一键脚本」。它长这样：

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，加上这几行：

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 末尾加一行，然后重开终端：

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

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

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

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

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 现在的价格，数据直接读取线上目录：

美元 / 百万 token

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

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

验证一下

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

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

常见问题

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

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

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

接下来

• Claude Code 配置第三方 API
• 价格与线路：两条线路的完整说明
• 模型目录：所有模型和实时价格