【618保姆级教程】Codex接入DeepSeek-V4-Flash
Codex接入DeepSeek-V4-Flash
DeepSeek-V4-Flash 发布后反响特别大，昨天上线以来 DeepSeek 响应速度明显变慢，估计很多人都在接 API 测试。这也正常，因为正式版直接把之前的 DeepSeek-V4-Pro Preview 甩在后面，Agent 能力提升明显，用着特别爽。
我平时用 Codex 比较多，所以想把 DeepSeek 直接连到 Codex 里面。
官方提供了直接一键配置的方式，操作起来很顺手。
你可以在 Codex 的任意客户端形式接入 DeepSeek，包括 CLI、App 以及 Codex 的 IDE 扩展，只需要配置一次即可。
Mac 和 Linux 用户可以在终端里运行以下命令：
运行前建议先检查一下版本：
codex --version
DeepSeek 官方模型目录要求 Codex CLI 至少是 0.144.0。版本太低的话先更新：
codex update
bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup.sh)
Windows 用户可以在 PowerShell 中执行：
irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex
我以 Mac 为例演示一下，执行完上面命令后 DeepSeek 会询问你想做什么操作。
因为要接入最新的 DeepSeek-V4-Flash，所以这里选择 1。
接着 DeepSeek 会要求输入 api-key，这个 key 就是你在 DeepSeek 官网创建的。
https://platform.deepseek.com/api_keys
把 api-key 复制过去就行，如果你想更安全可以手动输入。
输入完成后接入就结束了。
接下来检查配置是否成功。
重启一下 Codex 客户端（现在改名叫 ChatGPT 了，改不过来了抱歉）。
可以看到 Model 已经显示为 Custom。
卸载也很简单，同样执行上面的步骤。
bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup.sh)
然后在安装过程中直接选择 y 即可。
按照官方说法这已经接入成功了。
但实际用起来不太习惯，因为 Codex 里所有 project 和 session 都不显示了，而且只有 DeepSeek 的 model，无法切换其他模型。我希望能直接切换所有 model。
找了一圈发现 Codex App 本身没有原生切换 model 的功能，于是找到 GitHub 上的 OpenCodex，研究后发现可以在 Codex App 里原生实现切换。
OpenCodex 是社区维护的本地 proxy，它把 OpenAI、DeepSeek 等 provider 的模型合并成 Codex 能识别的目录，然后根据 provider/model 把请求转发到对应接口。
先安装稳定版：
npm install -g @bitkyc08/opencodex
然后运行初始化向导：
ocx init
我保留了原来的 ChatGPT/Codex 登录，所以初始化时选择了：
- Provider：
OpenAI — ChatGPT login； - 端口：默认的
10100； - 注入 Codex：选择 Yes；
- 安装自动启动 shim：选择 Yes。
如果想让它登录后自动运行，再安装一下后台服务：
ocx service install
接着打开 OpenCodex 的本地管理页面：
ocx gui
浏览器会打开 http://localhost:10100/。进入 Providers 添加 DeepSeek，把 API Key 填进去即可。
也可以先用命令添加 DeepSeek provider：
ocx provider add deepseek --sync
最后同步一次模型目录：
ocx sync
之后就能在 Codex 中一键切换 model 了。
我研究了一下，OpenCodex 没有修改 Codex App 的二进制文件，主要给 ~/.codex/config.toml 加了两项配置：
model_catalog_json = "/Users/你的用户名/.codex/opencodex-catalog.json" openai_base_url = "http://127.0.0.1:10100/v1"
第一行让 Codex 读取 OpenCodex 合并后的模型目录，第二行把模型请求交给本机 10100 端口的 proxy。
路径大致是：
Codex App / CLI
↓
OpenCodex（127.0.0.1:10100）
↓
OpenAI 或 DeepSeek
当模型 ID 是 deepseek-v4-flash 时，OpenCodex 识别 deepseek 前缀，转换 Codex 的 Responses 请求，带上 api-key 后发送到 https://api.deepseek.com。
如果你想在 CLI 中使用 Codex 实现一键切换，OpenCodex 也支持这一步。
直接在终端使用 codex （前提是已安装官方 codex cli），输入 /model 就可以切换模型。
也可以启动时直接指定：
codex -m "deepseek/deepseek-v4-flash" codex -m "gpt-5.6-sol"
如果只想临时回到原生 Codex：
ocx stop
它会停止 proxy 和后台服务，并恢复原来的 Codex 配置。想彻底移除：
ocx uninstall
平时检查状态可以用：
ocx status
用起来还是挺方便的。
不过目前还是用 DeepSeek 的 api-key 接入，今天看到 DeepSeek 开启了 Harness 内测，估计离正式发布不远了。
我已经迫不及待想看到 DeepSeek 19.9 的 codingplan 了。
