이 5단어 때문에 Claude Code 사용량이 12%나 낭비됩니다

Highlights

• Claude Code는 30초마다 백그라운드 에이전트의 전체 대화 내용을 전송해 3~5단어의 상태 요약을 요청하므로 전체 사용량의 5~20%가 낭비된다.

• 에이전트 요약 기능은 Claude Code의 JSONL 성적표에 기록되지 않아 CC usage 같은 도구로는 비용을 감지할 수 없다.

• claude code fork subagents 설정을 0으로 지정하면 하위 에이전트 분기가 비활성화되면서 요약 기능도 함께 사라진다.

• bun 미리 로드 스크립트를 통해 setTimeout을 가로채 요약 타이머를 차단하는 임시 방편이 존재하지만 보안상 주의가 필요하다.

Timeline

1. 00:00 - 01:31

   Claude Code 백그라운드 요약의 토큰 낭비 문제

   Claude Code는 백그라운드에서 실행되는 에이전트들의 상태를 파악하기 위해 30초마다 모델에 전체 대화 내용을 전송하고 3~5단어의 레이블을 생성한다. OpenTelemetry와 BetterStack을 활용한 테스트에서 sleep 명령을 반복 실행했을 때 매번 대화 맥락이 불어나며 막대한 입력 토큰을 소모하는 현상이 확인되었다.

   • Claude Code 하단의 상태 바는 백그라운드 에이전트의 작업 내용을 3~5단어로 설명하는 요약 기능 때문에 유지된다.
   • 해당 요약 요청은 정확히 30초마다 발생하며 호출할 때마다 전체 대화 내용이 전송되어 큰 입력 토큰을 소모한다.
   • 오픈텔레메트리 데이터 분석 결과 에이전트 요약은 전체 세션 비용의 12%를 차지하는 것으로 나타났다.
2. 01:31 - 03:39

   비용 편차와 누락되는 사용량 측정

   실제 개발 환경을 모사한 테스트에서도 요약 기능은 적지 않은 사용량을 소모했다. 이 비용은 Claude Code의 기록 파일에 남지 않아 일반적인 모니터링 도구에서는 누락되며, 앤스로픽 내부 직원이나 커뮤니티 측정 결과에 따라 전체 터미널 사용량의 2%에서 10% 이상을 기록하는 편차를 보인다.

   • Opus 모델을 사용하여 실무적인 사이트를 구축했을 때도 에이전트 요약이 전체 사용량의 약 8%를 차지했다.
   • 요약 데이터는 JSONL 성적표에 기록되지 않기 때문에 일반적인 사용량 계산 도구로는 비용을 파악하기 어렵다.
   • 실제 시간 기준으로 작동하는 특성상 오래 실행되는 에이전트가 많을수록 비용이 빠르게 불어난다.
3. 03:39 - 05:15

   요약 기능 비활성화 및 우회 해결책

   사용자는 설정 변경이나 스크립트를 통해 원치 않는 요약 요청을 차단할 수 있다. 하위 에이전트 분기 설정을 0으로 바꾸면 전체 대화 상속 기능은 사라지지만 백그라운드 에이전트 자체는 새로운 프롬프트 캐시로 계속 동작한다. 또한 타이머를 직접 차단하는 꼼수도 존재하지만 최신 보안 취약점 시기에는 코드를 직접 확인하고 고정하는 과정이 필수적이다.

   • claude code fork subagents 설정을 0으로 설정하면 하위 에이전트 분기가 차단되면서 요약 기능도 함께 사라진다.
   • bun 미리 로드 스크립트로 setTimeout을 가로채는 방법이 있으나 외부 스크립트 실행에 따른 보안 주의가 필요하다.
   • 앤스로픽이 향후 저렴한 버전에서 이 문제를 해결하기 전까지 사용자는 절충안을 선택해야 한다.