💡
Claude Code의 토큰 사용량과 비용을 일일/월간/세션별로 분석하는 CLI 도구.
✨
토큰 사용량/비용 분석 경험 개선
설치 방법 · npx
$
npx ccusage@latest 왜 필요한가?
Claude Code를 사용하면서 토큰을 얼마나 소비하고 있는지, 비용이 얼마인지 파악하기 어렵습니다. ccusage는 로컬 JSONL 파일을 분석하여 일일/월간/세션별 토큰 사용량과 비용을 한눈에 보여줍니다.
주요 기능
- 다양한 리포트 — 일일, 주간, 월간, 세션별, 5시간 청구 윈도우별 분석
- 모델별 추적 — Opus, Sonnet 등 사용 중인 모델별 토큰 소비 확인
- 비용 계산 — USD 기준 일일/월간/세션별 비용 추적
- 캐시 토큰 분리 — 캐시 생성과 캐시 읽기 토큰을 별도로 추적
- JSON 출력 — 구조화된 데이터로 내보내기 가능
- MCP 서버 통합 — MCP 서버로도 사용 가능
Before / After
Before: 토큰을 얼마나 썼는지 모름 → 5시간 블록 한도 초과 → 비용 예측 불가
After: npx ccusage@latest 한 줄로 일일/월간 사용량, 모델별 비용, 세션별 소비 패턴 즉시 확인
실제 사용 시나리오
- 월간 토큰 사용량과 비용을 확인하여 예산 관리
- 5시간 블록별 사용량을 모니터링하여 한도 초과 방지
- 세션별 토큰 소비를 비교하여 효율적인 프롬프팅 전략 수립