Claude Code 상태 표시줄이 토큰의 15~20% 낭비하는 이유와 해제법

핵심 요약

• Claude Code는 30초마다 백그라운드 에이전트의 전체 트랜스크립트를 모델(보통 Opus)로 보내 '최근 동작을 3~5단어로 설명'하도록 요청하며, 답은 에이전트 패널의 상태 줄만 업데이트한다.
• 이 agent_summary 기능은 Claude Code 전체 토큰 사용량의 15~20%(일부 측정에선 18~26%)를 차지하지만, 사용자는 끌 방법이 없다.
• 2.1.232버전(2026년 8월)부터 기본 활성화되었으며, OpenTelemetry export 분석으로 주 대화보다 많은 비용을 소비함이 드러났다.
• Flamerix AI는 Bun preload 스크립트(no-agent-summary.js)를 공개했으며, setTimeout/setInterval을 감싸서 summarizer 콜백을 비활성화한다.
• 이 스크립트는 모델 API 호출을 완전히 차단하면서 다른 타이머는 통과시키고, 바이너리 수정이 필요 없다.
• 설치 시 ~/.local/share/에 스크립트를 놓고 BUN_OPTIONS 환경 변수에 --preload 플래그를 추가하면 모든 Claude Code 프로세스에 적용된다.
• agent_summary 요청의 98%는 prompt cache에서 읽으며, OpenTelemetry export로만 추적 가능하고 디스크의 세션 로그에는 기록되지 않는다.
• 2.1.310부터는 전체 트랜스크립트 대신 2k 토큰 분량의 노트를 쓰는 'short mode'가 추가되었으나 기본값은 여전히 전체 트랜스크립트다.
• 더 저렴한 모드나 비활성화 옵션은 존재하지만 서버 플래그나 문서화되지 않은 환경 변수로만 제어 가능하다.
• 업데이트 후에는 Verify 섹션의 지침을 따라 스크립트가 제대로 작동하는지 확인해야 하며, 향후 업데이트가 후킹을 깨뜨릴 수 있다.