Codex 接入第三方模型:用 config.toml 接入 GPT、DeepSeek、Kimi、GLM、Qwen

Guide Codex 接入第三方模型 gpt-6.1-soldeepseek-v4-pro Lazu

先说结论:在 ~/.codex/config.toml 里加一个 model_providers.lazu,base_url 填 https://api.lazu.ai/v1,Key 放进环境变量 LAZU_API_KEY,Codex 就能通过 Lazu 用 GPT-6.1 Sol,也能用 DeepSeek、Kimi、GLM、Qwen 等第三方模型。CLI、IDE 插件和桌面版读的是同一份配置。

哪些模型能在 Codex 里用 #

Codex 只走 OpenAI 的 Responses 接口(/v1/responses),不再支持 Chat Completions。所以能不能在 Codex 里用,取决于这个模型在 Lazu 上是否提供 Responses 接口:

厂商 可用模型(举例)
OpenAI gpt-6.1-sol、gpt-6-sol、gpt-6-astra、gpt-6-luna
DeepSeek deepseek-v4-pro、deepseek-flash
月之暗面 kimi-k3
智谱 glm-5.3、glm-5.3-flash
通义千问 qwen3.8-max、qwen3.8-flash
MiniMax MiniMax-M2.7
Google gemini-3.7-flash

完整列表以模型目录里标有 Responses 的模型为准。

Claude 模型暂时不能在 Codex 里用。Codex 默认会带上 web_search 这类由 OpenAI 托管的工具,并要求返回加密的推理内容,这两样在 Claude 那边都没有对应,Lazu 会直接拒绝,并在报错里写明是哪个字段。Claude 请用 Claude Code。Gemini 目前也不能在 Codex 里用。

最快的办法:一行脚本 #

在 控制台 › API Keys 里选一把 Key,点「接入」,选 Codex,复制「一键脚本」:

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

脚本会在终端里问你要 Key,Key 不会出现在命令行和历史记录里。它会写好 config.toml,把 LAZU_API_KEY 写进 shell 启动文件,并发一次测试请求确认能通。Windows 用同一个弹窗里的 PowerShell 版本。

手动配置 #

打开 ~/.codex/config.toml,把下面几行放在文件最前面(顶层字段必须写在第一个用方括号开头的表头之前,否则 TOML 会把它们算进那个表里):

model_provider = "lazu"
model = "gpt-6.1-sol"
web_search = "disabled"

[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_provider 让 Codex 默认使用下面定义的 lazu。openai、ollama、lmstudio 是保留名,不能用
model 默认模型,填上表里的模型 ID
web_search 建议关闭。Codex 默认会调用 OpenAI 托管的网页搜索工具,第三方模型不一定支持
base_url 请求发到哪里,末尾带 /v1
env_key Codex 从哪个环境变量读 Key。不要把 Key 直接写进 TOML
wire_api 只能是 responses

provider 配置只能写在用户目录的 ~/.codex/config.toml,写在项目里的 .codex/config.toml 会被忽略。

切到 DeepSeek、Kimi、GLM #

最简单的办法是改 model:

model = "deepseek-v4-pro"

但 Codex 不认识的模型 ID,会用一套通用的默认参数来跑:上下文按 272K 算,也不会启用它为 GPT 准备的文件编辑工具。为了让 /model 里能列出这些模型并带上合适的参数,建议用一键脚本生成模型目录:

curl -fsSL https://api.lazu.ai/setup/codex | sh -s -- --model gpt-6.1-sol --also deepseek-v4-pro --also kimi-k3 --also glm-5.3

脚本会用 codex debug models --bundled 读出你本机 Codex 版本的目录格式,生成 ~/.codex/lazu-models.json,再在 config.toml 里加一行 model_catalog_json 指向它。升级 Codex 后,重新跑一次这行脚本。

Codex 的提示词、工具和推理参数是为 GPT 调过的。第三方模型能接通,但多步工具调用、文件编辑和推理强度的表现因模型而异。建议先在一个临时目录里跑个小任务,确认改动符合预期,再用到正式项目里。

两套配置来回切 #

想在「GPT 干活」和「DeepSeek 省钱」之间切换,可以用 profile。Codex 0.134.0 起,旧的 profiles 表写法已经不支持,改成单独的文件:

# ~/.codex/deepseek.config.toml
model = "deepseek-v4-pro"
codex --profile deepseek

Codex 会先读 ~/.codex/config.toml,再用 deepseek.config.toml 覆盖其中的字段。

价格 #

GPT-6.1 Sol 的价格(实时读取线上目录):

gpt-6.1-solOpenAI · 1.05M · 稳定 $2.00 / $10.00查看模型页 →

美元 / 百万 token

线路输入输出缓存读缓存写入
OpenAI 官方价$2.00$10.00$0.10$2.50 (5m)
输入超过 272k$4.00$15.00$0.20$5.00 (5m)
Lazu 稳定 · 同官方$2.00$10.00$0.10$2.50 (5m)
输入超过 272k$4.00$15.00$0.20$5.00 (5m)

输入(含缓存)超过阈值的请求,整单按长上下文价计费。

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

DeepSeek V4 Pro 的价格:

deepseek-v4-proDeepSeek · 1M · 稳定 $0.825 / $2.48查看模型页 →

美元 / 百万 token

线路输入输出缓存读缓存写入
DeepSeek 官方价$0.66$1.98$0.022—
Lazu 稳定$0.825$2.48$0.0275—

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

每次调用实际花了多少,在控制台「用量与日志」里按请求查看。用 Codex 跑一个完整任务的总费用,可以按 会话核对。

GPT-6 Sol 还有一条优惠线路:它是逆向渠道,由第三方供应商通过官方客户端接入,不是官方 API,价格低很多,只接受 Codex 客户端发来的请求。需要的话在控制台把这把 Key 的对应模型切到「优惠」,不用改 config.toml。

验证一下 #

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

有回答就说明接通了。在控制台「用量与日志」里能看到这次请求的模型、线路和费用。

常见问题 #

报 401:Codex 没读到 LAZU_API_KEY。先在新终端里 echo $LAZU_API_KEY 确认它存在。桌面版要注意:从程序坞或启动台打开的应用,不一定能读到终端里设置的环境变量;重启后还是 401,可以先从终端启动桌面版,或改用 Codex 的 auth 命令方式提供 Key。

报模型不存在:模型 ID 写错了,或这个模型没有 Responses 接口,或这把 Key 限定了可用模型。到模型目录核对。

能用 Claude 吗? 暂时不能,原因见上文。Claude 请用 Claude Code,见 Claude Code 接入第三方 API。

接下来 #

相关文章
2026-11-18OpenCode 接入第三方模型:一把 Key 切换 Claude、GPT 与 DeepSeek 2026-09-30一个 API Key 调用 GPT、Claude、Gemini 和 DeepSeek 2026-10-21GPT-6.1 Sol 和 GPT-6 Sol 有什么区别:同价,缓存读取便宜一半

拿一个 Key 试试

免费开始