Windows版DeepSeek Harness调用Codex和Claude Code教程

共计 7779 个字符，预计需要花费 20 分钟才能阅读完成。

介绍

DeepSeek Harness（DSH）可以把一个独立任务交给原生 Codex 或 Claude Code 执行，再把最终结果交回当前对话。对应的真实工具名是 subagent_codex 和 subagent_claude_code。有些人会把后者写成 subagent_claude_codex，这是笔误，后文统一使用正确名称 subagent_claude_code。

这篇教程以 Windows 的 web Profile 为例，讲清楚 Provider 安装、Preset 工具暴露、权限、重启、前后台调用和常见故障。命令里的 web 可以替换为你实际使用的 <profile>。本文已按本机 DSH 0.1.5-rc.2、已安装 Bundle 文档和 DeepSeek Harness 官方仓库核对。

先理解两层配置

安装 Bundle 和让模型看到工具是两件事，缺一不可：

只安装 Provider 时，Host 已经具备能力，但普通 Agent 仍看不到工具；只在 Preset 里启用工具而未安装 Provider，工具也找不到实际后端。

这两个 Bundle 使用包内锁定的原生 CLI/SDK 载荷，不会因为系统 PATH 中恰好有 codex 或 claude 就自动启用，也不会回退到全局 CLI。不过，Codex 和 Claude Code 的原生登录、用户配置、项目配置仍然是权威来源，DSH Provider 不会替你创建账号、登录或改写原生设置。

安装前建议先确认原生产品能够正常认证。Codex 可使用 codex login；Claude Code 可先运行 claude，再在交互界面执行 /login。如果已经登录并能正常使用，一般不需要重复操作。

安装两个Provider Bundle

打开 PowerShell，执行：

dsh plugin --profile web add @deepseek-ai/dsh-subagent-codex
dsh plugin --profile web add @deepseek-ai/dsh-subagent-claude-code

官方命令会把包安装到目标 Profile，同时把 Bundle 加入 Profile 清单。不要只在目录中运行普通 pnpm add，否则可能只装了依赖，却没有完成 Bundle 注册。

检查安装结果：

$ProfileDir = "$env:USERPROFILE.dshprofilesweb"
$Profile = Get-Content "$ProfileDirpackage.json" -Raw | ConvertFrom-Json
$Profile.dependencies.PSObject.Properties.Name |
    Where-Object { $_ -like '@deepseek-ai/dsh-subagent-*' }
$Profile.dsh.profile.bundles |
    Where-Object { $_ -like '@deepseek-ai/dsh-subagent-*' }

依赖和 dsh.profile.bundles 中都应出现：

@deepseek-ai/dsh-subagent-codex
@deepseek-ai/dsh-subagent-claude-code

还可以先检查合成配置是否有效：

dsh --profile web --dump-config > $null
if ($LASTEXITCODE -eq 0) { 'Profile 配置合成成功' }

配置Provider权限

Profile 的用户补丁文件位于：

%USERPROFILE%.dshprofileswebcordis.patch.yml

下面是追加片段，不是完整文件。保留文件中所有现有内容，把两段追加到顶层 YAML 数组；如果已经存在相同 id，就在原有 config 中修改，不要再写一份重复项。

普通用户日常编码可先采用下面的折中方案：Claude Code 允许文件编辑但拒绝其他无人值守权限请求，Codex 自动评审权限请求。

- id: subagent-claude-code
  config:
    permissionMode: acceptEdits

- id: subagent-codex
  config:
    permissionMode: approve-for-me

Claude Code权限模式

Codex权限模式

本机当前为了无人值守执行，实际使用的是下面这组全权限配置：

- id: subagent-claude-code
  config:
    permissionMode: bypassPermissions

- id: subagent-codex
  config:
    permissionMode: dangerously-bypass-approvals-and-sandbox

这会允许子代理在父会话工作区中运行命令、修改甚至删除文件，并绕过常规审批或 sandbox。普通用户不要直接照抄；确需使用时，应在可信仓库、虚拟机或容器中运行，并提前提交代码或做好备份。

使用环境变量凭据

两个 Provider 会先清理父进程环境中具有凭证特征的变量，再叠加 Provider 的 env。因此，如果你不是使用原生登录文件，而是依赖 OPENAI_API_KEY、ANTHROPIC_API_KEY 等环境变量，就要在相应 Provider 的 config 中显式传入。

