跳到主内容

subagent-claude-code 使用指南

让 DSH 在委托会话里以一次性无人工方式拉起官方 Claude Code 子代理：通过 `dsh-subagent` 把一条纯文本任务交给 Claude Agent SDK 运行并按严格成功条件回传最终答案。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

subagent-claude-code

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:fufankeji/deepseek-harness-studio#path:packages/subagent/subagent-claude-code

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • Electron 桌面端：提供应用窗口、系统托盘、单实例运行、外部链接处理和安全的 preload 通信接口。
  • 本地 Harness Host：桌面主进程启动 dsh web，等待本地服务就绪，并在应用退出时关闭 Host 进程。
  • Web 工作区：保留 DeepSeek Harness 的会话、工作区、模型、工具、Skills 和插件运行能力。
  • 插件发现与推荐：自动读取在线目录，通过精选、最近更新、生态热门、场景分类和搜索，帮助用户快速找到值得尝试的插件。
  • Agent 智能找插件：用一句自然语言描述需求，Agent 自动检索公开 dsh-plugin 目录、筛选相关候选并说明推荐理由。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个包和 dsh 直接连 Claude 模型有什么区别？

它不是把 DSH 本身的模型换成 Claude，而是让 DSH 临时把一条文本任务委托给另一个独立的 Claude Code 进程来跑——子进程走的是 Claude 的原生工具、沙箱和账户状态，跟 dsh-base 里配的 DeepSeek 主模型互不干扰（README.md:5 / src/run.ts:423-431）。

子进程需要联网吗？怎么给它 API key？

需要。Claude Code 子进程走它自己的原生账户认证，DSH 这边只负责把环境变量透传过去；把 key 写在 Profile 配置的 env.ANTHROPIC_API_KEY 里是最稳的写法（其它看起来像凭证的进程环境变量在子进程启动前会被显式剥离，见 README.md:42 / src/run.ts:321）。

安装了但模型从来没自动调用过，正常吗？

正常。安装只让 dsh-base 多挂一个叫 claude-code 的"休眠" provider，到底哪次会话能用它要由具体的 Agent Preset 决定——full Preset 默认把 subagent_claude_code 工具行设成 disabled: true，需要复制一份 Preset 再去掉该字段才会暴露给模型（README.md:52）。

出现 query-start / unknown 错误排查什么？

大概率是子进程根本没能起来。SDK 自带的 Claude CLI 平台包在安装时按系统/CPU 选择，如果当时跳过了 optional dependencies、平台不被支持或载荷文件缺失，provider 注册仍能成功但第一次委派会立刻抛 query-start / unknown，原始原因只在日志里（README.md:103）。

任务给一半可以中途取消吗？取消和超时是一回事吗？

可以中途取消，但本包没有按经过时长触发的"超时"——委派方自己调用 abort signal 才能停下任务，没有取消的话任务跑多久 DSH 就等多久，且取消前子进程已经动过的文件或外部状态不会被自动回滚（README.md:149）。

能选 Claude 模型吗？能把 Opus/Sonnet/Haiku 喂给同一个 provider 吗？

模型、instructions、tool 都由 Claude Code 原生设置说了算，DSH 不替它挑模型；同一个 provider 实例每次跑都一样，由 Claude settings 文件里的内容决定。如果要换模型要改 Claude 那侧的配置，本包的 Profile config 里没有模型字段（README.md:42 / src/index.ts:107-120）。

能看子 Claude 在执行什么吗？工具调用细节会回传给 DSH 吗？

看不到，也不回传。子进程的推理、中间消息、工具调用、std err、用量信息、产物 diff 都只留在 Claude 那侧，DSH 这边最多拿回"最终一段文字"或者失败诊断；想复现子过程的输出只能去翻 Claude 自己的日志（README.md:147）。

permissionMode 该选哪个？bypassPermissions 安全吗？

不需要外部提示人就用默认的 dontAsk，子进程对没预先授权的操作会直接拒绝；要让子进程能改文件但仍不允许弹权限框就用 acceptEdits；想 Claude 自己判断就用 auto；只让 Claude 改计划但不执行用 plan；bypassPermissions 是把原生 confirmation 直接关掉、绕过权限检查，会让子进程像脱缰一样能改所有东西，原则上只在沙箱环境里用（README.md:34-40 / src/run.ts:323-342）。

卸载这个包会不会带走什么副作用？

没有持久副作用。卸载后下一次 Profile 启动就把这个 provider 注销，本包没有任何独立磁盘写入或独立账户创建；登录态、Claude settings 文件、缓存都还在 Claude 那一侧独立保留（README.md:44 / README.md:144）。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.8
  • Node: ^22.19.0 || >=24.0.0
  • Platforms: macOS, Windows, Linux
  • Native modules: @anthropic-ai/claude-agent-sdk（自带平台包，含 claude/claude.exe 二进制）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则

subagent-claude-code 使用指南