ccusage
코딩 CLI의 토큰·비용을 로컬 기록으로 집계하는 도구
Claude Code를 비롯한 여러 코딩 CLI가 남긴 로컬 사용 기록을 읽어 토큰과 비용을 집계합니다. 일·주·월·세션별 리포트와 Claude의 5시간 과금 창 추적을 내장했고, 네트워크 없이 오프라인으로도 돕니다.
설치 명령어
npx ccusage@latest빠른 시작 · 핵심 명령
npx ccusage@latest daily감지된 CLI들의 일별 사용량·비용을 출력합니다npx ccusage@latest blocksClaude의 5시간 과금 창별 사용량을 추적합니다npx ccusage@latest daily --json사용량을 JSON으로 내보냅니다
차별점
- 여러 코딩 CLI의 사용량을 명령 하나로 모아 봅니다.
- Claude의 5시간 과금 창(blocks) 단위로 끊어, 지금 창에서 얼마나 썼는지 실시간으로 봅니다.
- 로컬 파일만 읽습니다. 사용 데이터를 밖으로 보내지 않고 --offline로 망 없이도 돕니다.
- statusline으로 Claude Code 상태바에 현재 비용을 띄웁니다.
대안과 비교
Claude Code 내장 /cost는 지금 세션 합계만 보여줍니다. ccusage는 쌓인 로컬 이력 전체를 기간·모델별로 쪼개고 JSON으로 빼낼 수 있어, 한 번 보는 용도가 아니라 비용 추세를 쫓는 데 맞습니다. RTK가 비용을 줄이는 도구라면 이쪽은 어디서 새는지 보여주는 도구라, 둘은 짝으로 씁니다.
함께 쓰는 도구 · 대안
셋업 주의
- 파이프나 CI처럼 stdout이 터미널이 아니면 compact 자동 감지가 꺼집니다(v20.0.6에서 정리).
도구 정보
- 라이선스
- MIT
- 런타임
- node
최근 변화
2026-05-29, v20.0.6 — stdout이 터미널이 아닐 때 compact 자동 감지를 건너뛰도록 수정.
관련 영상
큐레이터 노트
한 번 보고 마는 용도가 아니라 비용 추세를 쫓을 때 자리를 찾습니다. 내장 /cost가 지금 세션 합계만 보여준다면, 이쪽은 쌓인 로컬 이력 전체를 기간·모델별로 쪼개고 JSON으로 빼냅니다. 사용 데이터를 밖으로 보내지 않고 오프라인으로 도는 점은, 회사 코드를 다루는 환경에선 무시하기 어려운 조건입니다.
RTK가 비용을 줄이는 쪽이라면 ccusage는 어디서 새는지 보여주는 쪽이라 둘은 경쟁이 아니라 짝입니다. 먼저 줄이고, 줄어든 결과를 여기서 확인하는 순서가 자연스럽습니다.
수치를 절대 기준으로 믿기 전에 알아둘 점이 있습니다. ccusage가 보여주는 사용률이 Claude 공식 화면과 어긋난다는 보고가 있습니다. 한 이슈에서는 공식 화면이 22%일 때 ccusage는 6.9%로 나왔고, 이미 알려진 문제로 중복 처리됐습니다. 추세를 보는 데는 충분하지만 정산용 단일 진실로 쓰긴 이릅니다.