下面仍是追加到现有 Provider 的 config 内的可选字段，不要重复创建相同 id，也不要把真实密钥直接写进 YAML：

- id: subagent-claude-code
  config:
    permissionMode: acceptEdits
    env:
      ANTHROPIC_API_KEY: !!js process.env.ANTHROPIC_API_KEY

- id: subagent-codex
  config:
    permissionMode: approve-for-me
    env:
      OPENAI_API_KEY: !!js process.env.OPENAI_API_KEY

先在 Windows 用户环境中安全保存变量，再从新开的 PowerShell 启动 DSH。使用原生网页登录状态时通常不需要这两个 env 字段。

暴露两个委派工具

不要直接修改 DSH 安装目录中的内置 standard Preset，升级后可能被覆盖。推荐复制内置标准模式，创建一个用户 Preset，例如：

ID：standard-native-subagents
名称：标准模式 + 原生子代理

最稳妥的做法是在 DSH 中新建“创造模式”会话，把下面这段发给它：

请复制内置 standard Agent Preset，创建一个用户预设：

ID：standard-native-subagents
显示名称：标准模式 + 原生子代理

保留标准模式的所有配置，只修改以下两项：
1. 启用 tool-subagent-codex
2. 启用 tool-subagent-claude-code

两个工具使用：
- provider: codex / claude-code
- toolName: subagent_codex / subagent_claude_code
- backgroundMode: one-shot
- maxDepth: provider-managed

不要修改内置 standard 预设。创建后执行 standingKeyFor 挂载校验。

用户 Preset 通常位于：

%USERPROFILE%.dsh.agent-presetsstandard-native-subagents

复制后的 agent.cordis.yml 已经有这两行，只要删除各自的 disabled: true。下面是启用后的局部片段，位置在 delegation 组的 config 列表中，不是完整文件，也不要在已有行之外重复追加：

    - id: tool-subagent-codex
      name: '@deepseek-ai/dsh-tool-subagent'
      config:
        provider: codex
        toolName: subagent_codex
        backgroundMode: one-shot
        maxDepth: provider-managed

    - id: tool-subagent-claude-code
      name: '@deepseek-ai/dsh-tool-subagent'
      config:
        provider: claude-code
        toolName: subagent_claude_code
        backgroundMode: one-shot
        maxDepth: provider-managed

preset.yml 是这个目录中的完整小文件，可以写成：

name: 标准模式 + 原生子代理
description: 标准模式的用户副本，额外启用 Codex 与 Claude Code 原生子代理。

懒人版：让Agent自动安装配置

不想一步步手装的话，把下面整段交给具有本机文件和 PowerShell 权限的 DSH“创造模式”Agent 或其他可信编码 Agent。不要在提示词里粘贴任何密钥：

请直接在 Windows 上安装、配置并验证 DeepSeek Harness 的 Codex 与 Claude Code 原生子代理，做完告诉我结果，不要反问。

目标 Profile 是 web；若实际不存在，先报告并停止。操作前读取并备份 %USERPROFILE%.dshprofileswebpackage.json 和 cordis.patch.yml，不得覆盖现有配置。

1. 执行：
   dsh plugin --profile web add @deepseek-ai/dsh-subagent-codex
   dsh plugin --profile web add @deepseek-ai/dsh-subagent-claude-code
2. 确认 web Profile 的 dependencies 和 dsh.profile.bundles 都包含上述两个包，并运行 dsh --profile web --dump-config 做合成校验。
3. 在 cordis.patch.yml 的既有顶层数组中配置 Claude Code permissionMode 为 acceptEdits、Codex permissionMode 为 approve-for-me。已有相同 id 就合并 config，禁止重复和整文件覆盖。
4. 不要索取、读取或输出 API Key。原生登录是权威来源；若用户明确依赖环境变量，只用 !!js process.env.ANTHROPIC_API_KEY / OPENAI_API_KEY 映射到 Provider env，绝不把真实值写入文件。
5. 复制内置 standard Preset 为用户 Preset standard-native-subagents，显示名称“标准模式 + 原生子代理”；只删除 tool-subagent-codex 和 tool-subagent-claude-code 两行的 disabled: true，保持 provider、toolName、backgroundMode: one-shot、maxDepth: provider-managed 不变。不得修改内置 standard。
6. 执行 standingKeyFor 挂载校验。不要擅自终止正在运行的 DSH；告诉我完整停止 dsh web、打开新 PowerShell并重新运行 dsh web。
7. 我回复“已重启”后，使用该 Preset 新建会话，确认工具目录中有 subagent_codex 和 subagent_claude_code，并分别进行一次只读真实调用：只检查当前工作区并返回一句概述，不修改文件。
8. 最后报告 Bundle 版本、Profile 校验、Preset 路径、两个工具是否暴露、两次真实调用结果和安全配置，不显示任何凭据。

