클로드 코드, 상태 문구에 대화 기록 반복 전송

클로드 코드(Claude Code)는 백그라운드 에이전트의 짧은 상태 문구를 갱신하려고 약 30초마다 해당 에이전트의 대화 기록 전체를 모델에 다시 보낸다. 플레임릭스 AI(Flamerix AI)는 이 요청이 자체 비용 추정치의 약 15~20%를 차지할 수 있다고 분석하고, 바이너리를 수정하지 않고 요청을 막는 패치를 공개했다. 화면에 표시되는 몇 단어가 사용 한도에 얼마나 영향을 주는지, 또 그 기능만 선택적으로 끌 수 있는지가 쟁점이다.

핵심요약

  • 클로드 코드는 백그라운드 에이전트마다 약 30초 간격으로 전체 대화 기록을 모델에 보내 상태 문구를 갱신해, 짧은 화면 표시에도 반복적인 모델 호출을 쓴다.
  • 플레임릭스 AI는 이 호출이 자체 비용 추정치에서 약 15~20%를 차지할 수 있다고 분석했으며, 구독 이용자에게는 청구액보다 사용 한도 여유가 줄어드는 문제로 나타난다고 설명했다.
  • 공개된 패치는 분(Bun)의 사전 로드 기능으로 특정 타이머만 막아, 백그라운드 에이전트의 작업은 유지하면서 상태 문구 갱신을 멈춘다.
  • 패치는 클로드 코드 업데이트로 조용히 무력화될 수 있어, 설치 후와 업데이트 때마다 로그 및 요청 지표를 확인해야 한다.
  • 토론에서는 실제 부담이 에이전트 사용 방식과 대화 길이에 따라 달라진다는 의견과, 이를 끄는 공식 설정이 없다는 비판이 함께 나왔다.

세 단어 상태 문구에 전체 대화 기록

플레임릭스 AI가 지목한 기능은 클로드 코드의 에이전트 패널에 표시되는 진행 상태다. 백그라운드 에이전트가 실행 중이면 클로드 코드는 약 30초마다 그 에이전트의 대화 기록 전체를 해당 에이전트의 모델에 다시 보내고, 최근 작업을 3~5단어로 설명해 달라고 요청한다. 이 응답은 패널의 상태 문구를 바꿀 뿐, 이용자와 나누는 대화나 작업을 수행하는 모델에는 전달되지 않는다.

문제는 문구의 길이가 아니라 문구를 얻는 방식이다. 에이전트가 오래 실행되거나 여러 개가 동시에 돌아가면, 각 에이전트의 기록을 읽는 호출이 반복된다. 대화 기록이 길수록 짧은 상태 문구 하나를 위한 입력도 커진다. 작성자는 클로드 코드 2.1.232 버전부터 이 기능이 기본으로 켜졌으며, 이를 끄는 설정은 없다고 설명한다.

비용은 어디에 잡혔나

이상 징후는 클로드 코드의 오픈텔레메트리(OpenTelemetry·프로그램의 동작 지표를 수집하는 체계) 내보내기 자료에서 발견됐다. 분석에 참여한 DRIM은 API 요청을 query_source별로 묶어 살폈고, 상태 문구를 만드는 agent_summary 항목의 비용 추정치가 주 대화보다 크게 잡힌 사례를 확인했다. 여기서 비용은 실제 청구서가 아니라 클로드 코드가 요청마다 계산한 cost_usd 값이다. 구독 이용자에게 직접적인 문제는 그만큼 사용 한도에 남는 여유가 줄어든다는 점이다.

작성자는 별도로 모인 네 차례의 측정에서 이 요청의 비중이 1826%였다고 소개한다. 자체 지표에서는 주간 비용 추정치 중 해당 기능의 몫이 7월 3.57%에서 7.3%를 거쳐, 2.1.233 버전을 사용하기 시작한 주에 11.8%가 됐고 10월 중순에는 약 16%에 이르렀다고 적었다. 이 수치는 모든 이용자에게 같은 비율이 적용된다는 뜻은 아니다. 백그라운드 에이전트를 얼마나 쓰고, 각 에이전트가 얼마나 긴 기록을 쌓는지가 호출량과 입력 크기를 바꾼다.

