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 服务的开发者，该插件能有效降低配置成本，提升使用效率。