前言¶
DeepSeek Harness (DSH) 支持接入多種模型提供者。若要使用 Claude Pro 或 Max 訂閱,常規做法是通過 OAuth 流程(如 dsh-provider-login)接入,但這會將使用量計入第三方,而非 Claude 計劃額度。dsh-claude-bridge 通過 Agent SDK 驅動 Claude Code CLI,利用現有登錄憑證,將模型調用計入 Claude 計劃。
插件定位¶
dsh-claude-bridge 是一個由 shaneconner 維護的 DSH 插件。它允許將 Claude Pro 或 Max 訂閱作爲 DeepSeek Harness 的模型提供者,通過運行 Claude Code CLI 來處理推理請求。
核心功能¶
該插件實現了以下功能:
* 流式文本和推理:支持流式輸出和推理過程。
* 工具調用:支持多輪對話中的工具調用。
* Token 使用情況:包含緩存讀取和寫入的 Token 統計。
* 完成原因:返回模型的完成原因。
* 模型列表和解析:支持模型列表查詢與解析。
* 推理努力:支持控制推理努力程度。
* 一百萬 token 窗口:支持 1M token 上下文窗口(需配置開啓)。
安裝與啓用¶
安裝時需要指定 --profile web,安裝後需重啓 dsh。
dsh plugin --profile web add dsh-claude-bridge
安裝完成後,它會註冊一個名爲 claude-bridge 的提供者路由。它不會禁用其他模型提供者,而是並列存在,由 Agent 按配置選擇。
配置說明¶
插件運行需要你已登錄到 Claude Code。它不進行額外的認證,而是讀取 Claude Code CLI 寫入的憑據文件(位於 ~/.claude/.credentials.json 或 $CLAUDE_CONFIG_DIR/.credentials.json)。
在配置文件中添加如下內容:
- id: claude-bridge
name: 'dsh-claude-bridge'
config:
# 開啓 1M token 窗口。默認爲 false,開啓後若不在 Max 計劃下會消耗額外用量
longContext: false
# 指定運行不同的 claude 二進制文件。若不設置,將使用 Agent SDK 捆綁的 CLI
pathToClaudeCodeExecutable: /home/you/.local/bin/claude
# CLI 子進程的工作目錄,默認爲 Harness 進程的工作目錄
cwd: /home/you/project
插件接管了部分環境變量和配置,以避免干擾:
* 環境變量:強制設置 ENABLE_CLAUDEAI_MCP_SERVERS=0 和 DISABLE_AUTO_COMPACT=1。
* 配置加載:CLI 子進程不加載用戶、項目或本地的 settings.json,因此不會受到鉤子、插件或技能的干擾。
* 清理環境:從環境變量中移除了 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、CLAUDE_CODE_USE_BEDROCK 和 CLAUDE_CODE_USE_VERTEX,防止子進程誤用這些變量導致計費問題。
注意事項¶
- 憑證讀取:必須確保已通過終端的
claude命令完成登錄。 - CLI 來源:插件使用 Agent SDK 中捆綁的 CLI,而非系統 PATH 中的
claude命令。 - 取消機制:中斷信號如果 5 秒內未確認,操作會停止等待;否則取消的輪次會繼續運行至完成。
- 併發與歷史:會話按 Harness 會話 ID 保持;工具調用通過進程內 MCP 服務器進行,結果按 ID 配對;歷史記錄以內聯方式寫入提示詞而非恢復 CLI 會話文件。
- 許可證:基於 MIT 許可證開源。
生態背景¶
DeepSeek Harness 的插件生態獨立於 DeepSeek 官方。該插件倉庫地址爲 https://github.com/shaneconner/dsh-claude-bridge。