Ccusage
lastmod 2026-11-16created 2026-02-123 edits
ccusage는 코딩 에이전트 CLI 가 로컬에 남긴 사용 기록을 읽어 토큰 사용량과 비용을 집계하는 명령줄 도구이다. Claude Code, Codex, OpenCode, Amp, Gemini CLI, GitHub Copilot CLI 등 19개 도구의 기록을 찾아 일·주·월·세션 단위 보고서로 보여 준다. 계정 연동 없이 이미 디스크에 있는 기록만 읽고, 비용은 모델별 API 가격으로 환산해 보여 준다.
About
- 설치 없이
npx ccusage@latest로 실행함.bunx,pnpm dlx, Nix 로도 실행 가능 -
daily,weekly,monthly,session보고서. 도구 이름을 붙이면(ccusage claude daily) 그 도구만 집계함 -
blocks명령은 Claude 의 5시간 청구 구간 단위로 사용량을 보여 줌. Claude Code 상태 표시줄용statusline명령(베타)도 있음 - 모델별 비용 분해(
--breakdown), 기간 필터(--since/--until,--last 1), JSON 출력 - Claude Code 기록은 프로젝트·인스턴스별로 묶어 볼 수 있음 (
--instances,--project) - 비용은 LiteLLM 가격표로 계산함.
--offline이면 미리 받아 둔 가격표를 쓰고, 모델별 가격은ccusage.json에서 덮어쓸 수 있음 - MIT 라이선스