完整重启并验证

安装 Bundle 或修改 Profile 后必须完整重启 DSH Web Profile，仅刷新浏览器不够：

1. 在运行 dsh web 的 PowerShell 中按 Ctrl+C；
2. 等进程完全退出；
3. 如果刚设置了 Windows 用户环境变量，关闭并重新打开 PowerShell；
4. 回到平时使用的工作目录，运行：

dsh web

然后刷新页面，使用“标准模式 + 原生子代理”新建会话。已有内容的旧会话不会动态获得新工具，也通常不能中途切换 Preset。

先做两次只读冒烟测试：

请调用 subagent_codex，只读检查当前项目，不要修改文件。返回是否成功启动，并用一句话概述项目。

请调用 subagent_claude_code，只读检查当前项目，不要修改文件。返回是否成功启动，并用一句话概述项目。

两者都会继承父 DSH 会话的当前工作目录。每次调用都是一个全新的、一次性的原生线程或 query，不会续接上一次子代理会话；父 Agent 只收到最终答案或安全错误，不会收到完整推理、工具过程、stderr 或工作区 diff。

工具参数和后台任务

模型调用两个工具时常用三个参数：

两个工具都配置为 backgroundMode: one-shot。前台调用时，父 Agent 会等待子代理执行完再继续回复；项目较大或网络较慢时，界面可能长时间没有新输出，看起来像“卡住”。这不一定是 DSH 死锁。

耗时任务建议直接这样说：

请调用 subagent_codex 在后台只读审查当前项目的权限边界。description 写“Codex 权限审查”，prompt 中要求列出高、中、低风险并附文件位置，run_in_background 设为 true。启动后把 Job ID 告诉我，完成时用 job_output 取回结果。

请调用 subagent_claude_code 在后台检查测试覆盖缺口。description 写“Claude Code 测试审查”，prompt 中要求只读、不修改文件、按优先级给出建议，run_in_background 设为 true。任务完成后用 job_output 获取最终结果。

后台启动后会先得到 Job ID。任务仍在运行时，可以让父 Agent 稍后用 job_output 查询；收到完成通知后，再用 job_output 获取最终答案或失败状态。确定不再需要时可用 job_kill 取消。Provider 没有按实际经过时间自动触发的总超时，长任务不要一直放在前台等。

常见问题

如果 DSH 自带联网搜索可以使用，但 Codex 或 Claude Code 子代理的联网/MCP 工具失败，也应优先检查对应原生产品的设置与权限。它们是独立运行环境，不会自动继承父 Agent 的所有工具。

安全建议

• 第一次验证只做只读任务，确认登录、工作目录和结果回传都正常后再允许写入；
• 普通编码优先使用 Claude Code 的 acceptEdits 和 Codex 的 approve-for-me，按任务逐步放宽；
• bypassPermissions 与 dangerously-bypass-approvals-and-sandbox 只适合可信、隔离、可回滚的环境；
• prompt 要自包含，明确允许修改的目录、禁止触碰的文件和验收方式；
• 子代理取消前已经产生的文件或外部副作用不会自动回滚，重要项目先提交 Git；
• 不要在聊天、YAML、截图或日志中暴露 API Key、Token、Cookie、代理地址等敏感信息。

小结

在 DSH 中调用原生 Codex 和 Claude Code，需要先给 Profile 安装两个 Provider Bundle，再通过自定义 Agent Preset 暴露 subagent_codex 与 subagent_claude_code。配置完成后必须完整重启 dsh web，并使用该 Preset 新建会话。短任务可前台等待，长任务用 run_in_background: true 启动，再通过 job_output 收取结果。

官方资料：

• DeepSeek Harness GitHub仓库
• Codex Subagent Provider中文文档
• Claude Code Subagent Provider中文文档
• OpenAI Codex认证文档
• Anthropic Claude Code权限文档