[한글자막] Claude Code 에이전트 요약에 비용 12%? 사용량 실험과 끄는 방법

한 줄 핵심

Claude Code의 에이전트 요약은 배경 에이전트를 오래 돌릴수록 비용을 눈에 띄게 늘릴 수 있으며, 끄는 우회법은 있지만 기능 손실과 보안 리스크의 절충이 따른다.

시간별 요약

1. 0:00
   소개 배경 에이전트를 사용하는 Claude Code에서 에이전트 요약이 실제 사용량과 비용에 어떤 영향을 주는지 점검한다.
2. 0:22
   에이전트 요약의 비용 오픈 텔레메트리와 Better Stack으로 요청을 추적한 결과, 반복적인 배경 작업에서 요약 호출이 약 30초 간격으로 발생하며 세션 비용의 12%를 차지했다.
3. 1:19
   실제 작업에서의 측정 더 현실적인 작업인 Opus로 Tan Stack 사이트를 만드는 테스트에서도 요약 비용은 약 8%로 확인됐고, 이 비용은 Claude Code의 JSONL 로그에는 남지 않아 사용량 추적 도구가 놓치기 쉽다.
4. 1:58
   Anthropic 수치와 차이 Anthropic 측 집계는 더 낮지만, 개별 사용 환경에 따라 8~10% 수준까지 올라갈 수 있으며, 작업이 길어지고 변경이 잦을수록 30초 주기 요약이 빠르게 누적된다.
5. 2:32
   캐시와 사용량 논란 대부분의 입력 토큰이 prompt cache read라서 API 가격은 낮아도 구독형에서는 여전히 사용량으로 잡히고, 최근 사용량 급증 논란은 많은 배경 에이전트를 장시간 돌린 세션과 맞물려 커졌다.
6. 3:16
   설정을 끌 때의 절충 공식적으로는 끄는 설정이 없지만 `Claude code fork sub-agents`를 0으로 두면 요약을 사실상 막을 수 있고, 대신 전체 대화 맥락을 상속하는 fork sub-agents를 잃게 된다.
7. 3:55
   타이머 우회법의 주의점 bun preload script로 `set timeout`을 훅킹해 요약 타이머를 막는 방법도 있지만, 모든 Claude Code 프로세스에 적용되고 최신 버전을 그대로 설치하므로 코드 검토와 버전 고정이 필요하다.
8. 4:22
   요약 기능의 가치와 한계 요약 자체는 에이전트 상태 파악에 도움이 되지만, 30초마다 자동으로 돌면서 끌 수 없는 구조는 불편하며 더 저렴한 대안이 나오길 기대하게 만든다.

실무 인사이트

• 배경 에이전트를 오래 돌리는 환경이라면 요약 비용이 로그상 보이지 않아도 실제 청구 사용량을 크게 흔들 수 있으니, 별도 텔레메트리로 추적해야 한다.
• 요약을 끄는 우회법은 가능하지만 fork sub-agents 손실이나 프로세스 전체 훅킹 같은 대가가 있어, 비용 절감과 작업 맥락 유지 중 무엇이 더 중요한지 먼저 정해야 한다.
• 장시간 자율 실행형 워크플로에서는 30초 주기 상태 요약이 누적되기 쉬우므로, 작업 단위와 실행 시간을 줄이는 쪽이 가장 안전한 비용 최적화다.