40,000 토큰을 소비하는 다섯 단어짜리 레이블
Claude Code는 30초마다 활성 background agents를 폴링하여 에이전트 패널에 표시할 작업 요약을 언어 모델에 요청합니다. 사용자 가시성을 위해 설계된 이 사소해 보이는 기능은 사용자의 토큰 할당량 중 상당 부분을 조용히 소모할 수 있습니다.
Claude Code의 추적 데이터를 내보낸 Better Stack의 OpenTelemetry 테스트 결과, 이러한 소모의 규모가 드러났습니다. 요약 요청은 약 30초마다 발생했으며, 매번 에이전트의 전체 대화 기록을 전송했습니다. 이러한 컨텍스트 비대화로 인해 "7번째 20초 sleep 실행 중"과 같은 단 130개의 출력 토큰을 생성하기 위해 약 40,000개의 입력 토큰이 요청에 포함되는 경우가 많았습니다.
query_source = "agent_summary"로 태그된 이 요약들은 여러 개의 sleep 20 작업을 실행하도록 설계된 합성 세션에서 전체 비용의 12%를 차지했습니다. 3개의 백그라운드 에이전트를 사용하여 TanStack 사이트를 구축하는 더 현실적인 시나리오에서도 요약 오버헤드는 세션 전체 토큰 사용량의 약 8%를 소비했습니다. 이는 시스템이 이러한 요약에 대해 Claude Claude Haiku와 같은 더 저렴한 대안 대신 기본 에이전트 모델(종종 Claude Claude Opus)을 사용하도록 기본 설정되어 있기 때문에 발생합니다.
작은 상태 업데이트가 계속해서 더 비싸지는 이유
Claude Code는 반복적으로 각 활성 백그라운드 에이전트에 대해 최근 변경 사항뿐만 아니라 전체 대화 기록을 모델로 보냅니다. 이는 폴링 주기에 따라 컨텍스트와 입력 토큰 볼륨을 누적시켜, 한 테스트에서는 18개의 메시지가 42개로 증가했습니다. 각 요약 호출은 "7번째 20초 sleep 실행 중"과 같은 단 130개의 출력 토큰을 생성하기 위해 약 40,000개의 입력 토큰을 소비했습니다.
중요한 우려 사항은 모델 선택입니다. 영상의 테스트 결과, 이러한 요약 호출이 더 작고 경제적인 모델인 Claude Claude Haiku 대신 비싼 Claude Claude Opus를 포함하여 에이전트에 할당된 모델에서 실행되는 것으로 나타났습니다. 이는 일상적인 UI 업데이트 비용을 증폭시킵니다.
이 토큰 소모에 대한 커뮤니티의 측정치는 에이전트 수와 활동에 따라 다르게 나타납니다. Better Stack의 테스트 결과, agent_summary는 합성 sleep 세션의 12%, 현실적인 TanStack 빌드의 8%를 차지했습니다. 다른 커뮤니티 벤치마크에서는 무거운 멀티 에이전트 워크플로우의 경우 8%에서 26%까지 범위가 나타났습니다.
Anthropic은 더 낮은 평균치를 제시하며, 한 엔지니어는 전역 텔레메트리 전반에서 API 비용의 2%, 터미널에서는 6%라고 언급했습니다. 프롬프트 캐싱은 API 가격을 약 1/10로 줄일 수 있지만, Anthropic은 구독 사용량이 실제 비용 절감에 대한 완전한 투명성 없이 여전히 할당량에서 차감된다고 밝히고 있습니다.
일반적인 로그에서는 찾을 수 없는 사용량
agent_summary의 숨겨진 비용을 관찰하려면 표준 로깅 너머를 들여다봐야 합니다. 비용 분석을 위해 cc-usage와 같은 도구에서 자주 사용하는 Claude Code의 로컬 .jsonl 트랜스크립트는 이러한 요약 요청을 기록하지 않습니다. 결과적으로 트랜스크립트 기반의 사용량 계산은 실제 토큰 소비량을 상당히 과소평가할 수 있습니다.
agent_summary 활동을 확인하려면 Claude Code 내에서 OpenTelemetry 내보내기를 활성화하십시오. 이러한 추적을 Better Stack과 같은 관찰 가능성 플랫폼으로 내보내십시오. 거기서 query_source = agent_summary별로 요청을 필터링하고 그룹화하여 빈도와 토큰 볼륨을 확인하십시오. 이 방법은 이러한 특정 오버헤드에 대한 세분화되고 측정 가능한 증거를 제공합니다.
Better Stack의 테스트 결과에 따르면 agent_summary는 합성 수면 테스트에서 전체 세션 비용의 12%, 실제 TanStack 빌드 중에는 8%를 차지했습니다. Flamerix AI의 외부 커뮤니티 조사 결과에 따르면 고빈도 다중 에이전트 실행 시 이러한 요약이 전체 비용의 최대 16.4%, API 요청의 19.7%를 차지하는 것으로 나타났습니다. Claude Code의 더 넓은 활용성에 대한 자세한 내용은 Claude Code: Best practices for agentic coding - Anthropic을 참조하세요.
Anthropic의 원격 측정 데이터에 따르면 API 정가 기준 전 세계 평균 2%, 터미널 내에서는 6%의 비용이 발생합니다. 이러한 수치는 특정 워크플로우에서 유의미한 오버헤드를 보여주지만, 정확한 점유율은 에이전트 활동, 작업 기간, 동시 프로세스에 따라 크게 달라집니다. 개별 사용 패턴이 토큰 소모량에 큰 영향을 미치므로, 이러한 측정된 영향과 일반적인 주장을 구분하는 것이 중요합니다.
이 글이 마음에 드셨나요? 매일 아침 이런 글을 메일로 받아보세요.
하루 한 통 · 두 번의 클릭으로 구독 취소 · 제3자 추적 없음
워크플로우를 방해하지 않고 비용 소모 줄이기
Claude Code의 토큰 소모를 완화하기 위해 에이전트 기반 워크플로우를 희생할 필요는 없습니다. 효과적인 해결 방법 중 하나는 fork_subagents 옵션을 0으로 설정하는 것입니다. 이렇게 하면 전체 대화 기록을 상속받는 하위 에이전트가 비활성화되어 요약 호출이 중단되는 동시에, 일반적인 백그라운드 에이전트는 더 적은 컨텍스트를 상속받아 계속 작동할 수 있습니다. 테스트 결과 이 방법으로 agent_summary 비용이 제거되는 것이 확인되었습니다.
또 다른 해결책은 다소 고급 기술이지만, Bun preload script를 사용하여 setTimeout을 후킹하고 요약 타이머를 차단하는 것입니다. 이 접근 방식은 Claude Code 프로세스를 수정하므로 코드를 철저히 검토해야 합니다. 출처가 불분명한 curl 설치 명령을 무분별하게 실행하지 말고, 보안 위험을 완화하기 위해 검토된 로컬 복사본을 고정하여 사용하세요.
향후 비용 소모를 최소화하려면 에이전트 사용량이 많은 세션을 적극적으로 모니터링하세요. 불필요한 하위 에이전트 확산을 피하고, 실시간 상태 레이블의 편의성과 누적 사용 비용을 신중하게 비교해 보세요. Anthropic 보고서에 따르면 프롬프트 캐싱 개선 및 더 저렴한 요약 옵션에 대한 개발이 진행 중이지만, 근본적인 해결책이 보장되는 것은 아닙니다.
자주 묻는 질문(FAQ)
Claude Code 에이전트 요약이란 무엇인가요?
이는 백그라운드 에이전트가 수행 중인 작업에 대한 짧은 설명으로, 에이전트 패널에 표시되며 모델에 의해 주기적으로 생성됩니다.
에이전트 요약은 어느 정도의 사용량을 소비하나요?
보고된 점유율은 워크플로우에 따라 다릅니다. Better Stack은 합성 테스트에서 12%, 다중 에이전트 빌드에서 약 8%를 측정했으며, Anthropic은 원격 측정 전반에서 더 낮은 평균치를 제시했습니다.
Claude Code 에이전트 요약을 끌 수 있나요?
소스에 설명된 직접적인 전용 토글은 없습니다. fork subagents를 0으로 설정하면 이러한 요약을 중단할 수 있지만, 포크된 에이전트가 컨텍스트를 상속받는 방식이 변경됩니다.
사용량 도구에서 이러한 호출을 누락하는 이유는 무엇인가요?
에이전트 요약 요청은 Claude Code의 표준 JSONL 기록에 나타나지 않을 수 있습니다. OpenTelemetry 데이터를 사용하면 agent_summary 쿼리 소스에서 이를 확인할 수 있습니다.
요약 호출은 항상 전체 토큰 가격으로 청구되나요?
반드시 그렇지는 않습니다. 프롬프트 캐싱을 통해 API 비용을 절감할 수 있지만, 구독 사용량 회계는 투명성이 낮으므로 정확한 영향은 플랜과 워크플로우에 따라 다릅니다.