让 Codex 主任务继续使用 GPT / OpenAI，同时把便宜、快速的
deepseek-v4-flash 当作原生 subagent 做搜索、枚举、日志和大量文本整理。
DeepSeek 是本仓库提供的开箱即用实现，不是这种组合的能力上限。凡是能被 Codex 通过受支持 API 调用、并满足目标任务能力与数据边界的 provider/model，都可以按 同一模式适配成独立 subagent；当前安装器仍只安装经过验证的 DeepSeek 配置。具体 条件见 适配其他 provider/model。
这套安装不需要 CC Switch、MCP、插件或另一个 Codex CLI，也不会把主 Agent 切到 DeepSeek。只做下面三步。
在 DeepSeek 创建 key，然后把它保存为环境变量 DEEPSEEK_API_KEY。不要把 key
发进 Codex 聊天、Issue、截图或仓库。
- Windows：在系统设置中搜索“环境变量”，在“用户变量”中新建
DEEPSEEK_API_KEY，然后完全退出并重新启动 Codex Desktop。不要依赖已经运行的 Desktop 自动读取后来设置的变量。 - macOS / Linux：在启动 Codex 的 shell 或 secret manager 中设置
DEEPSEEK_API_KEY，再启动 Codex。
macOS 也提供独立的 Keychain 认证模板，适合不从 shell 继承环境变量的启动方式。 默认安装仍使用上面的环境变量；只有你明确选择时才使用 Keychain，已有配置不会自动 迁移。设置与安全探针见 macOS Keychain 可选认证。
不知道怎么设置时，可以让 Codex 只解释你当前系统的环境变量设置方法，但不要把 key 本身交给它。安全细节见 SECURITY.md。
请读取并严格执行
https://raw.githubusercontent.com/Utopia-V/codex-deepseek-subagent/main/prompts/install-with-codex.md
为我安装其中的 DeepSeek V4 Flash subagent。保留当前主模型、provider 和 ChatGPT
登录，不得索要或输出 API key；完成无付费调用的本地验证后停止，暂不运行 smoke
test。
Codex 会自行下载、合并和验证需要的 Agent、skill、Hook 与两条 AGENTS.md
索引。安装过程不会调用 DeepSeek，也不会改掉主模型/provider。
安装完成后：
- 在 Codex 输入
/hooks，检查它只匹配v4_flash_worker，命令指向刚安装的plaintext-handoff脚本，然后选择信任。 - 新开一个 Codex 任务。 已经运行的旧任务不保证重新加载新 Hook。Windows 用户若刚设置或修改了 API key，应先完整重启 Codex；其他情况下通常不必重启应用。
- 把下面一句复制到新任务：
请读取并严格执行
https://raw.githubusercontent.com/Utopia-V/codex-deepseek-subagent/main/prompts/quick-smoke-test.md
测试刚安装的 v4_flash_worker。不得使用替代 provider、直接 API 或另一个 Codex
CLI。
这个 quick smoke 不要求 clone 仓库，会产生一次很小的 DeepSeek API 调用。
测试结果应同时满足：
- 出现一个独立的原生 child task，agent type 是
v4_flash_worker； - child 返回父 Agent 随机生成的 marker，并得到
arithmetic=323； - 一次性 pending handoff 已被消费；
- 主任务仍使用原来的 OpenAI 模型/provider；
- 没有另起 CLI、直连 API 或换模型冒充成功。
满足这些条件后即可正常使用。父 Agent 会在适合的任务上按需加载
$use-v4-flash-worker，自行决定是否委派；安装并不强迫每个任务都使用 Flash。
安装只会在个人 Codex 配置中新增或更新独立 Agent、skill、Hook 和两条路由索引；
不会向顶层配置添加 DeepSeek provider，不会切换主任务模型。唯一需要你手动决定的
步骤是通过 /hooks 审查并信任 Hook。完整文件边界见 高级说明。
- 看不到
v4_flash_worker： 先新开任务；仍看不到再重启 Codex 一次。 - child 说没有收到任务： 通常是 Hook 未信任、当前任务早于 Hook 安装，或者
Hook 没有加载。检查
/hooks后再新开任务，不要改用 inherited turns。 - 提示缺少认证： 只检查所选环境变量或 Keychain item 是否存在，不要把 key 贴进聊天。
- Windows 在 Hook 运行前就提示 Agent 不可用： 确认 Codex 进程继承了环境变量并 完整重启；User/HKCU command auth 可能读到 sandbox identity，见高级说明。
- 安装 Agent 要你切换全局 provider、启动另一套 CLI 或安装 MCP： 停止；那不是 本仓库的安装路径。
仍失败时，优先选择合适的结构化 Issue Form； 现有分类都不适用时，也可以开 Blank Issue。请尽量提供操作系统、Codex 版本、失败 边界和脱敏后的输出；不要附 API key、完整请求头或未脱敏配置。可以让 Agent 协助 整理报告，但提交前应由人核对实际观测、推断和未运行的对照。可复现的证据有助于 区分配置、Agent discovery、Hook、provider request 和 callback 等失败边界，也能 帮助后来的人。
- 实现原理、V1 workaround、当前 V2 上游缺陷、配置边界和迁移条件： 高级说明
- 完整 Agent 安装合同：prompts/install-with-codex.md
- 带本地工具和 SHA-256 的贡献者 smoke：prompts/smoke-test.md
- 只诊断原始 V2 message-only 的探针： prompts/message-handoff-probe.md
- 凭据、plaintext 本地状态和 DeepSeek 数据边界：SECURITY.md
Windows Desktop 路径已有 live smoke；当前 PowerShell 加固实现通过本地协议、并发
与恢复测试，尚待一次更新后的 live smoke。macOS 的 Python/POSIX 路径已在 Codex
0.146.0 上通过原生 callback smoke 和 27 项协议测试；Linux 使用同一 POSIX 实现。
DeepSeek API 费用独立于 ChatGPT/OpenAI 订阅。安装不产生 DeepSeek 调用；quick smoke 和之后的 Flash child 会按 DeepSeek 账户计费。
MIT。本仓库是独立配置示例，与 OpenAI 或 DeepSeek 不存在隶属或官方背书关系。