Claude Code 사용량 및 비용 분석 도구: claude-code-stats 공개

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

Claude Code의 로컬 세션 로그를 분석하여 토큰 사용량과 API 환산 비용을 시각화해주는 로컬 대시보드 도구 claude-code-stats를 소개한다.

배경

Claude Max 플랜 사용자가 API 비용 대비 실제 절약액을 확인하기 위해 Claude Code로 직접 개발한 분석 도구를 공유했다. 로컬에 저장된 JSONL 로그 파일을 파싱하여 세션별 비용과 모델별 통계를 HTML 대시보드로 시각화한다.

커뮤니티 반응

작성자의 도구 개발에 대해 긍정적인 반응이며, 특히 로컬 데이터의 투명성과 비용 절감 확인 기능에 높은 관심을 보였다.

실용적 조언

Claude Code의 실제 비용이 궁금하다면 ~/.claude/ 디렉토리의 JSONL 파일을 직접 확인하여 분석 가능하다.
대규모 프로젝트에서 Claude Code를 사용할 경우 API 방식보다 Max 플랜 구독이 비용 면에서 유리하다.

섹션별 상세

Claude Code가 로컬 시스템(~/.claude/)에 저장하는 데이터 구조를 상세히 설명했다. 세션 기록인 JSONL 파일에는 메시지당 입력/출력 토큰뿐만 아니라 캐시 읽기 및 생성 비용까지 포함되어 있어 정밀한 비용 계산이 가능하다. 또한 하위 에이전트(subagents)의 기록도 별도로 관리됨을 확인했다.

Max 플랜과 API 사용 비용을 직접 비교한 결과 상당한 비용 절감 효과가 있음을 발견했다. 작성자는 일부 긴 코딩 세션의 경우 API 요율을 적용했을 때 단일 세션만으로도 15달러 이상의 비용이 발생할 수 있음을 수치로 확인했다. 이는 구독형 플랜의 경제성을 입증하는 근거가 된다.

개발한 도구인 'claude-code-stats'의 주요 기능과 작동 방식을 공유했다. 이 도구는 서버 없이 독립적인 HTML 대시보드를 생성하며, 데이터가 외부로 유출되지 않도록 로컬에서만 실행된다. 크론(cron)을 이용한 자동 업데이트와 다국어 지원 기능도 포함되어 있다.

실무 Takeaway

Claude Code는 로컬의 ~/.claude/ 디렉토리에 매우 상세한 세션 로그와 메타데이터를 저장한다.
구독형 플랜(Max)이 헤비 유저에게는 API 사용 방식보다 훨씬 경제적일 수 있다.
claude-code-stats 도구를 사용하면 개인의 AI 코딩 습관과 비용 효율성을 시각적으로 파악할 수 있다.

언급된 도구

Claude Code추천

Anthropic의 공식 CLI 코딩 에이전트

claude-code-stats추천

Claude Code 세션 로그 분석 및 시각화 대시보드