콘텐츠로 이동
Search

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 라이선스

See also

Favorite site

author Zer0, MCPBot sitemap