疯狂的时间线….Opus 5.5刚刚发布。Hermes Agent现在正式支持Claude Pro/Max订阅。现在开始狂欢吧。在此安装插件：https://hermes-agent.nousresearch.com/docs/plugins/claude-subscription-directsdk

claude-subscription-directsdk · 插件目录 | Hermes Agent

来源：https://hermes-agent.nousresearch.com/docs/plugins/claude-subscription-directsdk

README

基于审核提交602393b↗ (https://github.com/NousResearch/hermes-plugin-claude-subscription-directsdk/blob/602393b6d3ea148bc618cd23da1a13fa332e1433/README.md)；内容会在作者重新锁定版本时更新。

Claude Subscription DirectSDK（实验版） — Hermes 插件

Claude Subscription DirectSDK — 一个Hermes模型提供者插件：Hermes → claude CLI → stream-json，使用您的Claude Pro/Max订阅。

独立的Hermes Agent模型提供者插件：claude-subscription-directsdk-experimental，显示为Claude Subscription DirectSDK（实验版）。它将未修改的官方Claude Code可执行文件作为请求范围的模型客户端，用于您的Claude Pro/Max订阅。Hermes保持其正常的代理循环、工具、审批和压缩。尽管名称如此，该实现直接使用原生stream-json，不需要Python Agent SDK包。

要求

• Hermes Agent 0.21.4或更高版本，或main在118984d7a02f（hermes-agent PR #117451，#105863的核心部分）及之后的版本。在旧版Hermes上，插件将无法加载并显示明确的Failed to load user provider plugin警告，而不是部分工作。
• Linux、macOS或Windows上的Python 3.10+。原生在其自己的进程组中运行（POSIX会话/Windows CREATE_NEW_PROCESS_GROUP），取消会终止整个进程树（killpg/taskkill /T），因此npm claude.cmd后面的node子进程永远不会在取消的请求后存活。该套件在CI中所有三个平台上运行。
• 官方Claude Code CLI，已安装并登录。 本插件没有自己的凭据；所有操作都通过claude进行。插件在每个环节都检查claude，绝不猜测：当在没有claude时会发生什么：
  • 插件加载：日志中出现一个警告；提供者保持注册状态，以便安装说明可以解释缺少什么。
  • hermes model→此提供者：流程停止并显示安装提示，不会写入任何配置。
  • /model，桌面/TUI选择器：列出锁定的目录（没有实时账户选择器）。
  • 一个请求：立即失败并显示安装提示，而不是Popen回溯错误。

使用npm install -g @anthropic-ai/claude-code安装Claude Code，或者如果二进制文件不在PATH中，则将CLAUDE_SUBSCRIPTION_DIRECTSDK_COMMAND指向该二进制文件。plugin.yaml在external_dependencies下声明了相同的要求。

安装

hermes plugins install claude-subscription-directsdk
# 从Hermes插件目录（已锁定、已审核）安装
# 或直接从GitHub安装（跟踪main分支）：
hermes plugins install NousResearch/hermes-plugin-claude-subscription-directsdk
# 或手动安装：
git clone https://github.com/NousResearch/hermes-plugin-claude-subscription-directsdk \
  ~/.hermes/plugins/claude-subscription-directsdk-experimental
claude auth login
hermes model  # 选择"Claude Subscription DirectSDK（实验版）"

按配置文件的安装将放在~/.hermes/profiles/<name>/plugins/下。该插件声明kind: model-provider，因此Hermes的提供者发现会直接导入它；不需要plugins.enabled条目。

状态

单次请求准入已实现并经过在线验证。 原生2.1.263可能尝试额外的生成，尽管设置了--max-turns 1并禁用了HTTP重试。现在，一个请求范围的环回中继只转发第一个Messages请求，并在本地拒绝后续尝试。Hermes接收到第一个完成的上游响应、其实际用法和原生停止原因；被阻止的原生恢复不会将完成的响应变成异常。截断/不完整的流和上游HTTP错误仍然是失败。集成的基于订阅的审查完成了七次Hermes调用，恰好有七次上游请求、十二次Hermes工具执行和十二个持久化工具结果。上下文从138,498增长到165,697个令牌；后续缓存读取平均为97.13%。原生计费报告了相当于列表价格的$0.8793728，这不是经过验证的订阅费用。早期的尝试从187K开始，但在工具之后超过了当前原生路线的200K限制；那个不完整的尝试不计入成功的审查。一个真实的基于订阅的Hermes任务构建并测试了一个CSV审计器。单独的在线验证测试了流式工具轮次、重启/恢复、主机端拒绝、真实的引导、生成期间的取消以及真实的CLI子代理完成。这是一个审查构建，而不是完全对等或生产就绪声明。请参见下面的剩余限制。

原生Claude Code2.1.263已通过验证。重放确认和额外正文行为是版本敏感的接口，而不是公共任意历史记录SDK保证。通用主机支持（外部进程提供者、重放载体、设置门控）存在于Hermes核心中；本仓库只是提供者。

登录和选择

claude auth login
hermes --provider claude-subscription-directsdk-experimental -m sonnet

身份验证属于官方CLI。插件永远不会打开、复制、刷新或打印其凭据文件。不需要Hermes API密钥，插件也不发送。正常的Hermes客户端路径在生成之前拒绝继承的API密钥、自定义Anthropic端点和云后端覆盖；错误会命名冲突的环境变量而不打印其值。在选择OAuth时，请从启动环境中移除这些覆盖。此客户端中没有静默的HTTP/API密钥回退。

订阅权限和额外使用设置仍属于账户和原生服务。如果不想产生超额费用，请在账户中禁用额外使用。原生的列表价格成本估算不是订阅费用的证明。

对于单独由CLI管理的身份验证目录：

CLAUDE_CONFIG_DIR=/path/to/official-cli-config claude auth login
export CLAUDE_SUBSCRIPTION_DIRECTSDK_CONFIG_DIR=/path/to/official-cli-config

继承的CLAUDE_CONFIG_DIR也有效。要选择不在PATH中的可执行文件，请将CLAUDE_SUBSCRIPTION_DIRECTSDK_COMMAND设置为其绝对路径。没有不受限制的公共CLI标志设置；隔离和拒绝标志由插件拥有。底层Python Client(env=...)注入可用于显式控制的本地固定装置，不适用继承的环境防护。它不是正常的Hermes提供者路径或OAuth认证机制。

持久化配置：

model:
  provider: claude-subscription-directsdk-experimental
  default: sonnet

辅助/回退路由仍由Hermes拥有。如果它们也必须使用订阅，请明确配置这些路线；此提供者不会静默更改其他选定的提供者。

所有权和重放

每个chat.completions.create都在一个私有临时目录中启动一个新进程。原生工具、技能和设置源被禁用。MCP仅通告当前的Hermes工具清单，具有惰性回调，并被原生dontAsk拒绝执行。完整的描述和模式通过工具加上CLAUDE_CODE_EXTRA_BODY中经过验证的生成字段提供，从私有原生设置文件应用；系统提示也使用私有文件。这避免了操作系统每参数/环境字符串的限制。身份验证和身份字段从不替换。规范历史记录按顺序重放。历史用户帧使用shouldQuery:false，每个帧带有一个零轮确认；最终的用户/工具结果帧进行查询。没有停放的原生会话或原生审批等待，适配器不添加合成继续提示。本地准入中继防止原生恢复发出另一个上游请求。原生令牌预算提醒被禁用，因为Hermes拥有预算，并且重放跨缓存边界重构该提醒。其他原生注释仍然存在，因此线路提示不是字节级相同的纯Hermes上下文。中继使用随每个请求随机的路由绑定一个临时环回端口。原生授权头直接通过内存传递给上游；头信息不会被记录或持久化。上游请求体和原生身份头被保留，而HTTP传输编码被规范化。中继在原生恢复可以替换它们之前捕获流式文本、签名思考、工具参数、使用量和停止原因。取消会关闭活动的上游连接和原生进程；请求拆除会移除监听器。不需要外部中继服务或捆绑的供应商可执行文件。

长上下文缓存验证

一个真实的Sonnet 5 Hermes审查任务重现了较差的缓存重用：其第一个请求有187,049个输入令牌；下一个工具轮次仅从缓存中读取了190,840个输入令牌中的6,989个（3.66%），将183,849个令牌重写到一小时缓存中。在179K令牌下的相同请求测试通过了，但没有测试此重放边界。禁用原生提醒后恢复了稳定的前缀，而无需添加缓存标记或更改缓存TTL。一个完成的七次调用审查使用了十个真实的Hermes工具执行，运行了六个离线测试，并写入了其审查工件。上下文从187K增长到212K；后续请求平均有97.99%的缓存读取率，或包括冷启动在内为85.45%。原生列表价格会计总额为$1.1030034，这不是经过验证的订阅费用。这些是Sonnet 5的结果：Fable 5.1在验证账户上需要使用积分，并且未使用付费积分进行测试。

模型权限和配额消耗仍取决于原生账户。

文本流式增量。只有在助手完成、message_stop、最终使用量和原生退出后，才会发布完整的工具批次。然后Hermes应用自己的钩子、审批、工具和持久化。工具名称通过mcp__hermes__映射；原始名称必须是唯一的ASCII字母数字/下划线/连字符标识符，最多50个字符。

--max-turns 1是一个逻辑上的原生步骤；中继提供HTTP准入边界。error_max_turns被接受，并带有完整的工具批次、使用量和退出码1。原生num_turns在该边界处可能为2。完成的第一个响应也能在本地拒绝的恢复尝试或原生拒绝呈现后存活；Hermes接收到实际的拒绝，而不是CLI的合成错误文本。其他失败仍然是失败。

一个版本化的reasoning_details信封保留了有序的原生助手消息和签名思考。未更改的投影保留原生块，包括无害的周围空白规范化。转换的助手文本/工具投影重放规范文本和工具使用块，而不是陈旧的签名思考；外部提供者的推理载体被忽略。编辑过的助手重放通过真实服务验证。

原生自动压缩被禁用，因此Hermes保留压缩所有权；这不为每个历史记录转换或跨模型签名重放建立对等性。

轮中/steer使用Hermes的标准交付方式：一个独立的类型化用户行追加在最新的工具结果之后。此提供者不添加特定于引导的传输。真实的计划变更引导在真实循环中通过；传输保真度不能保证模型服从。

生命周期和请求支持

在事件循环外，create是同步的；在事件循环内，它返回一个卸载的协程。流也支持async for。一个客户端应属于一个可独立取消的Hermes所有者。

cancel()终止拥有的进程树（POSIX进程组/Windows taskkill /T），而不关闭另一个线程的活动描述符。close()防止新的调用并最终化空闲/未启动的流；活动消费者在取消后回卷。早期流退出需要close()/aclose()。

在线中断停止了生成，观察到的原生PID已退出。

支持的翻译包括文本、base64/原生图像和文档、规范工具/结果、输出令牌限制、停止序列、推理启用/禁用和努力程度，以及JSON模式响应格式投影。不支持的原生采样字段被省略，而不是从辅助调用者转发已弃用的temperature。推理努力程度被限制在原生支持的级别，包括Hermes的minimal/ultra输入。原生思考增量作为reasoning_content出现。模型/服务限制仍然适用。未知参数会明确失败。不支持的表面包括助手预填充、严格函数模式、强制工具选择、parallel_tool_calls=False、n>1、仅JSON对象模式、任意头/正文字段、远程图像下载和跨模型签名历史对等。

读空闲超时默认为180秒，在原生输出时重置，并接受Hermes的有限HTTPX读超时形式。大提示仍受原生/操作系统限制。

设置：hermes model→ Claude Subscription DirectSDK（实验版）

选择提供者会在保存任何内容之前询问Claude CLI本身，而不是Anthropic：

1. 已安装？ claude必须在PATH（或CLAUDE_SUBSCRIPTION_DIRECTSDK_COMMAND）上解析。否则一行：使用npm install -g @anthropic-ai/claude-code安装，流程停止而不接触配置。
2. 已登录？ claude auth status（本地凭据存储，约0.3秒）。已登录显示credentials: ✓ (Claude Pro)。在终端上未登录会启动claude auth login内联；它打开浏览器并获取粘贴的代码，然后流程重新检查并继续。没有TTY时，它打印指令并停止。
3. 哪些模型？ CLI的initialize握手返回账户自己的选择器（通过准入中继验证：零上游请求）。每一行都被列出；下面的锁定目录仅为它知道的模型添加元数据。锁定的行映射到Hermes路由ID并去重（opus和opus[1m]是同一个1M路由）。目录尚未锁定的模型保留CLI宣布的ID和标签，并带有一个暗淡的· unpinned注释；只有当CLI本身提供那种形式时，它才会获得[1m]，并且普通的+ [1m]对会像锁定的模型一样合并到[1m]。CLI标记为“Draws from usage credits”的行，加上根据Anthropic计划规则在非Max计划上的Fable，带有暗淡的· usage credits注释（在未锁定的行上为· usage credits · unpinned）；没有隐藏任何内容。如果握手失败，则使用下面的锁定目录。相同的discover_models()为provider_model_ids()提供信息，因此TUI/桌面选择器和/model也列出账户的选择器。

订阅使用量：与claude -p相同的计量，约为交互式TUI的1.7倍

2026年9月9日在Pro计划（Sonnet 5 1M，每臂约500K新输入令牌，输出固定为Hello!，会话仪表在每个臂之前/之后在claude.ai上读取）上测量：

此提供者恰好以与claude -p/ Agent SDK相同的费率消耗订阅使用量；没有Hermes特定的惩罚。交互式Claude Code的计量费率约为该费率的0.58倍，因此请计划在每个5小时窗口内使用约60%的TUI吞吐量（≈ $6.5 对比 ≈ $11的Sonnet 5在Pro上的列表等价费用）。线路级别的使用量桶在各个臂之间是相同的，因此权重是服务器端的，适用于每个-p/SDK工具。在相同的编码任务上，Hermes发送了约0.6倍的原生Claude Code令牌；如果您的消耗看起来更高，请将Hermes/usage与Claude Code/co