这是一个面向 ChatGPT/Codex 桌面应用的配置型 Skill，用于将 DeepSeek 的 deepseek-v4-flash 注册为 Codex 原生自定义子 Agent，并通过自动化状态检查、配置、真实路由验收、修复、停用和卸载流程来确保 Codex 可以实际派发任务给 DeepSeek。项目本身不是通用编码框架，而是一个专门解决 Codex 与 DeepSeek 子 Agent 集成的管理工具。
适用领域
AI Agent 集成 / Codex 桌面应用扩展 / DeepSeek API 接入 / 开发者工具 / 自动化配置管理 / 本地凭据管理 / 多模型工作流
配置难度
中等。普通开发者按 README 操作即可完成安装和配置，但需要理解 Codex Skill、子 Agent、API Key、系统凭据库、桌面应用重启和路由验收等概念；若遇到 Codex 版本兼容或 Windows 路径发现问题，排查难度会升高。
商业价值
对大量使用 Codex 进行日常编程的团队或个人有较高实用价值，可以将 DeepSeek 纳入 Codex 原生子 Agent 工作流，在代码检查、文本分析、实现建议等场景中提供额外模型选择，可能降低部分模型调用成本并提升多模型协作灵活性。其商业价值主要体现在开发效率提升、模型成本优化和 AI 编程工作流扩展，但受限于 Codex 桌面应用生态和非官方集成的不确定性。
01
技术亮点
- 自动化完成 Codex 子 Agent 的配置、状态检查、测试、修复、停用和卸载。
- 强调真实路由验证，不仅依赖子 Agent 自述，还校验数据库路由元数据和返回口令。
- API Key 通过标准输入传入，并保存到系统安全凭据库，避免写入配置文件、临时文件或测试输出。
- 写入配置和模型目录前会创建备份，解析或实时测试失败时支持恢复本次事务。
- 不修改主任务顶层模型或用户登录方式，侵入性较低。
- 支持 macOS 和 Windows 两个平台。
- 提供 repair 流程，适合父模型变化后的配置修复。
- 项目 README 对适用范围、日常使用边界和安全回滚规则描述较清晰。
02
目标用户
- 正在使用 ChatGPT/Codex 桌面应用的开发者
- 希望在 Codex 中调用 DeepSeek 作为子 Agent 的用户
- 需要降低模型调用成本或引入 DeepSeek 能力的 AI 编程用户
- 需要验证 Codex 子 Agent 路由是否真实生效的高级用户
- 团队内负责统一配置 AI 编程环境的工程师
03
配置要求
- 操作系统：macOS 或 Windows。
- Python 版本：3.11 或更高。
- 必须安装 ChatGPT/Codex 桌面应用。
- 必须拥有 DeepSeek 官方 API Key。
- 需要 npx/Node.js 环境以执行 skills add 安装命令。
- 默认 CODEX_HOME 为 ~/.codex，角色文件会写入 $CODEX_HOME/agents/DeepSeek.toml。
- macOS 下 API Key 保存到 Keychain，Windows 下保存到 Credential Manager。
- Windows 自动发现 codex.exe 失败时，可通过 CODEX_DESKTOP_BIN 指定 Codex 桌面应用二进制路径。
- DeepSeek 子 Agent 只处理文本；图片、视频、截图等视觉输入需要父 Agent 先转换为文字描述。
04
适用场景
- 首次将 DeepSeek 配置为 Codex 原生子 Agent
- 检查当前 Codex 是否已经正确注册 DeepSeek 子 Agent
- 在切换父模型后修复 DeepSeek 子 Agent 配置
- 验证任务是否确实被路由到 deepseek-v4-flash，而不是仅依赖模型自述
- 停用或卸载 DeepSeek 子 Agent 配置
- 让 Codex 主 Agent 在普通编码、审查、探索任务中派发文本任务给 DeepSeek
05
部署与配置
- 确认环境满足要求：macOS 或 Windows、Python 3.11+、ChatGPT/Codex 桌面应用、DeepSeek 官方 API Key。
- 通过 npx 全局安装 Skill：npx skills add oil-oil/codex-deepseek-subagent -g -y。
- 重启 ChatGPT/Codex 桌面应用，并新建任务使 Skill 生效。
- 在新任务中输入：帮我把 DeepSeek 配置成 Codex 的原生子 Agent。
- 按提示通过标准输入提供 DeepSeek API Key，工具会保存到系统凭据库。
- 等待自动执行状态检查、配置和验收。
- 看到 status: ready 后，再次重启桌面应用并新建任务。
- 之后可在普通任务中请求：用 DeepSeek 子 Agent 检查这个项目。
06
风险与注意事项
- 强依赖 ChatGPT/Codex 桌面应用的内部运行时、配置目录和子 Agent 机制，若上游应用更新，可能出现兼容性问题。
- 该项目并非 OpenAI 或 DeepSeek 官方项目，没有官方背书。
- 仅适用于 Codex 桌面应用场景，不适合作为通用 DeepSeek SDK 或通用 Agent 框架使用。
- 普通任务不应反复运行配置流程，否则可能造成不必要的配置变更或调试成本。
- DeepSeek 子 Agent 不支持视觉输入，处理多模态任务时需要父 Agent 预处理。
- Windows 下可能需要手动设置 CODEX_DESKTOP_BIN。
- 项目 star 数较高但 fork 数有限，生态和长期维护稳定性仍需观察。
- 涉及本地配置、凭据库和 Codex 运行时，企业环境中使用前需要进行安全审计。
2026-08-11
第25名
新收录 · github_search
