💡
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시간 블록별 사용량을 모니터링하여 한도 초과 방지
- 세션별 토큰 소비를 비교하여 효율적인 프롬프팅 전략 수립
자주 묻는 질문
ccusage는 무엇인가요?
Claude Code의 로컬 JSONL 세션 파일을 분석해 일일·주간·월간·세션별·5시간 청구 윈도우별 토큰 사용량과 비용을 보여주는 CLI 도구입니다.
어떤 환경에서 동작하나요?
Claude Code 사용 환경에서 동작합니다.
어떻게 설치하나요?
`npx ccusage@latest` 한 줄로 즉시 실행 가능합니다.
주요 기능은 무엇인가요?
다양한 리포트(일일·주간·월간·세션·5시간 청구 윈도우), 모델별 토큰 추적(Opus·Sonnet 등), USD 기준 비용 계산, 캐시 생성·캐시 읽기 토큰 분리, JSON 출력, MCP 서버 통합을 제공합니다.
어떤 작업에 적합한가요?
월간 토큰 사용량과 비용으로 예산 관리, 5시간 블록별 사용량 모니터링으로 한도 초과 방지, 세션별 토큰 소비 비교로 효율적 프롬프팅 전략 수립에 적합합니다.