Claude Code가 질문하기 전에 보내는 토큰량 측정: 2025년 7월부터 현재까지 58개 버전 실측

Claude Code는 요청할 때마다 동일한 고정된 덩어리(chunk)를 먼저 전송합니다. 이는 시스템 프롬프트와 모든 내장 도구의 정의입니다. 사용자의 입력이 계산되기 전에 비용이 발생하며, 이것이 짧은 세션이나 서브 에이전트에서 제한량이 예상보다 빨리 줄어드는 이유 중 하나입니다. 이 덩어리가 버전별로 어떻게 변화했는지 알고 싶어서, 오래된 버전까지 설치하여 측정했습니다.

• npm을 통해 Claude Code를 58개 버전, 폴더별로 설치했습니다. 1.0.60 (2025년 7월)부터 2.1.310 (2026년 10월 23일)까지입니다.
• 각 버전에
  claude -p
  을 사용하여 'a' 한 글자만 전송했습니다. 모델은 Claude Haiku 5.5, 빈 폴더, 새로운 설정 폴더(CLAUDE.md・플러그인・설정 없음)를 사용했습니다. 첫 번째 모델 요청의 입력 토큰(캐시 없음 + 캐시 읽기 + 캐시 쓰기)을 기록했습니다.
• MCP를 비활성화(off)한 상태로 각 3회 측정했습니다. claude.ai에 연결된 앱 13개를 활성화한 상태로 각각 1회 측정했습니다.
• Windows 노트북 1대를 사용했습니다. 이전 버전은 10월 21일, 최신 12개 버전은 10월 24일에 동일한 스크립트와 같은 로그인으로 측정했습니다.

눈에 띄는 점은 세 가지입니다.

• 10개월 동안 증가했습니다. 2025년 7월의 19,498 토큰에서 2026년 5월에는 36,309 토큰으로 86%가 증가했습니다. 그 사이에 내장 도구는 15개에서 27개로 늘어났습니다.
• 한 번의 업데이트로 39% 감소했습니다. 10월 7일 버전인 2.1.293에서는 29,701 토큰이었던 것이 18,055 토큰으로 줄었습니다. 도구 수는 동일했고, 2025년 중반 수준으로 돌아왔습니다.
• 그 이후는 조금씩 증가하고 있습니다. 2.1.293 이후의 15개 버전에서 18,841 토큰까지 4%가 증가했습니다. 1회당 약 100~400 토큰 정도입니다. 2.1.310에서는 25번째 내장 도구(Monitor)가 추가되었습니다.

동일한 버전은 매번 완전히 같은 수치였습니다. 평균이 아닌 고정된 값입니다.

claude.ai에 연결된 앱은 Claude Code에서도 사용할 수 있습니다. 2.1.83부터 2.1.140까지 (2026년 3월 말5월 중순)는 해당 도구들이 모든 요청에 포함되어 있었습니다. 제 계정의 연결 앱 13개에서는 도구가 420426개 증가하여, 'a' 한 글자에 약 39만 5천 토큰이 소요되었습니다. 2.1.145 이후부터는 필요한 때만 로드되며, 이번 달에 측정한 버전에서는 연결 앱의 활성화/비활성화 여부에 따라 수치가 동일했습니다.

• 이 고정된 덩어리는 첫 요청 후에는 일반적으로 프롬프트 캐시에서 읽히며, 입력 비용의 10분의 1 이하로 계산됩니다. 따라서 짧은 세션, 서브 에이전트(각각 새로 시작됨), 또는 캐시가 만료된 후의 비용이 가장 클 수 있습니다.

• Claude Code를 구형 버전으로 사용한다면, 업데이트하는 것이 토큰 절약에 가장 쉬운 방법입니다.

• 실제 환경에서는 이보다 더 커집니다. CLAUDE.md, MCP 서버, 플러그인, 스킬 등이 모두 추가되기 때문입니다.

• 모델 1개(Haiku 5.5), 질문 1개, Windows PC 1대 기준입니다. 모델이나 OS가 다르면 시스템 프롬프트가 변경되므로 절대값은 달라집니다. 흐름을 보는 것이 중요합니다.

• 구형 버전도 현재 API와 계정으로 작동시켰습니다. 서버가 계정별로 활성화하는 기능 때문에, 출시 당시와는 다를 수 있습니다.

• 1.0.60보다 오래된 버전은 Windows에 설치할 수 없었습니다.

• 전체 표, 버전별 CSV, 스크립트, 원본 로그 (CC BY 4.0, DOI 10.5281/zenodo.23527278): https://tokensave.app/data/claude-code-baseline-tokens-by-version

• 관련 데이터: 하네스(harness)의 나머지 비용 (서브 에이전트 +128%, 최소 구성 −64%) https://tokensave.app/data/claude-code-harness-cost