Codex Deepseek Subagent — Development skill for Claude Code

把 `deepseek-v4-flash` 或 `deepseek-v4-pro` 注册为 Codex 原生自定义子 Agent，并验证实际派发路由。DeepSeek V4 Pro 的 8·13 更新继续使用 `deepseek-v4-pro` API 标识。

适用范围

这个 Skill 只用于：

• 首次配置、状态检查和实时测试；
• 父模型变化后的修复；
• 停用或卸载 DeepSeek 配置。

普通的编码、探索、实现、评审和验证任务不应重复运行配置流程。

快速开始

要求：macOS 或 Windows、Python 3.11+、ChatGPT/Codex 桌面应用，以及 DeepSeek 官方 API Key。

1. 全局安装 Skill：

npx skills add oil-oil/codex-deepseek-subagent -g -y

1. 重启桌面应用并新建任务，让 Skill 生效。

2. 在新任务中发出配置请求：

帮我把 DeepSeek 配置成 Codex 的原生子 Agent。

1. Codex 会先让你选择模型：

   • DeepSeek V4 Flash：更快、更省，适合日常编码；
   • DeepSeek V4 Pro：能力更强，适合复杂编码和高难度 Agent 任务。

2. 选择后，Codex 会在缺少凭据时索要 API Key，通过标准输入保存到系统凭据库，然后自动配置并验收。

3. 看到 `status: ready` 后，再重启桌面应用并新建任务。此后可直接说：

用 DeepSeek 子 Agent 检查这个项目。

配置成功后，角色文件位于 `$CODEX_HOME/agents/DeepSeek.toml`；默认 `CODEX_HOME` 为 `~/.codex`。

使用与兼容性

• 日常任务只能由主 Agent 直接调用 spawn_agent(agent_type="DeepSeek", fork_turns="none")。
• 配置与验收只使用桌面应用内置运行时；版本仅作诊断，实际能力以真实派发结果为准。
• 父模型从当前配置读取；切换父模型后运行 repair。
• DeepSeek 模型可以随时切换；repair --model deepseek-v4-pro 或 repair --model deepseek-v4-flash 会更新配置并重新验收。
• DeepSeek 只处理文本。图片、视频、截图等视觉输入必须由父 Agent 先识别并整理成文字。
• 当前工具若不认识 DeepSeek 角色，只提示用户打开新任务或重启 Codex；不得用脚本或 codex exec 代做用户任务。

v1/v2 路由原因、配置位置和回滚规则见 [兼容性说明](codex-deepseek-subagent/references/compatibility.md)。

管理命令

管理命令由 Skill 按需调用：

macOS：

python3 codex-deepseek-subagent/scripts/codex_deepseek.py status --json
python3 codex-deepseek-subagent/scripts/codex_deepseek.py setup --model deepseek-v4-pro --api-key-stdin --json
python3 codex-deepseek-subagent/scripts/codex_deepseek.py test --json
python3 codex-deepseek-subagent/scripts/codex_deepseek.py repair --model deepseek-v4-flash --json
python3 codex-deepseek-subagent/scripts/code