博客

Codex 接入 DeepSeek V4 Pro:config.toml 配置写法

快速回答

Codex 走 OpenAI 协议,但不读 OPENAI_BASE_URL 环境变量,接口地址写在 ~/.codex/config.toml:

toml
# ~/.codex/config.toml(Codex 不读 OPENAI_BASE_URL,接口地址写在这里)
model_provider = "teamorouter"
model = "deepseek-v4-pro"

[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
bash
export OPENAI_API_KEY="sk-teamo-你的Key"

模型 ID 用 deepseek-v4-pro(DeepSeek V4 Pro,付费)。下面讲清默认配置和 profile 两种写法。

新账号余额为 0,先充值再调用。 第一次请求前先充值,$5 起。如果请求返回 402(OpenAI 兼容格式为 400)、提示「钱包余额不足」,说明余额为 0,不是 Base URL 或 Key 配错了,充值后重试即可。

config.toml:最省事的接法

Codex 的自定义端点只认 config.toml 里的 model_providers(写法见上),Key 从 env_key 指定的环境变量读。把 export OPENAI_API_KEY=... 写进 shell 配置(~/.zshrc / ~/.bashrc),Codex 的所有请求就会发到 TeamoRouter。之后在 Codex 里指定模型:

bash
codex --model deepseek-v4-pro "用一句话介绍你自己"

注意 base_url 带 /v1——Codex 调的是 OpenAI 的 Responses API,需要它。

Profile:按任务分流

如果你不想让整个 Codex 都切到 DeepSeek,可以用 profile 精确控制。Codex CLI 0.166 起,profile 要写成单独的文件 ~/.codex/<profile 名>.config.toml;config.toml 里还留着 [profiles.xxx] 的话,--profile 会直接报错。

~/.codex/config.toml 里只保留上面的 [model_providers.teamorouter] 那段,不写顶层的 model_provider 和 model,Codex 默认就还是原生模型。再新建 ~/.codex/teamorouter-pro.config.toml:

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

然后:

bash
codex --profile teamorouter-pro "重构 src/services/reporting.py,拆掉重复分支"

我们 2026 年 11 月 2 日用 Codex CLI 0.166.0 实测过上面两种写法:Codex 按 Responses API 把 deepseek-v4-pro 的请求发到 /v1/responses,到了 TeamoRouter 网关。

这样默认仍是 Codex 原生的 GPT,加 --profile teamorouter-pro 才走 DeepSeek,按任务切:重活给 Codex 原生 GPT,日常高频给便宜的 DeepSeek V4。

价格

DeepSeek 官方给 V4 Pro 的价格是高峰时段每百万输入 token $1.32、每百万输出 token $3.96,低谷时段减半(2026 年 11 月 2 日的 DeepSeek 官方价格页)。TeamoRouter 当前价格见价格页。

常见踩坑

Q:Codex 报 404 / 连不上? 要么 base_url 漏了 /v1,要么只设了 OPENAI_BASE_URL 没写 config.toml(Codex 不读这个变量)。端点必须是 https://api.teamorouter.com/v1,写在 ~/.codex/config.toml 里。

Q:报 401 鉴权失败? OPENAI_API_KEY 没生效或 Key 复制不全。echo $OPENAI_API_KEY 确认 sk-teamo- 开头、无空格。

Q:Codex 里模型切不过去? 确认 model 拼写全小写、- 分隔(deepseek-v4-pro)。可以先 curl .../v1/models 拉实时列表核对。

Q:提示「模型 'deepseek-v4-pro-free' 暂不可用」? TeamoRouter 没有 deepseek-v4-pro-free 这个模型。把 config.toml 里的 model(用 profile 的话是 teamorouter-pro.config.toml 里的 model)换成 deepseek-v4-pro,其他不用改。

Q:profile 和环境变量冲突怎么办? profile 里显式写的 base_url / api_key 优先于环境变量,适合「默认 GPT、特定任务走 DeepSeek」的分流。

Q:V4 Pro 的推理能力在 Codex 里能用吗? 能。V4 Pro 走 OpenAI 兼容协议,推理透传,Codex 侧无需额外配置。

到 TeamoRouter 拿 Key,两行环境变量就能让 Codex 跑上 DeepSeek V4 Pro。

准备好接入了吗?登录控制台 · 购买额度 · 创建 API Key,三步即可开始。