前言¶
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