타이머 하나만 골라 멈추는 패치

공개된 no-agent-summary.js는 약 70줄짜리 분 사전 로드(preload·프로그램 실행 전에 코드를 먼저 불러오는 방식) 스크립트다. 클로드 코드 바이너리를 고치는 대신 전역 setTimeout을 감싸고, 상태 요약용 콜백의 소스에 특정 문구가 있는지 검사한다. 일치하면 실제 타이머를 등록하지 않고 작동하지 않는 핸들을 돌려준다. 다른 타이머는 그대로 통과시켜 에이전트의 작업은 계속되도록 설계했다.

이처럼 우회한 이유는 클로드 코드의 해당 모듈이 미리 컴파일된 분 바이트코드로 배포되기 때문이다. 작성자에 따르면 바이너리 안의 자바스크립트 텍스트를 고쳐도 효과가 없고, API 요청도 전역 fetch를 감싸는 방식으로는 가로챌 수 없다. 반면 바이트코드에서 실행되는 콜백이라도 Function.prototype.toString으로 소스 문자열을 확인할 수 있어, 상태 요약 타이머를 구별하는 단서가 된다. 작동하지 않는 타이머에는 2³¹−1밀리초를 지정했는데, 그보다 큰 지연값은 Node와 분에서 오히려 1밀리초로 처리될 수 있기 때문이다.

패치는 아무 분 프로그램에서나 동작하도록 만들어지지 않았다. 작성자는 실행 진입점인 Bun.main과 실행 파일 경로인 process.execPath를 함께 확인해 클로드 코드 프로세스일 때만 후크(기존 함수의 동작을 가로채 바꾸는 코드)를 설치한다고 설명한다. 콜백을 검사한 결과는 WeakMap에 저장해 같은 콜백의 소스를 반복해서 읽지 않는다. 작성자가 제시한 한 차례의 측정에서 claude --version 실행 시간은 약 10밀리초에서 약 17밀리초로 늘었다.

설치만큼 중요한 데몬 재시작

설치할 때는 스크립트를 안정적인 경로에 두고, 환경 변수 BUN_OPTIONS에 --preload=절대경로 형식으로 지정한다. 작성자는 = 대신 공백을 쓰면 bun install 같은 하위 명령이 깨질 수 있다고 경고한다. 셸 환경에 설정하거나, 실제 클로드 코드 실행 파일을 호출하기 전에 환경 변수를 붙이는 래퍼를 사용할 수 있다. 어느 쪽이든 백그라운드 프로세스까지 같은 설정을 물려받아야 한다.

특히 이미 떠 있는 데몬은 새 환경 변수를 자동으로 받아들이지 않는다. 작성자는 claude daemon stop --any로 데몬을 중지하고 실행 중인 세션도 다시 시작하라고 안내한다. 데몬에서 만들어지는 터미널 호스트와 대기 중인 백그라운드 세션에도 이전 환경이 남을 수 있기 때문이다. claude -p 방식의 실행, 예약 작업, CI, 편집기 연동에서도 패치를 쓰려면 각각의 실행 환경에 설정이 전달돼야 한다.

업데이트 뒤에는 요청 건수로 검증

패치가 로드됐는지는 로그에서 preload active mode=off를 확인하는 것이 첫 단계다. 이어 백그라운드 에이전트를 1~2분 실행해 상태 요약 타이머가 억제됐다는 로그와 패널 상태 문구의 갱신 중단을 확인한다. 오픈텔레메트리 자료를 내보낼 수 있다면 query_source = agent_summary 요청이 0건인지 살피는 것이 가장 확실하다. 작성자는 이 마지막 검사가 가능한 실패 유형을 모두 잡아내는 방법이라고 설명한다.

