双外部代理委派 Magica-Chen/dsh-preset-codex-claude

dsh-preset-codex-claude

一个 DeepSeek Harness 智能体预设，把 Codex 和 Claude Code 作为委派子代理提供出来，每个都分只读和完全访问两档——这样一个会话里，你可以用其中任意一个干活，也可以把同一个任务同时派给两个。

subagent_codex Codex full access
subagent_codex_readonly Codex read-oriented
subagent_claude_code Claude Code full access
subagent_claude_readonly Claude Code hard read-only

它用的是官方的 @deepseek-ai/dsh-subagent-codex 和 @deepseek-ai/dsh-subagent-claude-code 服务商——没有重新实现。Codex 走自己的 app-server 协议；Claude Code 走官方 Agent SDK。

它能给你什么

DeepSeek Harness 通常把整个任务交给一个模型。这个预设加了两个外部干活的，你可以在会话里把活派给它们：

- 每个任务单独挑干活的。 Codex 和 Claude Code 各有各的长处，也各有各的翻车方式。你不用再为整段对话只选一个。
- 每个任务单独挑权限档。 每个厂商都注册了两次——只读档用来做分析，完全访问档用来改文件、跑测试。
- 两个一起跑。 委派工具接受 run_in_background，所以你可以把同一个问题的不同部分分别派给 Codex 和 Claude Code，再对一下两边的答案。

它是一层很薄的声明式封装：四个服务商注册、四个工具，全都用官方服务商。没有 fork，没有包装，也没有重新实现任何一个智能体。

┌─────────────────────────────┐
your session ───▶│ subagent_codex │ Codex full access
(any model) │ subagent_codex_readonly │ Codex read-oriented
│ subagent_claude_code │ Claude Code full access
│ subagent_claude_readonly │ Claude Code hard read-only
└─────────────────────────────┘

⚠️ 先读这里：安装分两步

这个预设的服务商行由 DSH 加载器解析，解析时对照的是 dsh 安装目录， 不是你的配置档。装进配置档的 bundle 够不到它们。所以这不是一条命令就能装完的事，也所以只要服务商缺失，光装预设就会显示 “Failed to load”。

第 1 步 —— 把服务商包装进 dsh 安装目录。 每次升级 DSH 之后都要重跑这一步，因为升级会把它们丢掉：

DSH_INSTALL="$(dirname "$(dirname "$(readlink -f "$(command -v dsh)")")")"
npm install --no-save --prefix "$DSH_INSTALL" \
@deepseek-ai/dsh-subagent-codex@0.2.0-rc.2 \
@deepseek-ai/dsh-subagent-claude-code@0.2.0-rc.2

版本匹配不是做样子。如果某个服务商解析出的版本和宿主不一致，它就会注册进自己那份 ctx.subagents 服务，而不是宿主那个单例，委派会静默失败。doctor 会检查这一点。

第 2 步 —— 把这个预设装进你的配置档：

dsh plugin --profile web add github:Magica-Chen/dsh-preset-codex-claude

然后验证。这个包不在 npm 上，所以要从装好的副本里跑预检：

node "$HOME/.dsh/profiles/web/node_modules/dsh-preset-codex-claude/bin/doctor.mjs"

重启 dsh，新建一个会话 —— 模式会出现在预设选择器里。

没有 git？你也可以克隆仓库，让 dsh plugin add 指向本地目录：
dsh plugin --profile web add file:/path/to/dsh-preset-codex-claude

环境要求

- Node ≥ 18
- 一个 DSH web 配置档（dsh web）
- PATH 上至少有一个产品命令行，且已认证：
- codex —— codex login（或 OPENAI_API_KEY）
- claude —— claude login（或 ANTHROPIC_API_KEY）

两个不必都有。命令行缺失的层级就是跑不起来而已。

用法

新建会话时，在模式选择器里选 “Codex + Claude Code”，然后委派：

subagent_codex task="Run the test suite and fix the two failures in parser.js"
subagent_claude_code task="Review the diff on this branch for security issues"

每个子代理都从零开始，不带你的对话，所以它的提示词必须自包含。

两个产品都接受 run_in_background，所以一个会话可以各自独立派发，再汇总结果。配对是可选的，不是强制的 —— 人设里写得很清楚。

