8,392개의 Claude Code 세션 분석을 통한 토큰 낭비 진단 플러그인 개발

커뮤니티 반응

작성자가 직접 개발한 도구에 대해 긍정적인 반응이며, 특히 로컬에서만 작동하여 보안이 유지된다는 점과 비용 절감에 실질적인 도움이 된다는 점이 높게 평가받았다.

주요 논점

01찬성다수

Claude Code의 비용 관리를 위해 세션 데이터를 시각화하고 이상 징후를 탐지하는 도구가 필수적이다.

합의점 vs 논쟁점

합의점

데이터 보안을 위해 분석 도구는 로컬에서 작동해야 한다.
프롬프트 캐싱 효율을 높이는 것이 비용 절감의 핵심이다.

실용적 조언

claude plugin install claude-token-analyzer 명령어로 플러그인을 설치하여 본인의 지출 내역을 확인 가능하다.
ExcessiveToolUse 경고가 뜰 경우 모델에게 도구 사용을 줄이도록 프롬프트를 수정하여 비용을 절감할 수 있다.

섹션별 상세

Claude Code 세션의 토큰 효율성을 분석하는 플러그인 'Claude Token Analyzer'가 개발됐다. 이 도구는 Rust 기반의 MCP 서버를 사용하여 로컬 JSONL 파일을 SQLite 데이터베이스로 파싱하고 통계적 분석을 수행한다. 모든 데이터 처리는 사용자의 기기 내에서 로컬로 이루어지며 외부 클라우드나 텔레메트리 전송이 없어 보안성이 높다.

Claude Token Analyzer가 생성한 2026년 3월분 비용 리포트 터미널 화면이다. — Screenshot프로젝트별 비용(Cost)과 세션 수(Sessions)를 표 형태로 보여주며, 특정 세션(claude-mem-observer-sessions)이 가장 높은 비용($1,683.58)을 차지하고 있음을 나타낸다. 사용자가 어떤 프로젝트에서 토큰 낭비가 심한지 한눈에 파악할 수 있게 돕는다.

분석 도구는 총 6가지 유형의 이상 징후(HighCost, LowCacheHitRate, ExcessiveToolUse 등)를 감지하며 각 항목에 심각도 점수를 부여한다. 8,392개의 세션을 스캔한 결과 1,015개의 이상 징후가 발견되었으며, 그중 '과도한 도구 사용(ExcessiveToolUse)'이 320건으로 가장 많았다. 이는 모델이 불필요하게 많은 도구 호출을 수행하여 토큰을 낭비하고 있음을 시사한다.

낮은 캐시 히트율(LowCacheHitRate)이 261개 세션에서 발견되어 비용 효율성 저하의 주요 원인으로 지목됐다. 프롬프트 캐싱이 제대로 작동하지 않아 동일한 데이터가 반복적으로 전송되면서 비용이 누적되는 현상이 확인됐다. 특히 고비용과 낮은 캐시 히트율이 결합된 '비효율적 비용(Cost-Inefficient)' 사례도 66건에 달했다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — AI 모델이 로컬 데이터나 도구와 안전하게 상호작용할 수 있도록 Anthropic에서 공개한 개방형 표준 프로토콜이다. 클라이언트와 서버 간의 통신 규약을 정의하여 다양한 도구를 모델에 쉽게 연결할 수 있게 한다.
캐시 히트율(Cache Hit Rate): — 프롬프트 캐싱 시스템에서 이전에 전송된 데이터를 다시 사용할 수 있는 비율을 의미한다. 히트율이 높을수록 중복된 데이터를 다시 전송하지 않아도 되므로 API 비용과 응답 시간을 크게 절감할 수 있다.
JSON 라인(JSONL): — 각 행이 하나의 유효한 JSON 객체로 구성된 텍스트 파일 형식이다. 대용량 로그 데이터를 한 줄씩 순차적으로 처리하기에 적합하여 Claude Code의 세션 기록 저장 등에 널리 사용된다.
표준 편차(Standard Deviation): — 데이터 값이 평균에서 얼마나 떨어져 있는지를 나타내는 통계적 지표이다. 이 아티클에서는 일반적인 토큰 사용량 범위를 벗어나는 이상 세션을 감지하기 위한 임계값 설정 기준으로 활용됐다.
토큰 낭비(Token Waste): — 불필요한 도구 호출, 중복된 프롬프트 전송, 비효율적인 컨텍스트 관리로 인해 발생하는 불필요한 토큰 소비 현상이다. 이는 직접적인 API 비용 상승과 모델의 추론 효율 저하를 초래한다.

코드 예제

bash

claude plugin install claude-token-analyzer

Claude Code에 토큰 분석 플러그인을 설치하는 명령어

언급된 도구

Claude Token Analyzer추천링크

Claude Code 세션의 토큰 사용량 및 비용 이상 징후 분석

언급된 리소스

GitHubClaude Token Analyzer GitHub Repository