DeepAI Paper Hermes Agent 教程,Hermes 模型与 Provider API Hermes 热门 Issue #6475：Claude 订阅登录为什么还会提示 out of extra usage？

Hermes 热门 Issue #6475：Claude 订阅登录为什么还会提示 out of extra usage？

2026年5月14日2026年5月14日| DeepAI Paper 编辑部DeepAI Paper 编辑部| 0 Comment| 下午3:16
Categories:

Hermes Agent 用户里，有一个非常容易误判的问题：

明明 Claude Desktop 还能用，Hermes 也已经重新登录过 Anthropic / Claude 订阅认证，但一发消息还是报：

HTTP 400: You're out of extra usage. Add more at claude.ai/settings/usage and keep going.

很多人第一反应是：

  • Hermes 配置坏了；
  • Claude OAuth 登录过期了；
  • 模型名写错了；
  • 重启 Hermes 应该能恢复；
  • 重新登录 Claude 应该能恢复。

但 Hermes GitHub 上的热门 issue #6475 表明，这类错误并不一定是本地配置问题。

Issue 地址：

https://github.com/NousResearch/hermes-agent/issues/6475

这个 issue 有 30 条评论、17 个 👍，已经关闭。它的价值在于：把“Claude Desktop 还能用”和“Hermes 第三方 harness 报 extra usage 400”这两个现象区分开了。

Issue #6475 的原始现象

用户描述的环境是：

Hermes version: 0.8.0 (2026.4.8)
Provider: anthropic
Endpoint: https://api.anthropic.com
Platform: macOS

测试过的模型包括：

anthropic/claude-opus-4-6
claude-sonnet-4-6

问题不是一开始就坏。

原帖强调：

  • Hermes 安装和配置成功；
  • Anthropic / Claude subscription auth 一开始能正常用；
  • 正常使用一段时间后，开始持续返回 extra usage 400；
  • 重启 Hermes 无效；
  • 重新 Claude auth 登录无效；
  • 在 Hermes 内切换模型也无效；
  • Claude Desktop 在同一账号上仍然能用。

报错长这样：

⚠️ API call failed (attempt 1/3): BadRequestError [HTTP 400]
🔌 Provider: anthropic Model: claude-sonnet-4-6
🌐 Endpoint: https://api.anthropic.com
📝 Error: HTTP 400: You're out of extra usage. Add more at claude.ai/settings/usage and keep going.
📋 Details: {'type': 'error', 'error': {'type': 'invalid_request_error', 'message': "You're out of extra usage. Add more at claude.ai/settings/usage and keep going."}, 'request_id': ''}
⚠️ Non-retryable error (HTTP 400) — trying fallback...
❌ Non-retryable error (HTTP 400): HTTP 400: You're out of extra usage. Add more at claude.ai/settings/usage and keep going.
❌ Non-retryable client error (HTTP 400). Aborting.
🔌 Provider: anthropic Model: claude-sonnet-4-6
🌐 Endpoint: https://api.anthropic.com
💡 This type of error won't be fixed by retrying.

这里最关键的一句话其实是最后一行：

This type of error won't be fixed by retrying.

也就是说，它不是普通网络抖动，也不是 502 那种可以靠重试解决的问题。

为什么这个 issue 热门？

因为它击中了很多 Hermes 用户的共同误区：

Claude Desktop 能用 ≠ 第三方 agent harness 一定还能用同一套订阅额度

评论里有用户表示自己也遇到同样问题；还有人说家里两个 Hermes 用户都遇到了。

Issue 中还有人提到，Anthropic 对第三方 harness 使用 Claude OAuth / subscription auth 的计费或 usage gate 发生变化：第三方 harness connected to your Claude account 可能会消耗 extra usage，而不是普通 Claude Desktop 的订阅路径。

这解释了一个看起来很反直觉的现象：

Claude Desktop 正常
Hermes 报 out of extra usage
重启无效
重新登录无效
切换 Sonnet / Opus 无效

因为问题不在 Hermes 本地状态，而在 provider 侧的 usage gate。

最终结论：这个 issue 是怎么解决的？

Issue #6475 已经关闭。

维护者 teknium1 在关闭时给出的关键回复是：

You must use extra usage credits. They are 30% off the API price.

换句话说，结论不是“重装 Hermes”，也不是“清空 token”，而是：

> 如果你继续通过 Hermes 这类第三方 harness 使用 Anthropic / Claude subscription auth，并且命中了 extra usage gate，就需要使用 extra usage credits，或改用其他 provider / key / model 路径。

这也是这篇文章的重点：

这个 issue 的解决不是代码层面绕过去，而是把错误归因从 Hermes 配置错误纠正为 Anthropic usage / billing gate。

不要把它误判成 API Key 错误

HTTP 400 很容易被误判。

很多 OpenAI-compatible 或 Anthropic-compatible 接入问题里，401 / 403 / 404 / 429 / 5xx 都有明确方向：