权限层级 —— 实际含义

| 工具 | 原生模式 | 写文件 | 跑命令 |
| subagent_claude_code | bypassPermissions | ✅ | ✅ |
| subagent_claude_readonly | dontAsk | ❌ | ❌（Bash 被拒） |
| subagent_codex | dangerously-bypass-approvals-and-sandbox | ✅ | ✅ |
| subagent_codex_readonly | never | 继承你的 ~/.codex 配置 | 继承 |

其中两个层级反直觉，而两者都是无人值守运行的后果：

- Claude 的只读层级是硬拦截。 每个非 bypass 模式都会装上 canUseTool: () => deny，而没有人盯着的时候，任何需要批准的操作都会被拒 —— 包括 Bash。所以 Claude 子代理除非处在 bypassPermissions，否则跑不了测试或构建。
acceptEdits 不是折中方案：它会自动接受文件写入，但仍然拒绝 Bash。
- Codex 的只读层级只是建议，不是强制。 never 模式不发送 sandbox 字段，所以 Codex 会继承你自己的 Codex 配置里的设置。只有 Claude 的层级才是保证。

注意事项

- 已有会话会保留它启动时的预设。 安装后必须新建会话；只重启 dsh 不会给已打开的对话补上预设。
- 预设加载失败后，会在进程生命周期内一直缓存。 如果加载失败，刷新页面没用——重启 dsh。
- 委派是一次性的。 这些服务商不提供可继续的模式，所以之后无法用 send_message 给 Codex/Claude 子进程发消息（不像 harness 内的 subagent / subagent_fork）。
- 完全访问层级是真的没有限制：--dangerously-bypass-approvals-and-sandbox 和 --bypassPermissions。这让它们适合无人值守场景，也意味着它们能改动进程能触及的任何东西。
只需要分析时，优先用只读层级。
- 这些服务商声明了 NO_START_CAPABILITIES，所以按子进程设置的 toolFilter 和 persona 不可用。权限级别在服务商注册时固定，因此这个预设把每个厂商注册两次，而不是暴露一个带开关的服务商。

工作原理

预设声明了四个 host-plane 服务商注册，外加四个委派工具。服务商注册在进程级的 ctx.subagents 单例上，所以它们的名字必须在整个进程内保持唯一——因此有了 codex-readonly / claude-readonly 这些不同的名字。

cordis.patch.yml 是生成的。generate-patch.py 保存了规范的行列表和 persona，是唯一的事实来源；它以原子方式写入补丁，所以安装后的副本永远不会写到一半。要改模式，编辑生成器并运行：

npm run build # python3 generate-patch.py

预检

bin/doctor.mjs 的存在是为了替代原本不透明的失败。它会验证安装锚点能否解析、两个服务商能否 从安装位置按宿主的确切版本解析、CLI 是否存在且已认证，以及预设声明在结构上是否健全——包括 plan-mode 行是否带有它必需的 section 指引。（漏掉这一项配置会导致整个预设加载失败，而报错信息永远不会解释原因。）

bin/doctor.mjs
✓ node 24.7.0
✓ dsh installation: …/node_modules/@deepseek-ai/dsh ✓ @deepseek-ai/dsh-subagent-codex@0.2.0-rc.2 ✓ 4 providers declared: codex, codex-readonly, claude-code, claude-readonly ✓ 4 delegation tools: subagent_codex, subagent_codex_readonly, …

有问题必须修复时，它会以非零状态退出，并打印出修复用的确切命令。

卸载

dsh plugin --profile web remove dsh-preset-codex-claude

要同时移除服务商：

bash
DSH_INSTALL="$(dirname "$(dirname "$(readlink -f "$(command -v dsh)")")")"
npm uninstall --no-save --prefix "$DSH_INSTALL" \
@deepseek-ai/dsh-subagent-codex @deepseek-ai/dsh-subagent-claude-code

兼容性

固定搭配 dsh 0.2.0-rc.2 和 provider 0.2.0-rc.2。其他 dsh 版本大概率需要对应的 provider 版本；版本不匹配时 doctor 会直接报错，不会让它悄悄失败。注意 npm 上这些包的 latest 标签还停留在更旧的 0.0.1-rc.1，所以务必显式固定版本。

许可证

MIT