前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在将复杂任务拆解。在本地进行编码任务时，直接调用 Claude Code 订阅需要处理 SDK 集成、权限管理和状态同步。dsh-claude-code 插件解决了这个问题。它利用官方 Claude Agent SDK，将自包含的编码子任务委派给本地 Claude Code 订阅执行，结果回传给 DSH。DSH 作为 Leader，Claude Code 作为 Worker。
核心能力¶
该插件不提取 OAuth token，走官方 Claude Agent SDK，确保合规使用订阅。
- 内置 Skill：提供
claude-code-delegationskill，装好即出现在技能目录。 - 记忆与异步：支持
resume跨轮记忆（传入sessionId），支持run_in_background后台异步任务。 - 监控面板：内置 Web 端监控面板，可查看订阅额度、任务列表和实时输出。
- 工具与控制：内置
claude_code_usage工具查看额度，支持结构化输出、成本上限和自定义 subagents。
安装与启用¶
通过 DSH 官方命令安装：
dsh plugin --profile web add dsh-claude-code
安装后需重启 DSH 才能加载 Web 监控面板等组件。
配置项¶
插件支持多种配置，以下是常用选项：
| 字段 | 默认值 | 说明 |
|---|---|---|
model |
sonnet |
Claude 模型别名或完整 id |
permissionMode |
acceptEdits |
权限模式，acceptEdits 自动放行编辑 |
maxTurns |
100 |
每次任务最大轮数 |
timeoutMs |
600000 |
协作超时时间（毫秒） |
thinkingMode |
未设 | 思考模式，建议替代旧参数 maxThinkingTokens |
proxy |
未设 | 代理设置，用于解决 Anthropic 403 问题 |
若需解决 Anthropic 403 问题，可在配置中设置 proxy。建议使用 thinkingMode 替代旧的 maxThinkingTokens 参数。
工具使用¶
插件提供以下工具供 DSH 调用：
claude_code¶
将编码任务委派给本地 Claude Code。
参数：
* task（必填）：任务描述。
* cwd：工作目录，默认为 DSH cwd。
* run_in_background：设为 true 时转为后台任务，立即返回 jobId。
* resume：传回上次的 sessionId 以保持上下文。
返回： 最终结果文本 + sessionId + token 用量等。
claude_code_usage¶
查看本机 Claude 订阅额度。
返回： 5 小时/7 天窗口百分比、重置时间、订阅档位等数据。
使用示例¶
1. 前台执行任务
{ "task": "修复 src/parser.ts 里 parse() 对空输入的崩溃", "cwd": "/path/to/repo" }
2. 后台异步执行
{ "task": "把 src/ 全量迁移到新的 logger API", "run_in_background": true }
3. 多轮迭代
// 第二轮传入上次的 sessionId
{ "task": "上一步的修复里你漏了边界情况 X，补上", "resume": "abc-123" }
注意事项¶
- 本地缓存：使用本地缓存（
~/.claude.），不读取账号敏感信息。 - 后台任务依赖：后台任务必须安装
dsh-tool-jobs，否则会报错。 - 任务历史：任务只存在于当前 DSH 进程内，每会话保留最近 20 条。
- Web 面板：给已装好的插件补上 Web 面板后必须重启 DSH。
- 网络问题：通过
proxy设置解决 Anthropic 403 问题。 - 参数变更：
maxThinkingTokens为旧参数，建议改用thinkingMode。
结尾¶
该插件利用官方 SDK 将本地 Claude Code 订阅能力集成到 DSH 中，适合需要本地执行、成本可控的编码场景。更多细节可参考项目主页。
- 项目主页：https://github.com/zhangjunjesse/dsh-claude-code
- 插件目录：https://www.skillhub.cn/plugins/zhangjunjesse/dsh-claude-code
