주의: 깃 커밋 내역에 'HERMES.md'가 있으면 Claude Code가 몰래 추가 요금을 청구함 — 200달러 날림
핵심 요약
깃 커밋 내역에 'HERMES.md'가 포함되면 Claude Code가 구독 플랜을 무시하고 추가 요금을 청구하는 버그가 발생함.
- 빌링 버그 — 특정 문자열 포함 시 구독 플랜 대신 추가 요금이 청구됨.
- Anthropic 대응 — 버그는 인정했으나 환불은 거부하여 사용자 불만 폭주.
- 재현 경로 — 'HERMES.md' 대문자 파일명이 포함된 커밋이 원인으로 밝혀짐.
- 사용자 주의 — Claude Code 사용 시 커밋 내역에 해당 문자열이 있는지 확인 필요.
세 줄 요약: 깃 커밋에 "HERMES.md"(대문자)가 언급되면 Claude Code가 구독 플랜 사용을 멈추고 API 요금으로 청구함. Anthropic 고객센터는 버그임을 인정하고 고맙다고 했지만 환불은 거부함. AI 안전 원칙이 지갑까지는 안 닿나 봄.
상황 설명
나는 Max 20x($200/월) 플랜을 사용 중임. 오늘 Claude Code가 갑자기 이런 메시지를 띄움.
"추가 사용량을 모두 소진했습니다. claude.ai/settings/usage에서 추가 구매 후 계속하세요."
이상함. 대시보드에는 주간 사용량 13%, 현재 세션 0%라고 뜸. 86% 이상의 용량이 그대로 남아있는데 말이지.
추가 요금으로 200.98달러가 나감. 구독으로 커버되어야 할 부분인데 한 달 치 한도를 다 써버린 거임.
몇 시간 동안 디버깅함. 로그아웃/로그인, 다른 모델 사용, 재설치 다 해봤는데 안 됨. 고객센터는 claude logout && claude login을 해보라는데 해결 안 됨. AI 챗봇이랑 네 번이나 똑같은 스크립트 대화 주고받음. 결국 고객센터는 포기하고 Anthropic 직원들이 귀찮아서 안 하는 일을 직접 하기로 함. 바로 문제 진단.
레포랑 커밋 내역을 이진 탐색으로 다 뒤짐. 레포 복제하고, 브랜치 테스트하고, 커밋 하나하나 격리해서 특정 문자열을 찾아냄. 토요일 몇 시간을 다 날림. 결국 범인을 찾음:
최근 깃 커밋 메시지에 포함된 "HERMES.md" (대문자, .md 확장자 포함).
이게 다임. Claude Code는 최근 커밋을 시스템 프롬프트에 포함하는데, 서버 측에서 "HERMES.md"를 보고 구독 플랜 대신 추가 요금으로 라우팅하는 거임.
재현 경로:
# 이건 "추가 사용량 소진" 오류가 발생함 (추가 요금으로 라우팅됨)
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..."
# 이건 정상 작동함 (플랜 할당량으로 라우팅됨)
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!"
"AGENTS.md"? 괜찮음. "README.md"? 괜찮음. .md 없는 "HERMES"? 괜찮음. 소문자 "hermes.md"? 괜찮음. 오직 대문자 "HERMES.md"만 트리거됨. 말이 되냐 이게.
버그 리포트: https://github.com/anthropics/claude-code/issues/53262
Anthropic 고객센터의 대응
여기서부터가 가관임. AI 고객센터 봇이 버그를 세 번이나 인정하면서 "인증 라우팅 문제"라고 함. 그러더니:
"서비스 오류로 인한 불편을 드려 진심으로 사과드립니다. 저희는 서비스 안정성을 매우 중요하게 생각합니다. 하지만 기술적 오류로 인한 잘못된 요금 청구에 대해서는 보상해 드릴 수 없음을 알려드립니다."

