用Claude订阅驱动Hermes Agent：Direct SDK插件实战指南

Anthropic 曾封堵通过 auth token 将 Claude 订阅用于第三方 agent 的做法，这让不少习惯用 Opus 系列驱动自己 agent 的用户被迫转向 GPT、Grok 或本地模型。据 YouTube 频道分享，Nous Research 推出的 Claude Subscription Direct SDK 插件重新打开了这条路——不是绕过规则，而是通过官方 Claude Code CLI 作为传输层，让订阅在 Hermes Agent 中合规可用。本文整理插件的安装方式、运行原理，以及它与 Claude Code、Buzz 等 agent 框架的本质差异。

插件是什么：官方CLI做传输，不是token破解

这个插件由 Nous Research 发布，定位是对接 Claude 订阅的官方方案。作者称已连续使用数周，稳定无异常。它与早先被禁止的 token 注入方式有本质区别：插件并不直接拿订阅凭证去调用 API，而是复用本机已登录的 Claude Code CLI，把它当成模型请求与响应的通道。

插件目前仍被标注为实验性，原因是"重放行为对 CLI 版本敏感"，也就是说 Claude Code 的版本更迭可能影响插件表现。作者提醒，Anthropic 随时可能调整政策，但就当前而言，这种用法是被允许的。这一点很重要——它意味着用户不必担心账号风险，同时也能继续享受 Opus 系列（作者认为 Opus 5.5 在同类模型中优势明显）的能力。

Claude Code CLI 是 Anthropic 官方发布的命令行工具，用户通过 claude 命令在终端内与 Claude 模型交互，支持登录订阅账号、执行本地文件操作与工具调用。其登录态以 OAuth 凭证形式存放在本机配置目录，CLI 在每次调用时自动完成凭证刷新与请求签名。正因为凭证由官方程序保管和流转，第三方工具只要复用这个已登录进程，就不必触碰原始 token，从而在合规边界内使用订阅额度。这也是该插件与早先“抓取 auth token 直接调用 API”方案的根本分水岭——后者把凭证暴露给了非官方代码，前者则让官方二进制全程掌控认证环节。

三种安装方式：桌面端、终端与对话内

插件提供了多条安装路径，覆盖不同使用习惯的用户。

方式一：桌面端插件目录

在 Hermes 桌面应用的 Capabilities 标签下进入 Plugins，即可看到 Hermes agent 插件目录。在 Models 分类下能找到 Claude Subscription Direct SDK，点击 "add to agent" 直接安装，也可复制它给出的终端命令手动执行。

方式二：终端命令安装

核心命令为 hermes plugins install claude-subscription-direct-sdk，默认安装到 Hermes 配置文件。若要装到指定 profile，需要在命令中带上 profile 名，例如 video producer plugins install claude-subscription-direct-sdk。安装过程会自动拉取 GitHub 仓库并处理所需的 Python 依赖。

方式三：对话内安装

这是作者认为最新颖的方式：直接在聊天中让 agent 安装插件，它会弹出带有官方标识的插件卡片，确认后点击即可完成安装，全程无需离开对话界面。

安装完成后，在模型选择列表中就能看到该插件，并可从中挑选具体的 Claude 模型，包括当时最新发布的 Haiku 5.5 与 Opus 5.5。作者特别提到 Opus 5.5 的上下文窗口达到 100 万 token，不受长度限制困扰。整个过程没有 OAuth 授权页，也不需要粘贴任何 token——因为 CLI 本身已处于登录状态，插件直接复用该会话。

运行原理：Claude是大脑，Hermes是agent

理解这个插件，关键在于分清"谁在跑 agent"。

工作流是这样的：Hermes 作为 agent 负责整体调度，官方 Claude CLI 作为传输层，Claude 模型作为后端。Claude 返回文本和工具请求，Hermes 执行工具并把结果回传。每一次模型调用都会启动一个临时的 CLI 进程，并重放相关对话上下文。

用一句话概括：Claude 是大脑，Hermes 是 agent。agent 循环、工具执行、审批、委派、记忆、技能、会话管理与上下文压缩全部由 Hermes 掌控，因此切换到该插件不会损失任何 agent 层面的能力。Claude Code 自带的原生工具则不会被使用。

这种设计也解释了它为何合规：订阅凭证始终在官方 CLI 内部流转，Hermes 只是消费模型输出。

stream JSON 协议 是 Claude Code CLI 提供的一种结构化输出模式：以 --output-format stream-json 启动时，CLI 会按行输出 JSON 事件，涵盖消息增量、工具调用请求和最终结果，便于外部程序逐条解析而不必处理人类可读的终端文本。插件正是借助这一协议与 CLI 通信——每次模型调用启动一个临时 CLI 进程，写入对话上下文，再读取流式返回的事件。由于该协议属于 CLI 对外暴露的稳定接口，插件无需依赖 Anthropic 的 Python agent SDK 包，但对 CLI 版本变化较为敏感，协议字段调整会直接影响重放行为，这也是插件被标记为实验性的技术原因。

与Claude Code、Buzz的本质差异

作者抛出了一个比"如何登录"更关键的问题：到底是谁在运行 agent。

在 Claude Code 和 Buzz 这类工具中，Claude 本身就是 agent——工具执行由 Claude 的运行时完成，应用层只提供 UI、权限控制与编排。Buzz 通过 ACP 桥接，Claude Code 走 agent SDK，但本质相同：Claude 的运行时在跑 agent。

Hermes Direct SDK 则相反：Claude 只承担传输职责，工具执行与 agent 循环归 Hermes 所有，已登录的 CLI 仅提供模型响应。

"Direct SDK"这个名字略有误导性。它直接使用原生的 stream JSON 协议通信，因此不依赖 Claude 的 Python agent SDK 包，但要求使用未经修改的官方 Claude Code 可执行文件。

ACP（Agent Client Protocol） 是一套用于连接编辑器/客户端与 agent 运行时的开放协议，目标是让不同的 agent 后端以统一接口接入各类前端。Buzz 通过 ACP 桥接 Claude，意味着 Claude 的运行时仍然是真正的 agent 执行者，Buzz 只负责界面呈现与请求转发。这与 Hermes 的方案形成对照：ACP 解决的是“前端如何连上 agent”，而 Direct SDK 插件解决的是“agent 循环放在哪里”。理解这一层区别，就能明白为何同样对接 Claude，Buzz 与 Hermes 在工具执行归属、记忆管理和审批流程上会呈现完全不同的能力边界。

实测对比：响应速度与输出风格

作者做了同题对照测试：在 Claude Code 和 Hermes（均用 Opus 5.5）中同时提问"什么是 Claude agent SDK"。结果显示 Hermes 更快给出最终答案，输出也更紧凑；Claude Code 的回答更为冗长。

作者将风格差异部分归因于自己的 skills 配置和 SOUL.md 文件——他偏好简短回答，而 Hermes 还内置了文档查询类技能。速度上，Hermes 胜在更少的中间步骤，而非模型本身更快。

适用人群与注意事项

这套方案适合已经订阅 Claude、又想在自有 agent 中复用订阅额度的用户，尤其是看重 Opus 5.5 能力、同时不愿放弃 Hermes 记忆与技能体系的人。

需要留意的点有三个：插件仍属实验性，CLI 版本变动可能影响稳定性；Anthropic 的政策随时可能变化，当前可用不代表长期可用；插件依赖本机已登录的 Claude Code，跨设备或多账号场景需要额外确认登录状态。

对于想进一步深挖 agent 技能与工作流的用户，作者也推荐了自己的知识库项目 AgentWikis，提供标准 wiki 与付费 Pro 订阅两种形式。