grloper/dsh-claude-oauth：DSH 的 Claude OAuth 集成

前言¶

DeepSeek Harness (DSH) 採用插件化架構，旨在通過插件擴展其功能。在使用 DSH 進行 Claude 模型推理時，開發者通常需要手動處理 API 密鑰或令牌的獲取與刷新。grloper/dsh-claude-oauth 插件解決了這一痛點，它將 Claude Pro/Max 的 OAuth 認證流程直接集成到 DSH 的 Web 設置界面中，通過 Google/Gmail 賬號登錄，並自動處理令牌刷新、模型發現和配額追蹤。

插件介紹¶

grloper/dsh-claude-oauth 是一個模型推理類插件。它爲 DeepSeek Harness 提供了 Claude 的 OAuth 模型提供者支持。該插件由用戶 grloper 維護，採用 MIT 許可證。

核心功能¶

Web 界面一鍵登錄：在 DSH 的 Web 設置中提供 Claude 專屬入口，支持直接通過 Google 或 Gmail 賬號進行 OAuth 認證，無需在終端中手動操作。
零終端配置：無需手動複製令牌字符串或編輯 YAML 配置文件，所有認證狀態由插件在後臺管理。
雙棧 PKCE OAuth 引擎：支持 IPv4 和 IPv6 迴環地址，避免 Windows 環境下的本地迴環解析問題。
多存儲憑據同步：認證成功後，令牌會自動同步至 ~/.claude/.credentials.json（與官方 Claude Code CLI 共享）以及 ~/.dsh/.credentials.yaml。
實時配額與模型監控：在設置界面和聊天側邊欄顯示 5 小時和 7 天的訂閱使用量條形圖及重置倒計時；實時查詢 /v1/models 接口，自動掛載最新的 Claude 模型。

安裝與啓用¶

在安裝前，請確保當前 DSH 進程使用的是 Web profile，且系統環境滿足 Node.js >= 20。

dsh plugin --profile web add github:grloper/dsh-claude-oauth

安裝完成後，啓動 DSH Web GUI。

典型用法¶

啓動 Web 界面

    dsh web

進行身份驗證
- 在左側邊欄點擊齒輪圖標打開 Settings。
- 在導航列表中選擇 Claude 選項（位於 Antigravity 和 Codex 旁邊）。
- 點擊 “Sign in with Google / Gmail” 按鈕。
- 在彈出的瀏覽器窗口中，選擇你的 Google 賬號並點擊 Authorize。
- 認證成功後，設置頁面會顯示 “Claude Connected”，並展示當前郵箱、訂閱層級（CLAUDE PRO/MAX）及實時配額。
設置默認模型
若要將 Claude Sonnet 4.5 設爲默認模型，需編輯配置文件 ~/.dsh/settings.yaml：

    agent-default-model:
      provider: anthropic
      model: claude-sonnet-4-5

可選：命令行認證
也可以直接在終端運行內置腳本進行認證：

    claude-oauth-login
    # 或使用 npx
    npx dsh-claude-oauth

注意事項¶

環境依賴：插件運行需要 Node.js 版本 >= 20。
許可證：本項目採用 MIT 許可證，可在 GitHub 查看源碼與詳情。
生態背景：DSH 強調插件生態，該插件屬於社區貢獻，與 DeepSeek 或幻方官方無直接從屬關係，安裝前建議檢查源碼與許可證。

結語¶

該插件通過 OAuth 協議簡化了 Claude 在 DSH 中的接入流程，提供了自動化的令牌管理與配額監控。對於需要在 DSH 環境中頻繁切換或使用 Claude Pro/Max 服務的開發者，該插件能有效降低配置成本，提升使用效率。