Claude Code, 특정 문자열 포함 시 과금 주의
PSA: The string "HERMES.md" in your git commit history silently routes Claude Code billing to extra usage — cost me $200
·2026.04.25 23:25
git 커밋 메시지에 'HERMES.md'가 포함될 경우 Claude Code가 구독 플랜 대신 API 요율로 과금하는 버그가 발견되었습니다.
Anthropic의 개발자 도구인 Claude Code에서 특정 문자열이 포함된 git 커밋 히스토리가 있을 경우, 기존 구독 플랜이 아닌 **API 요율 기반의 추가 요금(extra usage)**이 청구되는 버그가 보고되었습니다.
상세 내용:
- 발생 원인: git 커밋 메시지에 대문자 **"HERMES.md"**라는 문자열이 포함되어 있을 때 발생합니다.
- 작동 방식: Claude Code가 시스템 프롬프트에 최근 커밋 내역을 포함하는 과정에서 해당 문자열을 인식하면, 사용자의 Max 플랜 사용량을 무시하고 API 기반의 추가 사용량으로 라우팅합니다.
- 영향: 사용자는 구독 플랜의 잔여 용량이 충분함에도 불구하고, 갑작스럽게 추가 요금 결제 요청을 받게 됩니다.
해당 이슈는 사용자에 의해 재현되었으며, Anthropic 측은 이를 버그로 확인했습니다. Claude Code를 사용하는 개발자는 커밋 메시지에 해당 문자열이 포함되지 않도록 주의가 필요합니다.
이 요약은 원문 이해를 돕기 위한 큐레이션입니다. 저작권은 원저작자에게 있으며, 정확한 내용과 맥락은 원문을 확인하세요.
요약 오류, 출처 표기 문제, 삭제 요청은 문의 · 건의로 알려주세요.