Claude Code 토큰의 41.5%가 낭비되고 있다는 사실을 발견하여 무료 프로파일러를 만들었습니다
요약
Claude Code 사용 시 발생하는 토큰 낭비를 분석하기 위한 무료 프로파일러 'tokenscope'를 소개합니다. 도구 결과와 호출로 인해 발생하는 비효율적인 토큰 소비를 시각화하고 구체적인 해결책을 제시합니다.
핵심 포인트
- Claude Code 세션 토큰의 약 41.5%가 낭비될 수 있음을 발견
- tokenscope는 API 키 없이 로컬 로그를 분석하는 100% 오프라인 도구
- 카테고리별 내역, 낭비 경고, 예상 비용 및 HTML 트리맵 보고서 제공
- npx 명령어로 즉시 실행 가능한 제로 설정(Zero config) 설계
아무도 답할 수 없었던 질문
지난주 저는 궁금해졌습니다. 내 Claude Code 토큰은 실제로 어디로 사라지는 걸까? 매 세션마다 수천 개의 토큰이 소모되지만, 그 내역을 확인할 방법은 없었습니다. 프로파일러도, 대시보드도, 아무것도 없었죠. 그래서 제가 직접 만들었습니다.
내가 발견한 충격적인 사실
저는 제 해커톤 세션을 프로파일링했습니다: 274개의 메시지에 걸쳐 75,111개의 토큰이 사용되었습니다.
- 도구 결과 (Tool results)가 전체 토큰의 **77.4%**를 소비함
- 도구 호출 (Tool calls)이 추가로 **14.6%**를 차지함
- 제가 실제로 타이핑한 메시지는? 0.6%
- 감지된 총 낭비: 세션의 41.5%
단 하나의 비대해진 도구 결과가 혼자서 **전체 세션의 24%**를 소비했습니다. 이런 일이 일어나고 있는지 전혀 몰랐습니다.
도구: tokenscope
npx tokenscope-ai
이것이 설정의 전부입니다. 설정(config)도, API 키도, 계정도 필요 없습니다. 최신 Claude Code 세션을 자동으로 감지하여 다음 내용을 보여줍니다:
- 카테고리별 내역 (Category breakdown) — 모든 토큰이 어디로 갔는지 (system, user, assistant, tools)
- 낭비 발견 사항 (Waste findings) — 코드(W001: 반복된 콘텐츠, W002: 비대한 도구 결과)가 포함된 린터(linter) 스타일의 경고와 구체적인 해결책
- 달러 추정치 (Dollar estimates) — 모델 가격을 기반으로 한 세션 비용 및 낭비 비용
- HTML 트리맵 보고서 (HTML treemap report) —
--html report.html을 추가하여 브라우저에서 열 수 있는 시각적 내역 확인
타협하지 않은 설계 원칙
100% 오프라인. API 키, 계정, 텔레메트리(telemetry)가 없습니다. Claude Code가 이미 사용자의 기기에 기록하고 있는 JSONL 로그를 읽습니다. 그 어떤 것도 컴퓨터를 떠나지 않습니다. 절대 말이죠.
제로 설정 (Zero config). 명령어 하나면 됩니다. Windows, Mac, Linux에서 로그를 자동으로 찾아냅니다.
정직한 수치. 토큰 수는 로컬 토크나이저(tokenizer)를 사용한 추정치(~±5%)이며, 그렇게 표시합니다. 프로파일링의 목적은 청구의 정밀함이 아니라, 비율을 파악하고 낭비를 찾는 것입니다.
실행 가능한 발견 사항 (Actionable findings). 모든 발견 사항에는 구체적인 해결책과 예상 절감액이 포함되어 있습니다. 단순한 과시용 대시보드가 아니라, 컨텍스트 윈도우(context window)를 위한 ESLint와 같습니다.
출력 예시
다음 단계
- 프록시 모드 (Proxy mode) — Claude Code뿐만 아니라 모든 AI 도구의 트래픽을 가로챕니다.
- 비교 모드 (Compare mode) — 최적화가 효과가 있었는지 증명하기 위해 전후를 프로파일링합니다.
- 캐시 미스 탐지 (Cache-miss detection) — 캐시되었어야 하지만 그렇지 않은 토큰을 찾아냅니다.
- GitHub Action — CI에서 토큰 예산(token budgets)을 설정합니다.
사용해 보기
npx tokenscope-ai
여러분의 Claude Code 세션에서 직접 실행해 보세요. 실제로 얼마나 많은 낭비율이 발견되는지 정말 궁금합니다. 댓글로 알려주세요.
만약 로그에서 충돌이 발생한다면 (이번 주에 제작된 v0.1 버전입니다), 이슈를 생성해 주세요: github.com/yaswanthme007/tokenscope
Claude Code로 제작되었습니다. 네, 자기 자신의 생성 과정을 직접 프로파일링했습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기