把 DeepSeek V4 接进 Codex：配置路径、安全边界与验证清单
一份从环境准备、模型配置到三端验证的完整接入手册
来源：DeepSeek API Docs · DeepSeek
目标与适用范围
接入结果把 DeepSeek V4 Flash 配置为 Codex 的模型提供方，让 Codex CLI、ChatGPT 桌面端与 VS Code 的 Codex 插件读取同一套配置，并能从启动信息确认模型已经切换。这里成立的基础，是 Codex 通过 Responses API 与模型交互，而 DeepSeek API 原生支持这一格式。 原文
开始前准备
三项前置条件- 本地环境安装并至少运行过一次 Codex，使
~/.codex配置目录存在；配置前退出正在运行的 Codex 客户端。 - 凭证与模型准备好 DeepSeek API Key。官方页面当前明确只有
deepseek-v4-flash支持接入 Codex；V4 Pro 仍是预告状态。 原文 - 影响范围先备份
~/.codex/config.toml。CLI、桌面端与 VS Code 插件共用它，一次修改会同时影响三个入口。 原文
操作步骤
两条路径 · 四步完成选择一键脚本或手工配置
操作追求省事时使用官方推荐脚本：macOS/Linux 执行
bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup.sh)；Windows 执行irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex。需要精确控制变更时，选择手工路径。预期结果脚本路径会备份旧配置、生成模型目录并更新必要字段；手工路径则由你逐项维护两个文件。
注意远程脚本会立即在本机执行。安全敏感环境应先下载并审查脚本，再执行本地副本；这是编辑补充的安全建议。
确认脚本保护旧配置
操作使用一键路径时，确认脚本把现有文件备份到
~/.codex/backup-deepseek/，并在写入前校验config.toml与models.json。预期结果原有 MCP 与项目信任配置被保留；有冲突的模型字段被移除，目标文件通过 TOML/JSON 语法检查。 原文
注意如果校验失败，不要绕过它覆盖文件；先查看备份与报错，再决定是否转为手工配置。
手工配置模型与提供方
操作在
~/.codex/config.toml中设置model = "deepseek-v4-flash"、model_provider = "deepseek"、API Key 登录方式、model_reasoning_effort = "high"与model_catalog_json = "~/.codex/models.json"。在[model_providers.deepseek]下设置base_url = "https://api.deepseek.com/"与wire_api = "responses"；完整模型目录 JSON 以官方页面为准。预期结果Codex 能从本地模型目录识别 V4 Flash，并通过 DeepSeek 的 Responses API 端点发送请求。
注意官方示例会把 API Key 直接写进配置文件。 原文 收紧文件权限，不要提交到 Git，也不要在日志或截图中暴露。
重启客户端并逐端确认
操作关闭并重新打开 Codex CLI、ChatGPT 桌面端或 VS Code。先在终端执行
codex，再检查另外两个入口的模型显示。预期结果CLI 启动信息显示
deepseek-v4-flash；桌面端模型选择器显示“自定义”；VS Code 插件读取同一份配置。注意旧进程可能缓存配置。模型没有变化时，先彻底退出客户端，再检查路径、字段拼写与 JSON 语法。
验证与排错
以运行结果为准- Codex CLI运行
codex后，启动信息出现model: deepseek-v4-flash。 原文 - ChatGPT 桌面端模型选择器显示“自定义”，并能完成一次不含敏感信息的测试请求。
- VS CodeCodex 插件无需另配一份 Key，重启后能读取共享配置并完成一次响应。
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 仍显示旧模型 | 客户端未彻底重启，或模型目录与 provider 字段没有对齐 | 退出全部客户端；核对 model、model_provider 与 model_catalog_json |
| 鉴权失败或模型不可用 | Key、端点或模型名称有误；也可能是官方支持状态已经变化 | 核对 DeepSeek Key 与官方端点；先使用 deepseek-v4-flash，并回到官方页面确认最新支持范围 |
左右滑动查看完整表格
~/.codex/config.toml 同时影响 CLI、桌面端和 IDE，构成一个共享控制面。这个机制同样适用于团队级开发工具配置：任何提供方切换都应按小型基础设施发布处理——先备份、再审查、后验证。