Claude Code의 특정 파일명 버그로 인한 200달러 과금 사건

실용적 조언

Claude Code 사용 중 원인 불명의 과금 에러 발생 시 git log를 확인하여 특이한 파일명이나 대문자 문자열이 있는지 점검할 것
중요한 프로젝트 작업 전에는 Anthropic 대시보드에서 추가 사용량(Extra Usage) 한도를 설정하여 예상치 못한 과금을 방지할 것

섹션별 상세

특정 문자열인 HERMES.md가 포함된 커밋 메시지가 서버 측 콘텐츠 필터를 트리거했다. Claude Code는 맥락 파악을 위해 최근 git 기록을 시스템 프롬프트에 포함하는데, 이 과정에서 대소문자까지 일치하는 특정 파일명이 필터에 걸려 API 요청이 구독 쿼터가 아닌 추가 과금 풀로 강제 라우팅되었다.

사용자는 구독 플랜 쿼터의 86%가 남아있었음에도 불구하고 200.98달러의 추가 사용료를 지불해야 했다. 시스템은 추가 사용량이 모두 소진될 때까지 아무런 경고를 보내지 않았으며, 소진된 이후에야 400 빌링 에러를 뱉으며 작동을 멈추는 방식으로 동작했다.

Anthropic의 초기 대응이 커뮤니티의 큰 반발을 샀다. 기술적 오류나 서비스 저하에 대해 보상할 수 없다는 매뉴얼 답변을 내놓았으나, 해당 이슈가 Hacker News 등에서 공론화된 이후에야 버그 수정과 환불 조치가 이루어졌다.

근본적인 보안 및 설계 결함에 대한 의문이 제기되었다. 개발자의 커밋 메시지 내용에 따라 API 과금 경로가 결정되는 구조 자체가 위험하며, 현재 공개된 문자열 외에 또 어떤 단어들이 이러한 오작동을 유발하는지 투명하게 공개되지 않았다는 점이 지적되었다.

용어 해설

시스템 프롬프트(System Prompt): — AI 모델이 대화를 시작하기 전 지켜야 할 규칙이나 배경 지식을 설정하는 입력값이다. Claude Code는 최근 git 커밋 기록을 시스템 프롬프트에 포함하여 맥락을 파악하는데, 이번 사건에서는 특정 파일명이 포함된 커밋 메시지가 필터링 시스템을 오작동하게 만들었다.
콘텐츠 필터(Content Filter): — 부적절하거나 위험한 텍스트 입력을 차단하기 위해 서버 측에서 작동하는 보안 메커니즘이다. 특정 문자열 패턴을 감지하여 요청을 거부하거나 경로를 변경하는데, 이번 사례에서는 정상적인 파일명이 필터에 걸려 과금 체계가 오작동하는 원인이 되었다.
API 과금(API Billing): — AI 모델 사용량에 따라 비용을 청구하는 체계이다. Claude Code는 구독 플랜 쿼터와 추가 사용량 풀을 구분하여 운영하는데, 시스템 오류로 인해 남은 쿼터 대신 추가 비용이 발생하는 풀로 요청이 잘못 라우팅되는 문제가 발생했다.

언급된 도구

Claude Code중립

터미널 기반 AI 코딩 에이전트

언급된 리소스

GitHubClaude Code GitHub Issue #53262