前言¶
DSH 的定位是「一切皆插件」:模型接入、鉴权、命令、SDK 层都是可插拔的模块,外部模型通常靠 API Key + dsh-llm 之类的依赖接进来。但如果你手上已经有 Claude 订阅(按订阅而不是按量付费),多一套 API Key 管理、多一份额度计费,会多一层维护成本。dsh-claude-subscription 就是针对这个点做的插件:把 Claude 订阅账号接进 DeepSeek Harness,登录走 OAuth 授权链接,不用填 token。
这个插件由 apcamargo 维护,README 里明确写了是非官方项目:与 Anthropic、DeepSeek Harness 没有隶属、背书或支持关系,不提供担保。星标数在社区目录页显示为 0,版本 0.1.0,许可证 MIT(均来自目录页与仓库 package.json)。下面介绍它的能力边界和用法,不展开成营销文。
它解决什么问题¶
一句话:在 DSH 里以 Claude 订阅身份使用 Claude 模型,凭证由插件管理,而不是你手工配置 API Key。
与已有做法对比:
- 官方 API 接入方式是「填 Key + 按 token 付费」,Key 一般放本地配置或密钥管理里。
- 这个插件改成「授权登录 + 订阅额度」,免除 Key 维护和按量账单,代价是多一个需要刷新的 OAuth 凭证,以及把当前 dsh 进程的权限交出去访问该订阅。
核心功能¶
已核实的能力,全部来自 README:
- 通过
/claude-login发起 OAuth 授权,浏览器打开授权链接,批准后插件访问你的订阅。 - 支持多账号:多次执行
/claude-login会添加账号,每个账号在模型选择器里是独立分组,按关联邮箱标注。 - 账户与额度查询:
/claude-account看当前登录账号与 token 过期时间;/claude-usage看配额用量与重置时间(README 提到 5 小时与每周两个窗口)。 - 登出:
/claude-logout(指定账号或--all)删除已存凭证。 - 用量指示器:选到订阅账号下的模型时,消息输入框左侧出现 Claude 标记,填充色随主配额消耗而减少,点击打开详情面板。
- 设置页集成:Models 页新增「Claude subscription」分区,列出已登录账号、模型目录,并允许按账号编辑模型列表。
注意 README 中「Whichever account is signed in at claude.ai in your browser is the one that gets added」:授权的是浏览器当前登录 claude.ai 的账号,不是命令行参数指定的账号。
安装与启用¶
README 给出的安装命令:
dsh plugin --profile web add https://github.com/apcamargo/dsh-claude-subscription.git
这个命令走的是 profile 配置,--profile web 是仓库文档里的原样写法,不要凭插件名去拼 dsh plugin add github:owner/repo 之类的形式。
装完后在任意会话里登录:
/claude-login
它会打印一个授权链接并尝试在浏览器打开,在浏览器里批准即可。没用 --profile web 装或未在 web profile 生效时,客户端相关界面(用量指示器、Models 页分区)不会生效——这部分 README 没有展开,遇到就按上面的命令重装或确认 profile。
典型用法¶
- 首次登录:执行
/claude-login,浏览器批准授权。 - 查状态:
/claude-account看账号和 token 过期时间;/claude-usage看配额与重置时间。 - 多账号:切到想登录的账号(浏览器先登 claude.ai,或用无痕窗口打开授权链接),再执行一次
/claude-login。模型选择器里会多出一组按邮箱标注的账号。 - 退出:
/claude-logout <账号>删单个,/claude-logout --all删全部。
开发相关的命令(有源码改动时才用得上):
npm install
npm test
npm run verify
npm run build:client
npm run images
npm test 会重建 lib/client.js 并跑单元测试;npm run verify 通过真实 cordis runtime 挂载插件;改了 client-app.js 或 client-models.js 后用 npm run build:client 重新生成;README 里的图用 npm run images 重新渲染。
适用场景与注意¶
适合:已订阅 Claude、想在 DSH 里直接按订阅额度使用,不想维护 API Key 和按量账单的人;以及需要在一个界面里同时管理多个订阅账号的人。
不适合 / 需要谨慎的:
- 插件以当前 dsh 进程的权限运行,授权后它能用你的订阅身份访问 claude.ai。安装前先读源码、确认
cordis.patch.yml之类补丁内容,再决定是否授权。 - 它是第三方非官方实现,README 明确无担保、无支持、无连带责任。Anthropic 的订阅条款是否允许这种自动化用法,需要你自己确认,本插件不做判断。
- 0.1.0 阶段,接口小型、星级低,出问题没有上游支持渠道,Issue 能否被回复是不确定的。
结尾¶
这个插件的价值很集中:把 Claude 订阅账号通过 OAuth 接进 DSH,顺带提供多账号、配额查询和界面层的用量提示,减少 Key 管理这一类事务性工作。如果你已经有订阅并且清楚第三方接入的风险,可以按上面的命令装上试一个账号。
目录页:https://www.skillhub.cn/plugins/apcamargo/dsh-claude-subscription
仓库:https://github.com/apcamargo/dsh-claude-subscription