검증을 업데이트마다 반복해야 하는 이유는 패치가 공식 설정이 아니라 콜백의 소스 문자열에 의존하기 때문이다. 상태 요약과 관련된 문자열이 바뀌거나 콜백 밖으로 옮겨지면 더는 일치하지 않을 수 있다. 타이머가 다른 함수나 스케줄러로 옮겨져도 패치는 조용히 작동을 멈춘다. 작성자의 환경에서는 패치를 적용한 뒤 agent_summary 요청이 0건이었고 다른 부가 요청이 그 자리를 대신하지 않았지만, 이후 버전에서도 같은 결과를 보장하는 방식은 아니다.

왜 기존 설정으로는 끌 수 없나

작성자는 문서에 나온 설정과 SDK 옵션을 살폈지만, 상태 요약만 끄는 방법을 찾지 못했다고 밝혔다. SDK의 agentProgressSummaries는 기본값이 false이지만, 클로드 코드 내부에서는 다른 조건과 함께 평가되고 값을 기록하는 경로는 true로 설정된다는 설명이다. 요약 간격은 서버에서 모델 계열별로 정해지며 30~240초 범위로 제한돼, 간격을 바꿔 기능을 끄는 방법도 통하지 않는다. 일부 환경 변수는 효과가 없고, 다른 변수는 상태 요약뿐 아니라 에이전트 기능 자체를 멈춘다.

캐시(앞선 입력을 재사용해 처리 비용을 낮추는 기능)도 부담을 없애지는 않는다. 작성자에 따르면 약 98%의 상태 요약 호출은 캐시에서 대화 기록을 다시 읽지만, 캐시를 쓰지 못한 약 2%가 전체 비용 추정치의 3분의 1 넘게 차지한다. 더구나 이 요청은 디스크의 세션 로그에 기록되지 않아, 대화 기록을 읽는 비용 분석 도구에서는 보이지 않는다. 작성자는 2.1.310 버전에 전체 기록 대신 약 2,000토큰의 메모를 쓰는 짧은 방식도 들어 있지만, 기본값은 여전히 전체 기록이며 전환에는 서버 측 설정이 필요하다고 적었다.

확인된 환경과 남는 대가

작성자가 직접 시험한 환경은 리눅스의 클로드 코드 2.1.257~2.1.312 버전이다. 맥OS에서 작동했다는 보고도 받았지만, 윈도는 시험하지 않았다. 자동 실행 방식인 claude -p에서는 상태 요약 타이머가 기본으로 켜지지 않아, 작성자의 동작 시험은 별도 변수를 사용해 기능을 활성화한 뒤 진행됐다. 따라서 문서가 다루는 기본 상태의 반복 호출은 대화형 세션에서 백그라운드 에이전트를 쓸 때가 중심이다.

패치를 적용해도 하위 에이전트와 백그라운드 작업은 정상 실행된다는 것이 작성자의 시험 결과다. 대신 에이전트 패널의 상태 문구는 갱신되지 않고 SDK의 task_progress에도 요약이 나타나지 않는다. 작성자는 런타임 동작을 바꾸는 일이 이용 중인 서비스 약관과 충돌할 수 있으며, 사용자가 이를 확인해야 한다고 명시했다. 절약되는 사용량뿐 아니라 잃는 진행 정보, 업데이트 때마다 확인해야 할 유지 부담까지 함께 따져야 하는 패치다.

커뮤니티 의견

한 사용자는 클로드 코드가 이메일 주소를 시스템 프롬프트에 넣고, 오퍼스(Opus)가 이를 외부 요청 헤더에 포함하는 사례를 거론하며 제거용 플러그인을 소개했다. 답글에서는 일부 사이트가 자동화된 접근에 연락처를 요구하기 때문에 나타난 동작이라는 설명이 나왔다. 다른 답글은 외부 사이트의 요구만으로 개인정보가 전달될 수 있다면 위험하다고 반박했다.

