跳到主要內容
akiraxtwo super

HERMES.md 這個字串讓 Claude Code 繞過訂閱配額,一天燒掉 $200

GitHub issue #53262 揭露:git commit message 裡只要出現大寫字串 "HERMES.md",Claude Code 就會把 API 請求繞過 Max 方案配額,路由到「額外計費」,一個使用者在 Max 20x 計畫($200/月)配額只用了 13% 的情況下,一天內被額外扣了 $200。

/閱讀約 4 分鐘/
HERMES.md 這個字串讓 Claude Code 繞過訂閱配額,一天燒掉 $200
目錄+

這是一個不該存在的 bug,卻有精確的重現步驟。

根據 anthropics/claude-code GitHub issue #53262,當 git repository 的近期 commit 歷史中包含大寫字串 HERMES.md,Claude Code 會把 API 請求路由到「extra usage」計費,而非已付費的 Max 方案配額。

回報此問題的使用者 @sasha-id 是 Claude Max 20x 訂閱者(200/月),當週配額使用率只有13200/月),當週配額使用率只有 13%,但一天內被額外扣了 200 的使用費。Anthropic 確認了這個 bug,但根據 Threads 上的報導,初始回應拒絕退款。

觸發條件精確到讓人不安

issue 裡附上了對照表格,清楚說明觸發條件:

commit message 內容結果
"HERMES.md"觸發 — 路由到額外計費
"test HERMES.md test"觸發
"hermes.md"(小寫)正常
"HERMES"(沒有副檔名)正常
"HERMES.txt"正常
"AGENTS.md"正常
"README.md"正常
磁碟上存在 HERMES.md 檔案、commit message 乾淨正常
同 repo 但 orphan branch(無 commit 歷史)正常

觸發點是 commit message 裡的字串,不是檔案是否存在。Claude Code 會把近期 commit 歷史納入 system prompt,而伺服器端的某個邏輯在看到這個字串後,做出了不同的計費路由決定。

HERMES.md 是真實存在的慣例

這讓這個 bug 特別惡劣:HERMES.md 不是邊緣案例,它是 AI agent 專案中常見的 system prompt 規格檔命名慣例,在 hermes-agent 等開源 agent 框架裡廣泛使用。開發者把 HERMES.md commit 進 repo,是正當的工程行為,不是什麼異常操作。

意思是:任何使用這個慣例的開發者,可能在完全不知情的情況下,每天多付一筆 API 費用。

Max 20x 的配額邏輯

Claude Max 20x 是 $200/月的最高個人訂閱方案,提供 Pro 方案 20 倍的使用量,約每五小時 22 萬 token。在正常情況下,這個配額應該先被使用,超出後才按 API 費率計費。

這個 bug 直接繞過了這個順序:觸發字串存在時,請求被路由到額外計費,即使訂閱配額幾乎沒動。

這個 bug 放大了一個已知的結構問題

Anthropic 在 2026 年 3 到 4 月之間進行了一系列的計費收緊動作——封禁第三方工具的訂閱存取、把 Claude Code 從 Pro 方案中移除(後來說是測試)、更新 API 商業條款——背後的邏輯是:$200/月的 Max 方案被用來跑價值數千美元算力的 agent 任務,Anthropic 在高用量訂閱者身上是虧損的。

這個背景讓 HERMES.md bug 更難被單純歸類為工程疏失。使用者很難區分:「這是真的 bug」還是「這是不透明的計費策略的一部分」。

Fortune 的報導指出,這種不透明性正在侵蝕 Anthropic 最核心的品牌承諾——比其他 AI 公司更誠實、更站在用戶那邊。

如果你用 Claude Code

短期內,可以用 git log --oneline | grep -i "HERMES.md" 檢查你的 repo 是否有觸發字串。如果有,可以在受影響的分支上用 git rebase -i 改寫 commit message(注意這會修改歷史)。

更根本的問題是:計費邏輯不應該依賴 system prompt 的內容。這個修復不應該需要使用者介入。