HERMES.md 문자열이 git 커밋 기록에 포함되면 Claude Code 요금이 추가로 발생함

• 나는 Max 20x 구독자이고 월 $200을 내고 있었는데, 어느 날 Claude Code가 "You're out of extra usage. Add more at claude.ai/settings/usage and keep going." 오류를 띄웠음.

  • 이상했던 점은 대시보드상 주간 사용량이 13%, 현재 세션 사용량이 0%였고, 남은 용량도 86%+로 보였다는 점임.

• 구독으로 처리돼야 할 사용량이 extra usage로 빠지면서 월 추가 한도 $200.98를 통째로 소진했음.

• 원인 찾으려고 몇 시간을 날렸음.

  • logout/login, 다른 모델, 새 설치까지 다 해봤지만 해결 안 됐음.

  • 지원팀이 안내한 claude logout && claude login도 효과 없었음.

  • AI 지원 봇과 네 번이나 왕복했지만 같은 스크립트 답변만 반복됐음.

• 결국 직접 원인 분석에 들어갔고, repo와 commit history를 대상으로 사실상 binary search를 돌렸음.

  • repo를 새로 clone하고, orphan branch도 테스트하고, 개별 commit을 하나씩 격리해 가며 특정 문자열까지 좁혀 갔음.

• 최종 트리거는 최근 git commit 메시지 안의 대문자 "HERMES.md" 문자열이었음.

  • Claude Code가 최근 commit들을 system prompt에 포함하고, 서버 쪽 어딘가가 HERMES.md를 보고 플랜 quota 대신 extra usage billing 경로로 보내는 것으로 보였음.

• 재현 조건은 아주 좁고 이상했음.

  • AGENTS.md는 문제 없음.

  • README.md도 문제 없음.

  • .md 없는 HERMES도 문제 없음.

  • 소문자 hermes.md도 문제 없음.

  • 오직 대문자 HERMES.md만 트리거됨.

• 재현 예시는 아래와 같음.

# This FAILS with "out of extra usage" (routes to extra usage billing)
mkdir /tmp/test-fail && cd /tmp/test-fail
git init && echo test > test.txt && git add. && git commit -m "add HERMES.md"
claude -p "say hello" --model "claude-opus-4-6[1m]"
# => API Error: 400 "You're out of extra usage..."

# This WORKS (routes to plan quota)
mkdir /tmp/test-pass && cd /tmp/test-pass
git init && echo test > test.txt && git add. && git commit -m "add hermes.md"
claude -p "say hello" --model "claude-opus-4-6[1m]"
# => "Hello!"

• 버그 리포트도 올렸음: https://github.com/anthropics/claude-code/issues/53262

Anthropic 지원팀 응답

• Anthropic의 AI 지원 에이전트는 이 문제를 세 번이나 인정했고, 이를 authentication routing issue라고 불렀음.

• 그런데도 잘못된 과금 라우팅으로 발생한 청구에 대해 환불은 불가하다고 답했음.

  • 요지는 서비스 신뢰성은 중요하게 보지만, 기술 오류나 잘못된 billing routing으로 생긴 비용도 보상해 줄 수 없다는 식이었음.

• 체감상 결론은 이랬음.

  • 시스템 버그 때문에 git history 문자열 하나로 $200이 잘못 청구됨.

  • 그 원인 분석은 사용자가 몇 시간 들여 직접 해야 했음.

  • 돌아온 답은 사과와 인내에 대한 감사뿐이었음.

• 작성자는 이 대응을 강하게 비판했음.

  • 월 $200짜리 Max 20x를 쓰는데, billing bug로 추가 $200를 더 잃었음.

  • QA까지 무료로 대신했는데 환불도 못 받았음.

  • 계약 단가로 시간을 청구하고 싶을 정도지만, 환불 봇이 그것도 거절할 것 같다고 비꼼.

• 제품 역량과 환불 정책의 수준 차이가 너무 크다고 봤음.

  • 세계 최고 수준 AI를 만든다면서, refund 정책은 commit 메시지 regex 하나보다도 둔해 보인다고 꼬집었음.

  • 지원 봇도 사용자 이익을 전혀 대변하지 못한다고 느꼈음.

저장소 확인

• Claude Code를 쓰고 최근 commit history 어딘가에 HERMES.md가 있으면, 지금도 모르는 사이 extra usage 비용이 새고 있을 수 있음.

• claude.ai/settings/usage에서 extra usage를 바로 확인해 보는 편이 좋음.

• HERMES.md는 실제 AI agent 프로젝트에서 쓰이는 관례적 이름임.

  • system prompt specification 용도로 쓰이는 파일명이라, 아주 드문 edge case로 치부하기 어렵다는 뜻임.

OpenClaw CLI도 extra usage 로 보낸다는 얘기가 있으니 확인해보세요