Codex DeepSeek：使用 DeepSeek V4.1 Flash、V4 Flash 与 Pro
本指南教你如何用 Codex Router 把 DeepSeek V4.1 Flash、V4 Flash 和 V4 Pro 加进 Codex App 或 CLI。配置完成后，厂商直连模型会出现在正常的 Codex 模型选择器里、紧挨原生 GPT 模型。DeepSeek API Key 只存储在你的机器上，并且仅在选择 DeepSeek 模型时发送给配置的 DeepSeek 端点。
DeepSeekAPI Key可以添加什么
| 选择器标签 | 模型 ID | 认证方式 |
|---|---|---|
| DeepSeek V4 Flash (API) | deepseek/deepseek-v4-flash | DeepSeek API Key |
| DeepSeek V4 Pro (API) | deepseek/deepseek-v4-pro | DeepSeek API Key |
| DeepSeek V4.1 Flash (API) | deepseek/deepseek-v4.1-flash | DeepSeek API Key |
现有 V4 路线全部保留。不同供应商条目因凭据与计费不同而刻意共存；选择 OpenCode、Nous、Command Code、OpenRouter 或 Ollama 路线不会消耗厂商直连的 DeepSeek 余额。
各供应商的 DeepSeek V4.1 Flash
DeepSeek 于 2026 年 9 月 10 日发布 V4.1 Flash，目前还没有 V4.1 Pro。Codex Router 已内置六条供应商路线：
| 供应商 | 模型 ID | 声明的上下文与输入 | 验证说明 |
|---|---|---|---|
| DeepSeek API | deepseek/deepseek-v4.1-flash | 1,048,576；文本 + 图片 | 厂商直连路线 |
| OpenCode Go | opencode-go/deepseek-v4.1-flash | 1,000,000；文本 + 图片 | Go 订阅路线 |
| Nous Research | nousresearch/deepseek-v4.1-flash | 262,144；文本 + 图片 | 按 Portal 实际服务上限 |
| Command Code | commandcode/deepseek-v4.1-flash | 1,000,000；仅文本 | 图片输入尚未通过 API 实测 |
| OpenRouter | openrouter/deepseek-v4.1-flash | 1,048,576；文本 + 图片 | 已内置，工具历史行为尚未实测 |
| Ollama Cloud | ollama-cloud/deepseek-v4.1-flash | 1,048,576；文本 + 图片 | 云端目录已上线，上游尚未做带凭据实测 |
ClinePass 与 Qwen Plan 暂无内置 V4.1 路线。OpenCode 上线时使用的 deepseek-flash 已改名为 deepseek-v4.1-flash，应使用上表中的正式路线，不要再定制已弃用 ID。
前置要求
- 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 deepseekset 会打开隐藏提示——终端回显关闭，密钥不会进入 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.1 Flash、V4 Flash 与 V4 Pro 应出现在列表里。可用 codex debug models 确认启动目录；条目缺失时见模型缺失。
对单个模型做实时（消耗配额）检查：
./bin/test-model 'deepseek/deepseek-v4.1-flash' --live --yesDeepSeek 请求的行为
路由器选择官方上游模型 ID 并启用思考。V4.1 Flash 与 V4 Flash 提供 low、high、max，V4 Pro 提供 high 与 max。DeepSeek 在思考模式中会拒绝的采样参数和强制工具选择会在发送前被规范化；三条直连路线共用同一个转发器与存储密钥。
已退役的 deepseek-v4-flash 别名仍可调用，但现在实际由 V4.1 Flash 按 Flash 价格提供。上游说明，从 2026 年 9 月 14 日 04:00 UTC（北京时间 12:00） 起，deepseek-v4-pro 请求也会暂时由 V4.1 Flash 按 Flash 价格提供，直至 V4.1 Pro 发布。独立的 deepseek/deepseek-v4.1-flash 选择器条目能明确显示实际模型。
更早的 DeepSeek 别名仍是隐藏兼容路由，不向新用户宣传，只要 DeepSeek 继续提供这些上游别名，旧 CLI 命令就能继续工作。
常见坑
- DeepSeek 密钥不能混用。 Kimi、Anthropic 或阿里云密钥无法认证 DeepSeek 请求，DeepSeek 密钥也不能认证其他请求。路由器把每个供应商的密钥放在各自受保护文件中。
- 选择器是凭据感知的。 如果 DeepSeek 不出现，多半是密钥缺失或供应商未启用——不是路由器 bug。重跑
providers与doctor。 - 供应商策略风险。 模型供应商可能限制或封禁代理流量。通过 Codex Router 路由 DeepSeek 风险自负；生产使用前请查阅 DeepSeek 条款。
- 其他路线单独计费。 OpenCode Go、Nous、Command Code、OpenRouter、Ollama Cloud 与阿里云 plan 都使用各自账户、额度及数据保留条款，不消耗你的 DeepSeek API 余额。