한 사용자는 토큰을 크게 쓰는 기능이 거듭 발견된다며, 모델 제공업체가 실행 도구까지 직접 만드는 구조의 동기를 따져봐야 한다고 주장했다. 답글에는 이윤 때문이라는 비판과, 스킬 및 MCP를 지원하는 대체 도구를 찾기 어렵다는 반응이 이어졌다. 별도 의견도 추론 서비스를 파는 업체와 이용량을 아껴야 하는 사용자의 이해관계가 다를 수 있다고 지적했다.

한 구독 이용자는 자신의 무거운 사용 주간을 바탕으로 상태 문구 호출의 API 환산 비용을 약 380달러, 전체의 16%로 추정했다고 말했다. 이는 대화 기록에 해당 호출이 남지 않아 30초 주기를 적용해 계산한 개인 추정치다. 답글에서는 구독 상품의 사용 한도와 API 환산액을 단순히 대응시키기 어렵고, 캐시 적중률도 확인해야 한다는 지적이 나왔다.

전체 기록을 다시 보내더라도 대부분 캐시에 적중하면 저렴하지 않겠느냐는 반론도 나왔다. 이에 다른 사용자는 캐시 입력이라도 같은 긴 문맥을 여러 번 읽히면 비용이 누적된다고 맞섰다. 토론 후반에도 캐시 덕에 토큰당 단가는 낮아질 수 있지만, 반복 횟수가 많으면 자체 비용 추정치에서 차지하는 몫이 커진다는 의견이 이어졌다.

한 사용자는 최근 자신의 5시간 사용 한도가 주간 한도에서 차지하는 비율이 달라졌다며 무언가 조정된 것 같다고 말했다. 답글에는 캐시 만료 전 대화를 압축하는 동작이 토큰을 아꼈을 수 있다는 해석과, 다른 계정에서는 여전히 한도가 빠르게 줄어든다는 경험담이 붙었다. 이 대화는 체감 사용량의 변화를 상태 요약 호출 하나로 설명하기 어렵다는 점도 보여준다.

패치 자체를 두고는 거칠지만 영리하다는 평가가 나왔다. 전역 setTimeout을 감싸 특정 콜백만 걸러내는 방식이 우회 기술의 묘미라는 의견이다. 반면 핵심 패치는 비교적 단순한데 설명 문서가 연혁과 버전 정보를 길게 나열해 요점을 찾기 어렵다는 비판도 있었다.

직접 시험했다는 사용자는 이 현상이 하위 에이전트에 해당하며 자신이 쓴 워크플로에서는 보이지 않았다고 말했다. 짧은 문맥의 에이전트는 비용이 작고 긴 문맥은 커져, 자신의 세션에서는 최대 약 8% 수준이었다는 설명이다. 답글에는 끌 수 없는 기능이라면 8%도 크다는 반응과, 조사용 하위 에이전트를 많이 쓰는 자신의 세션에서는 약 16%라는 경험담이 이어졌다.

또 다른 사용자들은 클로드 코드가 기능에 비해 무겁다며 더 간결한 도구를 선호한다고 밝혔다. 이에 용도에 따라 복잡한 도구와 가벼운 도구가 모두 필요하다는 답글도 달렸다. 논의의 초점은 특정 대체 도구 하나보다, 실행 도구가 어떤 부가 모델 호출을 하는지 사용자가 알고 선택할 수 있어야 한다는 데 모였다.

핵심통찰

이 사례가 드러낸 변화는 에이전트의 작업 자체뿐 아니라 ‘작업 중임을 보여주는 화면’에도 모델 사용량이 들어간다는 점이다. 더구나 그 호출이 세션 로그에는 보이지 않고, 공식 설정으로는 별도로 끌 수도 없다. 패치는 사용량을 줄이는 선택지를 만들지만 상태 정보와 유지 편의성을 맞바꾼다. 앞으로 볼 것은 개인별 절감 비율 하나가 아니라, 클로드 코드가 이 호출을 얼마나 투명하게 보여주고 짧은 요약 방식이나 끄기 옵션을 이용자에게 열어 주는지다.


원본: Claude Code burns ~15-20% of your tokens on a 3-word status line: a Bun preload that turns agent_summary off · by Flamerix AI, flamerix.ai · MIT

토론: Hacker News