DeepSeek-V4-Flash 接入 Codex：配置步骤与嵌入式用法

大家好，我是杂烩君。

Codex 好用，但绑着 OpenAI 读大仓库太贵。最近：

DeepSeek-V4-Flash 已原生兼容 OpenAI Responses API，可用官方一键脚本接入 Codex。

1. 这套组合适合什么

Codex 是面向工程的 AI 编程 Agent，擅长在仓库里检索、改文件、跑命令。

DeepSeek 对 Responses 格式做了兼容，所以不必自己拼一套插件桥，通信链路可以简单看成：

Codex CLI / VS Code Codex 插件发出 Responses 请求 → DeepSeek API（或本地推理）→ 按标准格式返回 → Codex 继续解析代码、调用工具。

Codex 与 DeepSeek 通信链路

说明：

客户端形态（CLI、桌面端、VS Code 插件）共用同一份 ~/.codex

配置当前官方说明：接入 Codex 以 deepseek-v4-flash 为主；

deepseek-v4-pro 按官方进度后续支持长上下文适合啃 SDK、BSP、ROS、RTOS 这类大仓库

官方文档：

https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/codex

2. 配置步骤

前置条件：已安装 Codex CLI，或 ChatGPT 桌面端 / VS Code Codex 插件，并且至少运行过一次（本机已有 ~/.codex 目录）。

一键配置四步

说明：备份 → 写模型目录 → 改 config.toml → 校验；冲突字段会删除并打印原因，菜单可还原。

步骤 1：运行官方脚本

macOS / Linux 在终端执行：

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

脚本会拉起菜单，引导我们选模型、填 Key，并完成配置写入。若提示找不到 ~/.codex，先手动打开一次 Codex，再重跑脚本。

步骤 2：选择模型并填写 API Key

首次运行会提示输入 API Key（以 sk- 开头）。在 DeepSeek Platform 创建即可：

https://platform.deepseek.com/api_keys

按菜单选择要使用的模型。日常嵌入式读仓、改驱动，先选 deepseek-v4-flash 就够用。Key 权限按最小够用即可，用完记得在平台侧也能随时作废重建。

脚本菜单选择模型

说明：菜单里选择 DeepSeek 模型；需要切回原配置时，可再次运行脚本并选恢复项。

输入 API Key 示意

说明：Key 只保存在本机 Codex 配置侧，不要写进仓库或发到群里。

步骤 3：确认写入结果

脚本主要做四件事：

备份现有配置到 ~/.codex/backup-deepseek/，随时可还原写入模型目录 ~/.codex/models.json（上下文窗口、推理档位、工具格式等）修改

~/.codex/config.toml：只改必要字段，并新增 [model_providers.deepseek]；

MCP、项目信任等一般会保留写入前校验语法；失败则中止，不改文件

和「一把清掉所有旧配置」不一样：冲突项才会被删，并且会逐条打印原因。再次运行脚本，还可以切换模型，或恢复安装前的默认配置。改完先看终端输出里有没有删除项，心里有数再继续用。

DeepSeek 已配置为模型提供方

提供方指向 DeepSeek 后，CLI 与插件都会走同一套配置。

config.toml 中的 deepseek 配置段

重点看 model_providers.deepseek 与当前默认模型是否指向 flash。

Codex 中已可选 DeepSeek 模型

在 Codex 模型列表里能看到 DeepSeek-V4-Flash，就算接通了。

步骤 4：用本地工程冒烟

随便打开一个驱动目录，先问一个具体问题，例如：代码审查

如果模型列表里没有 DeepSeek，或请求直接报鉴权失败，优先核对三件事：脚本是否跑完、Key 是否有效、当前选中的模型是不是 flash。不必一上来就手改一大段 config.toml。

3. 嵌入式四个落地场景

下面四个场景都围着一件事：读懂、改好本地嵌入式工程。很多人只用 AI 写小函数，其实更该把它放进审查、单测、知识沉淀和手册解读。

