Anthropic Claude Code HERMES.md billing flaw
Anthropic Claude Code HERMES.md billing flaw was a technical defect in Anthropic's Claude Code product that bypassed flat-rate subscription plans to charge users direct API fees. In April 2026, a flaw triggered by the exact string "HERMES.md" in a user's Git commit history routed subscribers directly to pay-as-you-go billing, charging one account over $200.[1]
Background
[edit | edit source]The flaw emerged in the context of a wider crackdown by Anthropic on third-party agent harnesses. On 4 April 2026, Anthropic began blocking Claude Pro and Max subscribers from routing their flat-rate plan usage through third-party agentic tools, requiring those tools to be billed under a separate pay-as-you-go "extra usage" tier instead.[2] Boris Cherny, Anthropic's Head of Claude Code, stated on X that Claude's "subscriptions weren't built for the usage patterns of these third-party tools" and that the policy "applies to all third-party harnesses and will be rolled out to more shortly."[2][3]
Hermes Agent, an open-source self-improving AI agent built by Nous Research,[4] is among the third-party harnesses affected by the rollout. Hermes can route requests to Anthropic models either through pay-per-token API keys or by reading Claude Code's credential store on the same machine, the latter of which became the target of Anthropic's enforcement actions.[5]
HERMES.md billing switch
[edit | edit source]On 25 April 2026, a user reported that the exact string "HERMES.md" in their local Git commit history caused Claude Code to route queries outside of their fixed-rate subscription plan.[1] The system bypassed the $200 per month Max plan and charged the user direct, pay-as-you-go API rates.[1] The user lost over $200 in extra charges while 86 percent of their prepaid plan capacity remained available.[1]
The routing was triggered even when the string appeared only in incidental Git history rather than as evidence of an active Hermes session. Anthropic's head of Claude Code later attributed the behaviour to an "overactive anti-abuse system" and said it had been fixed.[1]
Anthropic's response
[edit | edit source]When the affected user contacted Anthropic support, the company refused to issue a refund for the $200 lost to the glitch, categorizing the overcharge as a non-refundable technical error.[6]
Boris Cherny, Anthropic's head of Claude Code, responded in the issue thread on 25 April 2026: "Thanks for the report! This was an overactive anti-abuse system. Fixed."[1]
After the Reddit post was shared on X, an employee of Anthropic said anybody affected would be refunded with an additional $200 of credits on top.[7]
Consumer response
[edit | edit source]The refund refusal drew criticism in the GitHub issue thread, where commenters said refunding the $200 overcharge would have been "the easiest PR win in the world" and that the refusal, after the company's own staff had acknowledged and fixed the flaw, made them reconsider their choice of Claude; the affected user renewed the refund request after the fix was confirmed.[1] A post on the r/ClaudeAI subreddit warned other users that the string in their Git commit history could silently reroute requests to extra-usage billing.[6]
References
[edit | edit source]- ↑ 1.0 1.1 1.2 1.3 1.4 1.5 1.6 sasha-id (2026-04-25). "HERMES.md in git commit messages causes requests to route to extra usage billing instead of plan quota #53262". GitHub. Archived from the original on 2026-04-29. Retrieved 2026-04-28.
- ↑ 2.0 2.1 Ha, Anthony (2026-04-04). "Anthropic says Claude Code subscribers will need to pay extra for OpenClaw usage". TechCrunch. Archived from the original on 2026-04-04. Retrieved 2026-04-28.
- ↑ Franzen, Carl (2026-04-03). "Anthropic cuts off the ability to use Claude subscriptions with OpenClaw and third-party AI agents". Venture Beat. Archived from the original on 2026-04-29. Retrieved 2026-04-28.
- ↑ "Hermes AI Agent by Nous Research | Official Site". Nous Research. Archived from the original on 2026-03-31. Retrieved 2026-11-01.
- ↑ "AI Providers — Hermes Agent". Nous Research. Archived from the original on 2026-04-27. Retrieved 2026-04-28.
- ↑ 6.0 6.1 alexxxklepa (2026-04-26). "PSA: The string 'HERMES.md' in your git commit history silently..." Reddit. Archived from the original on 2026-04-29. Retrieved 2026-04-28.
- ↑ Thariq (2026-04-26). "Thariq on X". X. Archived from the original on 2026-04-29. Retrieved 2026-04-28.