状态常见含义
401API Key / token 错误
403权限、WAF、地区、headers、provider policy
404endpoint 或 model path 错误
429频率或额度限制
5xxprovider / gateway / upstream 临时故障
400请求格式、模型能力、provider 业务规则或 usage gate

#6475 里的 400 不是“JSON 格式错”，也不是“模型不存在”。错误信息已经写得很直白：

You're out of extra usage.

所以排查时不要先去改：

~/.hermes/config.yaml
~/.hermes/.env
provider name
model name

这些当然可以检查，但如果错误文本明确是 out of extra usage，核心方向应该先转到 Anthropic 账号 usage / billing 状态。

为什么重启 Hermes 和重新登录没用？

因为重启只能刷新本地进程状态。

重新登录只能刷新认证状态。

但如果 provider 返回的是 usage gate，说明请求已经通过某种认证路径到达了 provider，并且 provider 明确拒绝继续使用当前额度。

这和“登录失败”不同。

可以这样理解：

登录失败：你是谁，我不认
usage gate：我知道你是谁，但这条使用路径没有可用额度

所以：

hermes restart
重新 OAuth 登录
切换同一 provider 下的模型

都不一定有用。

Claude Desktop 能用，为什么 Hermes 不能用？

这是 #6475 最容易让人困惑的地方。

原因是不同客户端、不同 API 路径、不同 usage bucket 可能不一样。

Claude Desktop 是官方客户端。

Hermes 是第三方 agent harness。

两者即使绑定同一个 Claude 账号，也不代表它们消耗同一个额度池，或者被同一套策略处理。

Issue 评论中提到的方向是：第三方 harness connected to your Claude account 可能会从 extra usage 里扣，而不是普通订阅额度。

所以当你看到：

Claude Desktop works
Hermes fails with out of extra usage

这不是矛盾，而是不同 usage path 的表现。

有人提到 prompt obfuscation，为什么不建议这么做？

#6475 的评论里，有用户尝试通过修改 Hermes prompt_builder，把 session_search、skill_manage、MEDIA:/ 等关键词做混淆，来规避某些过滤或检测。

这类思路不适合作为正式解决方案。

原因很简单：

1. 它依赖对 provider 策略的猜测； 2. 它可能违反 provider 的使用条款； 3. 它不稳定，provider 更新后随时失效； 4. 它会污染 Hermes 的可维护性； 5. 真正的错误文本是 usage gate，不应该用绕过策略解决。

对于生产环境、团队部署或 SEO 教程文章，应该给用户的是稳妥路径：

确认 usage 状态
购买/启用 extra usage credits
切换正式 API Key 计费路径
切换其他 provider
使用 OpenAI-compatible 中转站

而不是教用户绕过 provider 的过滤或限制。

如果你正在用 Hermes，应该怎么排查？

第一步：确认错误文本

如果日志里是：

HTTP 400: You're out of extra usage

就不要按普通 400 处理。

这是 provider 明确返回的 usage 信息。

第二步：确认是不是 Anthropic subscription / OAuth 路径

看 Hermes 当前 provider：

Provider: anthropic
Endpoint: https://api.anthropic.com

如果是 Claude subscription auth / OAuth 路径，就优先检查 Claude 账号的 extra usage 状态。

第三步：不要只看 Claude Desktop

Claude Desktop 能用，只能说明官方客户端路径还有可用能力。

它不能证明 Hermes 第三方 harness 路径也有可用额度。

第四步：切换 provider 做 A/B 测试

如果你配置了其他 provider，可以切换到：

OpenAI-compatible endpoint
DeepAI API 中转站
本地模型
其他官方 API Key provider

如果其他 provider 正常，而 Anthropic subscription path 持续报 out of extra usage，就说明 Hermes 主流程没坏。

第五步：决定使用哪条长期路径

常见选择有三类：

1. 继续 Anthropic 路径，并使用 extra usage credits； 2. 改用正式 API Key / billing 路径； 3. 使用 OpenAI-compatible API 中转站统一模型入口。

DeepAI API 中转站在这个问题里的价值

这里要讲清楚：DeepAI 不能“修复”Anthropic subscription 的 extra usage gate。

如果 provider 明确要求 third-party harness 使用 extra usage credits，那么这是 provider 侧策略，不是 DeepAI 或 Hermes 能替你绕开的东西。

但 DeepAI API 中转站的价值在于：它可以作为 Hermes 的另一条 OpenAI-compatible 上游模型路径。

当你不想把 Hermes 绑定在单一 provider 的 OAuth / subscription path 上，可以把 Hermes 配成 OpenAI-compatible custom endpoint：

Base URL: https://api.deepai.wang/v1
API Key: DeepAI 控制台获取
Model: 以 DeepAI 控制台显示为准

这样做的好处是：

  • Hermes 按 OpenAI-compatible 方式调用；
  • 模型和额度在 DeepAI 控制台里管理；
  • 避免把 Claude Desktop 的订阅状态和 Hermes 的第三方调用状态混在一起；
  • 更适合多 provider 统一管理和团队部署。

