Codex 接入第三方模型:用 config.toml 接入 GPT、DeepSeek、Kimi、GLM、Qwen
先说结论:在 ~/.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 |
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
输入(含缓存)超过阈值的请求,整单按长上下文价计费。
— 表示未记录该项价格,不代表免费;实际费用以请求回执为准。
DeepSeek V4 Pro 的价格:
deepseek-v4-proDeepSeek · 1M · 稳定 $0.825 / $2.48查看模型页 →美元 / 百万 token
— 表示未记录该项价格,不代表免费;实际费用以请求回执为准。
每次调用实际花了多少,在控制台「用量与日志」里按请求查看。用 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。