Codex DeepSeek：在 Codex 中使用 DeepSeek V4 Flash 与 Pro

本指南教你如何用 Codex Router 把 DeepSeek V4 Flash 和 DeepSeek V4 Pro 加进 Codex App 或 CLI。配置完成后，两个模型会出现在正常的 Codex 模型选择器里、紧挨原生 GPT 模型，而你的 DeepSeek API Key 始终不离开你的机器。

DeepSeekAPI Key

可以添加什么

DeepSeek V4 也能通过路由器内其他供应商获取——例如 ollama-cloud/deepseek-v4-pro（Ollama Cloud 账户）和 qwen-plan/deepseek-v4-pro（阿里云百炼 plan）。这些条目因凭据与计费不同而刻意共存。本页讲解厂商直连的 DeepSeek 供应商。

前置要求

• Codex App 或 CLI，以及常用前置条件（见安装指南）。
• DeepSeek 平台的 API Key。DeepSeek API 访问是与 Kimi、Anthropic、xAI 以及你的 ChatGPT 登录相互独立的账户与计费体系。

启用供应商

若尚未安装路由器（见安装），先安装，然后存密钥并启用：

./bin/model-router codex provider-key deepseek set
./bin/model-router codex providers enable deepseek

set 会打开隐藏提示——终端回显关闭，密钥不会进入 shell 历史。密钥保存在受保护的按用户文件（POSIX mode 600、Windows 当前用户 ACL）中，诊断只报告存在与否。

绝不要把 DeepSeek 密钥粘贴进对话、命令行参数或受版本控制的文件。 路由器只把它发送给配置的 DeepSeek 端点，且仅用于选择 DeepSeek 模型的请求。

Windows 上通过包装器执行相同命令：./codex-router.ps1 codex provider-key deepseek set 与 ./codex-router.ps1 codex providers enable deepseek。

验证集成

./bin/model-router codex doctor
./bin/model-router codex providers

供应商必须报告 SHOW 与 ready。然后完全退出 Codex、重新打开、新建任务并打开模型选择器——DeepSeek V4 Flash 与 V4 Pro 应出现在列表里。可用 codex debug models 确认启动目录；条目缺失时见模型缺失。

对单个模型做实时（消耗配额）检查：

./bin/test-model 'deepseek/deepseek-v4-pro' --live --yes

DeepSeek 请求的行为

路由器选择官方上游模型 ID、启用思考，并把 Codex 推理级别映射到 DeepSeek 支持的 high 与 max。DeepSeek 文档说明思考模式下无效的采样参数会被移除。两个 V4 模型共用同一个转发器与存储密钥，启用供应商即覆盖两个选择器条目。

更早的 DeepSeek 别名仍是隐藏兼容路由，不向新用户宣传，只要 DeepSeek 继续提供这些上游别名，旧 CLI 命令就能继续工作。

常见坑

• DeepSeek 密钥不能混用。 Kimi、Anthropic 或阿里云密钥无法认证 DeepSeek 请求，DeepSeek 密钥也不能认证其他请求。路由器把每个供应商的密钥放在各自受保护文件中。
• 选择器是凭据感知的。 如果 DeepSeek 不出现，多半是密钥缺失或供应商未启用——不是路由器 bug。重跑 providers 与 doctor。
• 供应商策略风险。 模型供应商可能限制或封禁代理流量。通过 Codex Router 路由 DeepSeek 风险自负；生产使用前请查阅 DeepSeek 条款。
• 转售计划单独计费。 若改用 Ollama Cloud 或阿里云 plan 密钥接入 DeepSeek，用量由该账户计费，而非 DeepSeek。

官方链接

• DeepSeek API 文档
• Codex Router 仓库

相关：模型总览、Codex 中的 Kimi、Codex 中的 GLM、故障排查。