Claude Code의 API 비용을 10-20배 폭증시키는 두 가지 캐시 버그 분석 및 해결책

커뮤니티 반응

작성자의 정밀한 리버스 엔지니어링 결과에 대해 커뮤니티는 높은 신뢰를 보이고 있으며, 실제 비용 폭증을 경험한 사용자들의 증언이 이어지고 있다.

실용적 조언

스탠드얼론 바이너리 대신 npx를 통해 Claude Code를 실행하여 네이티브 레이어의 문자열 교체 버그를 방지할 것
대화 기록이나 설정 파일에서 cch=00000 문자열이 포함되지 않도록 주의할 것

섹션별 상세

Bug 1: 스탠드얼론 바이너리 내 Anthropic 커스텀 Bun 포크의 문자열 교체 로직이 캐시를 파괴한다. HTTP 헤더 빌더가 JSON 바디에서 cch=00000 센티널을 찾아 해시값으로 교체하는데, 대화 내용에 이 문자열이 포함되면 시스템 프롬프트 대신 메시지 본문이 수정되어 캐시 접두사가 깨진다. 이 현상은 JavaScript 레이어에서는 보이지 않는 네이티브 레이어에서 발생하며, 요청당 약 $0.04~$0.15의 추가 비용을 발생시킨다. npx를 통해 실행하면 해당 교체 메커니즘이 없는 표준 런타임을 사용하므로 문제를 피할 수 있다.

Bug 2: v2.1.69 버전부터 도입된 deferred_tools_delta 속성이 세션 재개 시 캐시 미스를 유발한다. 신규 세션에서는 도구 관련 정보가 첫 번째 메시지에 포함되지만, --resume 시에는 메시지 끝에 추가되고 첫 메시지 구성이 달라져 전체 컨텍스트의 캐시 접두사가 불일치하게 된다. 이로 인해 세션 재개 시마다 전체 대화 기록에 대해 cache_creation 비용이 청구되어 평소보다 10~20배 비싼 요금이 발생한다. 현재로서는 v2.1.68로 버전을 고정하는 것 외에 뚜렷한 외부 우회 방법이 없는 상태이다.

비용 영향 분석: 50만 토큰 규모의 대화에서 버그가 발생할 경우 비용 차이가 극명하게 나타난다. Bug 1이 발생하면 모든 요청에서 cache_read($0.03/MTok) 대신 cache_creation($0.30/MTok)이 적용되어 요청당 약 $0.04가 추가된다. Bug 2는 세션 재개 시 1회성으로 약 $0.15의 비용을 발생시키며, 두 버그가 겹칠 경우 요청당 $0.20 이상의 손실이 발생할 수 있다. 작성자는 MITM 프록시와 Ghidra를 이용한 바이너리 분석을 통해 이러한 비용 폭증의 기술적 근거를 입증했다.

언급된 도구

Claude Code중립

AI 코딩 에이전트 CLI 도구

Ghidra추천

바이너리 리버스 엔지니어링 및 분석

mitmproxy추천

API 요청 및 응답 페이로드 캡처

Bun중립

Claude Code가 사용하는 JavaScript 런타임

언급된 리소스

GitHubBug 1: Sentinel replacement issue #40524

GitHubBug 2: --resume cache miss issue #34629