dsh-claude-code-local：在 DeepSeek Harness 中調用本地 Claude Code

DeepSeek Harness 採用插件化架構，旨在提供靈活的模型接入能力。在本地開發或特定環境下，直接調用已安裝的 Claude Code CLI 而非通過遠程 API，是常見的需求。dsh-claude-code-local 插件解決了這一痛點，它將本地 Claude Code 註冊爲 DSH 的 LLM 提供商，無需在 Harness 中配置 API 密鑰。

插件概況¶

名稱：dsh-claude-code-local
所有者：NGdust
許可證：MIT
核心功能：註冊 claude-code 路由，在流式 JSON 模式下生成本地 claude CLI 進程，並將輸出實時轉換爲 Harness 聊天界面。

安裝與前置條件¶

安裝前需確認環境滿足以下條件：

DeepSeek Harness 版本：需安裝 0.1.0-rc.7 或更新版本（支持 web、headless 或 DSH Desktop）。
本地 Claude Code CLI：已安裝並完成認證。

執行安裝命令：

dsh plugin --profile web add dsh-claude-code-local

安裝完成後，重啓服務器或應用以加載插件。

核心功能¶

本地運行：直接調用本地 claude CLI，利用其內置的 Agent 循環、工具調用和權限管理。
流式輸出：通過 --output-format stream-json 模式獲取實時響應，支持文本增量、思考過程和工具調用。
憑據管理：不使用 DSH 的 API Key，完全依賴本地 CLI 的憑據（如 ~/.claude、ANTHROPIC_API_KEY、OAuth 等）。
兼容性：支持現有的 Claude Code 設置，包括 Skills、Commands 和 MCP Servers。

配置與使用¶

1. 選擇模型¶

在 Harness 的 Composer 模型選擇器中，找到 Claude Code (local) 組。該組會根據本地 CLI 的解析結果顯示可用模型列表（如 claude-opus-5、claude-sonnet-5 等）。

2. 基礎配置¶

配置文件位於 $DSH_HOME/settings.yaml（默認爲 ~/.dsh/settings.yaml）。插件提供 llm-claude-code 配置節，支持熱重載。

llm-claude-code:
  # 可選：設置 Claude Code CLI 的可執行文件路徑
  # 如果 CLI 不在 PATH 中，需填寫絕對路徑
  executable: claude

  # 權限模式：auto | acceptEdits | bypassPermissions | manual | dontAsk | plan
  permissionMode: auto

  # 限制每個請求的內部 Agent 輪次
  maxTurns: 10

  # 流式空閒超時（毫秒），若 CLI 長時間無輸出則終止請求
  streamIdleTimeoutMs: 300000

3. 驗證¶

選擇任意模型併發送消息。如果配置正確，響應將直接從本地 CLI 流式傳輸到界面中。

限制與注意事項¶

平臺限制：僅支持 macOS 和 Linux。Windows 用戶需使用 WSL。
無狀態請求：每個請求都是一次全新的 CLI 調用，不共享跨請求的上下文或 Prompt 緩存。
工具與採樣控制：
- Harness 的工具不通過此提供商運行，Claude Code 擁有獨立的權限和沙箱控制。
- Harness 請求中的 maxTokens、temperature 和 stop 參數將被忽略，採樣參數完全由本地 CLI 控制。
版本依賴：必須使用 DSH 0.1.0-rc.7 或更高版本。

總結¶

該插件爲需要在本地環境中使用 Claude Code 能力的開發者提供了一種低延遲、無密鑰依賴的接入方式。通過配置文件，可以靈活控制權限模式、最大輪次和超時時間，適合需要深度集成 Claude Code 工作流或處於受限網絡環境的場景。