注意，Base URL 应写到：

https://api.deepai.wang/v1

不要写成完整的 /v1/chat/completions。

推荐的 Hermes 配置思路

如果你是个人用户，可以保留多个 profile：

profile/anthropic：需要 extra usage credits，适合必须用 Anthropic 的场景
profile/deepai：OpenAI-compatible 中转站，适合日常 Hermes agent 任务
profile/local：Ollama / LM Studio，本地低成本任务

如果你是团队部署，建议不要把“官方客户端订阅”当成长期稳定的 agent backend。

Agent 的特点是：

  • 自动化频率更高；
  • 长任务更多；
  • token 消耗更难预测；
  • 后台 auxiliary 任务也会消耗模型调用；
  • 多平台 gateway 会放大调用量。

所以团队场景更适合用明确的 API Key / billing / quota 路径，而不是依赖容易混淆的 subscription OAuth 路径。

这个 issue 给 Hermes 用户的启发

Issue #6475 不是一个普通 bug。

它提醒用户：

Agent harness 的模型调用路径，和官方聊天客户端不是同一回事。

Hermes 能做的是：

  • 更清楚地显示 provider、model、endpoint；
  • 把 non-retryable 400 和 usage gate 解释清楚；
  • 提供切换 provider / model 的路径；
  • 避免让用户以为重启和重登一定能解决。

用户要做的是：

  • 看清错误文本；
  • 判断是 auth、quota、billing、endpoint 还是模型能力；
  • 不要用绕过 provider 策略的方式处理 usage gate；
  • 为长期 agent 使用选择稳定的 API 计费路径。

相关文章

Hermes Issue #6475：

https://github.com/NousResearch/hermes-agent/issues/6475

DeepAI API 中转站：

https://api.deepai.wang/

Hermes 接入 DeepAI Custom Endpoint 教程：

Hermes Agent 接入 DeepAI 教程：用 Custom Endpoint 配 OpenAI Compatible API

Hermes Provider 兼容性排错：

Hermes Provider 兼容性排错：reasoning_content、custom headers、上下文长度和 api_mode 继承

Hermes Auxiliary 任务排错：

Hermes Auxiliary 任务排错：主聊天正常，为什么标题生成、压缩和后台 review 会失败？

总结

Hermes Issue #6475 之所以热门，是因为它揭示了一个很多用户都会踩的坑：

Claude Desktop 能用，不代表 Hermes 通过 Claude subscription / OAuth 路径也有可用额度。

当 Hermes 返回：

HTTP 400: You're out of extra usage

这通常不是重启、重登、切换同 provider 模型能解决的问题。

这个 issue 的关闭结论也很明确：需要使用 extra usage credits，或者切换到更适合 agent harness 的 provider / API Key / OpenAI-compatible 中转路径。

如果你在 Hermes 里希望有更稳定、可控的模型入口，可以把 DeepAI API 中转站配置为 OpenAI-compatible custom endpoint：

https://api.deepai.wang/v1

然后在 DeepAI 控制台里选择模型、管理 Key 和额度。这样至少不会把 Claude Desktop 的官方客户端体验和 Hermes 的第三方 agent 调用路径混为一谈。

Related Post

Discord /btw 带图却像没看见：Hermes background agent 为什么拿不到图片附件Discord /btw 带图却像没看见：Hermes background agent 为什么拿不到图片附件

2026年5月15日2026年5月15日| DeepAI Paper 编辑部DeepAI Paper 编辑部| 0 Comment| 上午2:52

Hermes Discord 里 /btw 或 /background 带图片时，adapter 已经缓存附件，后台 Agent 却只收到文字 prompt？本文复盘 #25614：background command 路径没有转发 event.media_urls / media_types，导致图片上下文在进入 Agent 前丢失。

Read MoreRead More

Feishu 配好了，Hermes Gateway 却一启动就崩：RedactingFormatter 没导入造成的假象Feishu 配好了，Hermes Gateway 却一启动就崩：RedactingFormatter 没导入造成的假象

2026年5月15日2026年5月15日| DeepAI Paper 编辑部DeepAI Paper 编辑部| 0 Comment| 上午2:30

Feishu/Lark 配置看起来没问题，但 Hermes Gateway 启动后反复崩溃？本文复盘 #8173：gateway/run.py 使用 RedactingFormatter 却没有导入，导致启动阶段 NameError，消息根本还没进入平台 adapter。

Read MoreRead More

Hermes 多模态排错：image_url 发给非视觉模型为什么会 400？Hermes 多模态排错：image_url 发给非视觉模型为什么会 400？

2026年5月14日2026年5月14日| DeepAI Paper 编辑部DeepAI Paper 编辑部| 0 Comment| 下午3:08

Hermes 接入 OpenAI-compatible API 时，图片消息会变成 image_url content part。如果当前模型不是 vision model，就可能返回 HTTP 400。本文基于 Hermes PR #23750 讲清 non-vision model、多模态和 DeepAI 接入排错。

Read MoreRead More