Codex Desktop 接入 DeepSeek 官方 API

先说明一下，这篇跟之前那篇《Codex Desktop 接入第三方模型配置指南》很像，但不算重复。上一篇要手动建模型目录、改 provider；这篇只跑 DeepSeek 官方脚本，拿 Key、装应用、复制一条命令就行，Windows 同事照做也能完成。

默认模型会切成 deepseek-v4-flash-vision-exp。它是 DeepSeek 的视觉模型，能读图，平时聊天也没问题。后面的命令都能直接复制。

一、拿 DeepSeek API Key

1. 打开 platform.deepseek.com 注册并登录。
2. 左侧点「API Keys」，再点「创建 API Key」。
3. 复制生成的 sk- 开头的字符串，先存到记事本。弹窗关掉后就看不到了。

注意：要用开放平台生成的 Key，不是 DeepSeek 手机 App 里充值的账号余额。

二、装 Codex Desktop

Windows

1. 打开 https://codexapp.agentsmirror.com/。
2. 点「立即下载」，得到 CodexAppManager_x64-setup.exe，多数同事直接下这个。
3. 双击安装。系统问「是否允许此应用更改设备」时，点「是」。
4. 装好后打开 Codex App Manager，按界面提示安装或启动 Codex。

Codex Desktop 官方 Windows 版原来只在 Microsoft Store 上架，公司电脑经常连不上商店。Codex App Manager 是一个开源工具，用国内直连镜像装官方版本，也能管更新和卸载。

macOS

1. 打开同一个网址，点「立即下载」。2020 年后的 Mac 基本都是 M 芯片，下 aarch64.dmg；老 Intel 芯片下 x86_64.dmg。
2. 打开 dmg，把 Codex App Manager 拖进「应用程序」。第一次打开被拦，就在「应用程序」里右键点它，选「打开」。
3. 然后按界面提示安装或启动 Codex。

三、把默认模型切成 deepseek-v4-flash-vision-exp

Windows

1. 点开始菜单，输入 PowerShell，打开蓝底窗口。
2. 复制这行，粘贴进去回车：

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup.ps1 | iex

3. 出现菜单后输入 3：

1. 修改 Codex 配置，使用 deepseek-v4-flash 模型
2. 修改 Codex 配置，使用 deepseek-v4-pro 模型
3. 修改 Codex 配置，使用 deepseek-v4-flash-vision-exp 模型
9. 恢复默认的 Codex 配置（删除 deepseek 相关配置）

4. 提示「请输入 DeepSeek API key」时，把 sk- 开头的 Key 粘进去，回车。
5. 看到 [OK] 开头的「已写入 / 已更新」提示就行。

macOS / Linux

打开终端（Terminal），执行：

bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup.sh)

然后同样选 3、粘贴 Key、等它跑完。

脚本是 DeepSeek 官方的。它会先把原配置备份到 .codex 下的 backup-deepseek，再写 config.toml 和 models.json。以后想换模型，重新跑这条命令，换个数字就行。

四、验证

1. 完全退出 Codex Desktop 再打开。Windows 在右下角托盘图标上右键退出；Mac 按 Command + Q，不是点左上角红叉。
2. 新建对话，看顶部模型名是不是 DeepSeek-V4-Flash-Vision。
3. 发一条消息，能正常回复就成了。

常见问题

现象	处理
配置没生效	彻底退出 Codex Desktop 再打开。Windows 连托盘一起退，Mac 按 Command + Q
提示 401	Key 没粘全，或者不是开放平台的 Key，重新跑一遍脚本
报 TOML 解析错误	手动改过配置就对照附录检查，或者重跑脚本

恢复原样或换模型

重新跑第三节的命令，在菜单里换个数字。

• 选 1，切回稳定的 deepseek-v4-flash。视觉模型是实验版，偶尔不稳时用这个。
• 选 9，恢复原来的配置，脚本会从备份还原。

不用自己去备份文件夹里手动拷文件。

附录：手动配置（脚本不可用时再看）

一般不用看。跑完第三节，配置就是这个样子。上一篇要手动建的模型目录，这篇不用碰，脚本会连 models.json 一起生成。

Codex Desktop 和命令行共用一份配置：

• Windows：C:\Users\你的用户名\.codex\config.toml
• macOS / Linux：~/.codex/config.toml

没有就新建，写入以下内容，把 Key 换成自己的：

model = "deepseek-v4-flash-vision-exp"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
model_catalog_json = "~/.codex/models.json"

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "<你的DeepSeek API Key>"

容易踩的坑：

1. 改之前先备份原文件，拷个副本放旁边。
2. base_url 结尾带 / 是对的，但不要写成 /v1 结尾。
3. wire_api 必须是 "responses"。老教程里的 "chat" 在新版 Codex 会无法启动。

另外还需要同目录下的 ~/.codex/models.json，里面有大段系统提示词模板，手写容易漏。最省事的办法还是跑一遍第三节的脚本，两个文件就都有了。

想看手动配置的完整思路，可以翻上一篇：Codex Desktop 接入第三方模型配置指南。

---

参考：DeepSeek 官方 Codex 接入文档 ｜ Codex App Manager