ccusage로 Claude Code 사용량 분석하기

Claude Code를 자주 활용하다 보면, “이번 달 사용량은 얼마나 될까?” “어떤 모델을 가장 많이 활용했지?” 와 같은 질문이 자연스럽게 떠오르게 됩니다. 특히 유료 플랜을 사용하는 개발자라면, 정확한 사용량과 비용 현황을 파악하는 것은 매우 중요합니다.

이번 글에서는 이러한 니즈를 충족시켜줄 오픈소스 CLI 도구, ccusage를 소개합니다.
이 도구는 Claude Code의 사용 내역을 명확히 분석하고 시각화해 줌으로써, 개발자들이 효율적으로 리소스를 관리할 수 있도록 돕습니다.

ccusage란?

ccusage는 Claude Code의 사용 내역을 분석해주는 명령줄 도구입니다. Claude Code가 자동으로 생성하는 JSONL 파일을 읽어서 다양한 통계와 리포트를 제공합니다.

주요 특징

• 📊 다양한 분석 리포트: 일일, 월별, 세션별 사용량 분석

• 💰 비용 계산: 모델별 예상 비용 산출

• ⚡ 실시간 모니터링: 현재 세션의 토큰 소모량 실시간 추적

• 🔧 개발자 친화적: JSON, 테이블 등 다양한 출력 형식 지원

설치 및 사용 방법

설치 명령어

# npm
npm install -g ccusage

주요 명령어

일일 리포트

ccusage daily

날짜별 사용량과 예상 비용을 테이블 형태로 보여줍니다:

┌──────────────┬───────────────┬────────┬─────────┬────────────┐
│ Date         │ Models        │ Input  │ Output  │ Cost (USD) │
├──────────────┼───────────────┼────────┼─────────┼────────────┤
│ 2025-06-24   │ • sonnet-3.5  │ 2,156  │ 18,432  │ $15.67     │
│ 2025-06-23   │ • opus-3      │ 1,834  │ 14,521  │ $21.43     │
└──────────────┴───────────────┴────────┴─────────┴────────────┘

월별 리포트

ccusage monthly

월별 사용 패턴과 트렌드를 파악할 수 있습니다.

세션별 분석

ccusage blocks

개별 대화 세션의 토큰 사용량을 상세히 분석합니다.

실시간 모니터링

ccusage blocks --live

현재 진행 중인 세션의 토큰 소모량을 실시간으로 모니터링합니다.
긴 코딩 세션 중에 사용량을 체크하고 싶을 때 유용합니다.

고급 활용법

1. 여러 프로젝트 동시 분석

ccusage daily --data-dirs ./project1/.claude ./project2/.claude

2. JSON 출력으로 자동화

ccusage monthly --json > usage-report.json

3. 특정 기간 필터링

ccusage daily --from 2025-06-01 --to 2025-06-25

ETC

ccusage          
ccusage session  
ccusage daily --breakdown

관련 링크

• ccusage Github 사이트

• ccusage GUDIE

• NPM 패키지