用法上可以先窄后宽：指定目录或文件，再丢 Prompt。范围越小，越容易核对。下面 Prompt 可以直接复制到 Codex。

嵌入式四个落地场景

场景1：代码审查、MISRA 倾向检查

适用：提交前扫驱动/协议栈，先抓空指针、缓冲区、错误码吞掉、中断里干重活这类问题。

可参考 Prompt：

你是嵌入式 C 代码审查助手。请审查当前仓库我指定的文件/目录，重点检查：
1) 空指针与越界；2) 错误码是否被吞掉；3) 中断/回调里是否有阻塞或重逻辑；
4) 资源申请与释放是否配对；5) 是否有明显违背 MISRA 常见规则的写法（给出规则倾向，不必假装正式认证）。
输出格式：问题列表（严重级别 / 文件:行号 / 原因 / 修改建议）。没有把握的标「需人工确认」。

说明：AI 审查是辅助清单，不能替代项目规范门禁和人工确认。建议先审变更集，再审整目录，噪音会小很多。

场景2：单元测试、驱动测试用例自动生成

适用：给底层 GPIO、I2C、SPI 补自测，把超时、NACK、重试路径写全。很多驱动「happy path 能跑」，一到异常路径就靠现场撞。

可参考 Prompt：

基于当前打开的驱动文件，生成可编译的单元测试（优先 Unity/CMock 或工程已有框架）。
要求覆盖：正常读写、超时、NACK/错误码、重试耗尽、边界长度。
对硬件寄存器访问请用 mock/替身，不要假设板子在线。
输出：测试文件草稿 + 需要我补齐的依赖说明。

注意：生成后先本地编译跑通；时序和电气问题仍要上板验证。

场景3：工程知识库沉淀

适用：历史 bug、勘误、客户现场记录散落各处，希望 Codex 再遇到同类问题时能参考。

可参考 Prompt：

请阅读仓库里 docs/bugs、勘误记录或我粘贴的历史问题笔记。
整理成「症状 → 根因 → 涉及模块 → 修复要点 → 回归建议」条目。
之后如果我提出类似故障现象，请优先对照这些条目，再去源码里求证，并标明依据来自哪条记录。

可以先挑一个小切口：把最近三次现场问题整理进仓库，再让 Codex 对照，比空泛「帮我总结项目」有用。条目写清楚「怎么复现、看哪份日志」，后面复用才稳。

场景4：硬件文档、寄存器手册解读

适用：数据手册太长，先要结构体、位域和读写顺序草稿。尤其是新芯片外设，人工从 PDF 抠字段很耗时间。

可参考 Prompt：

以下是某外设寄存器相关的数据手册摘录（或 PDF 转文本）。
请生成：1) C 语言寄存器结构体/位域；2) 复位值与访问属性表；3) 推荐初始化顺序；
4) 常见坑（保留位、写 1 清零、读清等）。
不确定的字段标 TODO，禁止编造地址。最终以芯片手册为准。

注意：地址和复位值必须以手册为准；AI 适合加速整理，不适合当唯一真相源。生成结果建议和手册页码一起放进 MR/提交说明，方便后人核对。

4. 成本与选型

DeepSeek-V4-Flash 适合大批量读源码仓库。嵌入式场景里，输入 token 往往比输出更多——我们要喂手册、喂驱动树，再换一小节改建议。按目前公开价，输入大约 0.14 美元 / 百万 token（cache miss，以官网定价页为准）：

https://api-docs.deepseek.com/zh-cn/quick_start/pricing

选型可以先按这个用：

日常代码生成、读仓、调试：deepseek-v4-flash（性价比首选，也是当前 Codex 接入主力）

更重的架构推演、内核级推理：等 deepseek-v4-pro 对 Codex 正式支持后再切

先跑通 flash 的最小闭环，再谈要不要上更重的模型。

大家对deepseek-v4-flash + Codex在嵌入式中落地还有什么建议？欢迎评论区聊一聊