ccusage 사용법 요약

ccusage는 Claude Code의 토큰 사용량과 비용을 로컬 JSONL 파일로 빠르게 분석하는 CLI 도구입니다...

1. 실행 방법

추천: 설치 없이 바로 실행하기

• bunx 사용(가장 빠름)

  bunx ccusage

• npx 사용

  npx ccusage@latest

• deno 사용

  deno run -E -R=$HOME/.claude/projects/ -S=homedir -N='raw.githubusercontent.com:443' npm:ccusage@latest

  ※ bunx → npx → deno 순서로 속도가 빠릅니다.

(선택) 글로벌 설치

npm install -g ccusage

이후

ccusage

로 명령 실행

2. 주요 명령어

기본 사용법

• 일일 보고서 (기본값)

  ccusage

  또는

  ccusage daily

• 월별 집계

  ccusage monthly

• 세션별 사용량

  ccusage session

• 5시간 청구 블록별 집계

  ccusage blocks

실시간 모니터링

• 블록별 실시간 대시보드

  ccusage blocks --live

필터와 옵션

• 특정 기간 추출

  ccusage daily --since 20250525 --until 20250530

• JSON 출력

  ccusage daily --json

• 모델별 비용 상세

  ccusage daily --breakdown

3. 주요 기능 요약

• 일/월/세션/5시간 단위 토큰 사용량, 비용 확인

• 실시간 사용량, 토큰 번 레이트, 예측 비용 대시보드 (--live)

• Claude 모델별 집계 및 상세 breakdown

• 날짜 범위 필터 (--since, --until)

• JSON/표 형태 출력 (터미널에 맞게 가독성 자동 조정)

• 오프라인 모드 지원

• ultra-small 번들 크기, 설치 없이 빠르게 실행

• MCP(Model Context Protocol) 연동 지원

4. 공식 문서

더 자세한 사용법은 ccusage.com 참고

5. 기타

• 소스: GitHub - ryoppippi/ccusage

• 라이선스: MIT

• CLAUDE.jsonl 경로 등 커스텀 데이터 폴더 지정 가능

예시

Fastest 실행:

bunx ccusage daily --breakdown --since 20240601 --until 20240630

=> 6월 한 달간 Claude 코드별, 모델별 토큰 및 비용 상세 표 출력

정리

npx ccusage 입력하면 다음과 같이 나옴!