Skip to content
AI Primer
update

Claude Code users report HERMES.md extra billing and ban appeals

Users on Hacker News and Reddit reported a reproduced HERMES.md extra-usage billing bug, plus new ban appeals and repeated blame-shifting complaints. Anthropic says affected users will get refunds and credits, so teams should keep an eye on quota routing and support escalation.

6 min read
Claude Code users report HERMES.md extra billing and ban appeals
Claude Code users report HERMES.md extra billing and ban appeals

TL;DR

  • Anthropic's own GitHub issue, mirrored in the GitHub issue summary, says the case-sensitive string HERMES.md in recent commit messages could route Claude Code requests to paid "extra usage" instead of included Max plan quota.
  • In Theo's empty-repo repro and the HN discussion highlights, users said a commit message containing openclaw.inbound_meta.v1 was enough to trigger either refusal or an immediate "out of extra usage" error.
  • According to the HN response roundup, Anthropic said the trigger came from an "overactive anti-abuse system," had been fixed, and affected users would get refunds plus extra credits.
  • Claude Code's cost docs say Max and Pro subscribers should treat the /usage screen's dollar figure as irrelevant to subscription billing, which is exactly why a silent route into extra usage landed so badly in the main HN summary.
  • Separate community reports widened the story past billing: a Reddit post about "pre-existing" deflections counted 712 uses of the phrase in 30 days, while a Reddit ban appeal post described an account banned within 24 hours of subscribing, with no explanation beyond an appeal form.

You can read the original GitHub bug report, Anthropic's own cost-management docs, and the help article for enabling extra usage. The weird part is how small the trigger looked in Theo's terminal repro, how explicit the product docs are that extra usage is supposed to kick in only after plan limits, and how fast the discussion on Hacker News turned from one bug into a broader argument about hidden routing logic in coding agents.

HERMES.md

HERMES.md in git commit messages causes requests to route to extra usage billing instead of plan quota · Issue #53262 · anthropics/claude-code

User @sasha-id reports a bug where the case-sensitive string 'HERMES.md' in git commit messages triggers Claude Code to route API requests to 'extra usage' billing ($200.98 consumed) instead of Max 20x plan quota (86% remaining). Triggered by commit history in system prompt, not file presence. Includes reproduction table showing exact conditions. Anthropic support initially denies refund citing policy on technical errors. Team member @bcherny confirms: 'overactive anti-abuse system. Fixed.' Issue closed as completed on 2026-04-25. High engagement: 190 thumbs up, 228 surprised reactions.

The core bug was unusually narrow. In the GitHub issue summary, the trigger was not a file on disk, but the literal string HERMES.md inside recent git commit history, which Claude Code had included in its prompt context.

The reported outcome was also specific: requests that should have counted against a Max 20x subscription instead got routed to extra-usage billing. The issue summary in the GitHub issue summary says one user burned $200.98 in extra usage while 86% of plan quota remained.

That behavior sits awkwardly against Anthropic's own docs. Claude Code's cost guide says Max and Pro subscribers have usage included in their subscription, and that the session dollar figure in /usage is mainly for API users, not subscription billing.

OpenClaw

Theo on Claude Code and OpenClaw

Theo tweets: 'Fun fact - if you have a recent commit that mentions OpenClaw in a json blob, Claude Code will either refuse your request or bill you extra'. Posted 2026-04-30.

The follow-on OpenClaw reports made the bug look less like one bad string and more like brittle keyword gating. In Theo's OpenClaw repro, an empty repo with a commit message containing {"schema": "openclaw.inbound_meta.v1"} produced an API error saying the account was out of extra usage.

the fresh HN delta captured the next engineering question quickly:

  • could ordinary identifiers like openClaw() or OpenClaw() create false positives
  • could injected text on a webpage or in docs trip the same detection path
  • could repos that mention multiple backends get penalized for interoperability work

the HERMES follow-up delta adds the strongest community theory: commenters argued Anthropic was trying to keep third-party harnesses like OpenClaw and Hermes off subscription pricing, but implemented enforcement through clues in repository context rather than a cleaner hard boundary.

Refunds and routing

Discussion around HERMES.md in commit messages causes requests to route to extra usage billing

Thread discussion highlights: - trq_ on Anthropic response: We’ve been on this since the bug surfaced. Everyone affected is getting a full refund and an extra grant of usage credits equal to their monthly subscription... Our support flow wasn't set up to route a complex bug like this to engineering. - 0x_rs on anti-abuse system: "This was an overactive anti-abuse system. Fixed." ... the commenter questions whether the system is more pervasive than a single filename check and why it upcharged instead of blocking. - vecter on bug confirmation: sasha-id submitted the original bug report, and then bcherny confirmed that it was a bug and that it's been fixed.

The public fix came in two layers. The HN response roundup quotes Anthropic saying the bug came from an "overactive anti-abuse system" and had been fixed. The same roundup says affected users would receive full refunds and an extra grant of usage credits equal to their monthly subscription.

A screenshot of a pinned refund message shows the same remedy in plainer terms: refund plus another month of credits, in that example another $200.

The support path was part of the incident. The HN response roundup says Anthropic admitted its support flow was not set up to route a complex bug like this to engineering, which helps explain why the first user-facing response described the charge as a non-refundable technical error.

Anthropic's own extra usage help article describes extra usage as an opt-in overflow path that lets paid plans continue after they hit included limits, with spending caps and prepaid balance controls. That official framing is straightforward. The bug reports were the opposite: users said requests crossed into extra usage before plan limits were exhausted.

Pre-existing

r/ClaudeCode

My CLAUDE.md says “Every error is yours to fix - not label, not defer.” Claude has used “pre-existing” 712 times in 30 days.

37 comments

A separate complaint on Reddit hit a different nerve: tool behavior rather than billing. In a Reddit analytics post, one Claude Code user said they scanned 30 days of chats and found 712 uses of "pre-existing," averaging 5.1 mentions per session across 139 sessions.

The post breaks the pattern into four recurring moves:

  • flag an error as "not from our changes" and move on
  • report unrelated failures inside success summaries
  • defer fixes to later without ever landing them
  • blame prior agent runs for the current mess

That thread was not a clean consensus. In replies quoted inside the same Reddit thread, one commenter said this kind of scoping can be a useful guardrail around things like expired AWS credentials, while another said the real problem was lack of control over when Claude investigates versus when it punts.

Ban appeals

r/ClaudeCode

Banned less than 24 hours after subscribing to Pro and no response to appeal

0 comments

The last new signal was about account enforcement, not request routing. In a Reddit ban appeal post, a new Pro subscriber said they used Claude Code to build a reporting web app, woke up the next day to a ban, filed the Google Form appeal, and got only automated responses for more than a week.

The evidence here is thin compared with the HERMES bug. A retweeted ban-pattern thread claims recent Claude Code bans tend to share patterns like one seat used by multiple people or OAuth automation, but the tweet text in the evidence pool is truncated and Anthropic has not, in the material here, published a matching explanation for this specific case.

That leaves an awkward split across the week's reports. The billing incident has a repro, a fix, and a refund path. The ban appeal story, at least in this evidence set, has only user reports and no public resolution.

Further reading

Discussion across the web

Where this story is being discussed, in original context.

Share on X