구체적으로 Claude Code 는 약 30 초마다 모든 백그라운드 에이전트에게 에이전트의 대화 기록 전체를 에이전트 자체의 모델에 전송하고 "최근 행동 3~5 단어로 설명해 주세요"라고 요청합니다.
각 에이전트로부터 얻은 답변은 에이전트 패널의 상태 행을 업데이트하는 데만 사용되며, 모델이나 대화에는 정보가 제공되지 않습니다.
에이전트 요약 기능은 2026 년 8 월 Claude Code 버전 2.1 에서 기본적으로 활성화되며, 설정을 통해 비활성화할 수 없습니다.
에이전트 요약 비활성화 불가라는 문제점에 대해 Flamerix AI 는 Bun 의 프리로딩 스크립트인 'no-agent-summary.js'를 개발하여 해결책을 제시했습니다.
'no-agent-summary.js'는 약 70 줄의 JavaScript 스크립트로, 글로벌 함수 setTimeout() 을 래핑하여 '[AgentSummary] Timer fired'와 같은 특정 어커를 포함하는 콜백을 감지할 경우 타이머 시작을 방지합니다.
즉, 에이전트 요약 기능 관련 타이머만 비활성화하고 다른 타이머 처리에는 영향을 주지 않는 방식입니다.
Claude Code 바이너리 자체를 변경하지 않고 Bun 의 '--preload' 옵션을 사용하여 로드되므로, Claude Code 업데이트에도 무효화되지 않습니다.
Flamerix AI 에 따르면 'no-agent-summary.js'의 영향과 주의사항은 다음과 같습니다.
* 가시적 효과: 에이전트 서머리 요청이 0 이 되면 에이전트별 패널 상태가 업데이트되지 않습니다.
* 오버헤드: Function.prototype.toString 호출이 각 타이머 콜백에 대해 수행되지만 WeakMap 으로 캐싱되므로 영향은 미미함 (약 10ms 에서 약 17ms 로 증가).
* OS 호환성: Linux, macOS, Windows 에서 작동 여부를 확인한 보고가 있습니다 (단, Windows 는 제한적).
* 업데이트 시 주의사항: Claude Code 업데이트 시 스크립트 어커가 변경되면 기능이 작동하지 않으므로, 업데이트 후 반드시 검증 절차를 실행해야 합니다.
또한 IT 벤처 Arrowheads 가 운영하는 Claude Code 연구소는 위 어커 변경 시 발생하는 문제뿐만 아니라 환경 변수 'BUN_OPTIONS'를 사용하여 머신상의 모든 Bun 이 로드되는 점 등을 언급했습니다.
Claude Code 의 '에이전트 서머리' 기능은 백그라운드 에이전트의 상태를 약 30 초마다 업데이트하기 때문에, 전사 (기록된 데이터) 전체를 모델에 재전송합니다. 전사 전송으로 인해 토큰 사용량이 약 15~20% 를 차지하는 것으로 계산됩니다. Claude Code 는 3 단어 상태 라인에서 약 15~20% 의 토큰을 소모합니다: Bun preload 를 통해 agent_summary 를 끄는 방법 · by Flamerix AI, flamerix.ai · MIT https://gist.github.com/flamerix-ai/c3905705cc4205e5de3011fa2e74efce Claude Code 는 정기적으로 각 백그라운드 에이전트의 전사를 모델에 전송합니다 | Hacker News https://news.ycombinator.com/item?id=50284255 AI 도구 개발사인 Flamerix AI 가 OpenTelemetry 를 통한 분석을 수행한 결과, 에이전트 서머리 기능이 Claude Code 전체 토큰 지출의 약 15~20% 를 차지하며, API 요청 중 약 5 건 중 1 건이 에이전트 서머리 기능 때문에 전송되고 있음을 확인했습니다. 특히 Opus 모델을 사용할 경우 비용 증가가 두드러지며, 18~26% 의 토큰 사용량이 확인되었습니다.
js 사용은 권장하지 않습니다.
Claude Code 의 서브 에이전트가 백그라운드에서 작동할 때 30 초마다 요약?
agent_summary 의 토큰 사용량을 실측 | Claude Code 연구소 https://www.claude-code-lab.com/blog/claude-code-subagent-agent-summary 또한 Opus 에 대해서는 사용자 이메일 주소를 시스템 프로토콜 헤더에 포함시키는 다른 문제도 보고되었습니다.
While we're modding Claude Code, Anthropic includes your email in the system protocol header.
| Hacker News https://news.ycombinator.com/item?id=50285046
원문 보기 | 출처: Gigazine