claudekit / tools / ccusage
[ Tool · Claude Code Utilities ]

ccusage

Claude Code의 토큰 사용량과 비용을 일일/월간/세션별로 분석하는 CLI 도구.

ryoppippi/ccusage ·updated
$ npx ccusage@latest copy

왜 필요한가?

Claude Code를 사용하면서 토큰을 얼마나 소비하고 있는지, 비용이 얼마인지 파악하기 어렵습니다. ccusage는 로컬 JSONL 파일을 분석하여 일일/월간/세션별 토큰 사용량과 비용을 한눈에 보여줍니다.

주요 기능

  • 다양한 리포트 — 일일, 주간, 월간, 세션별, 5시간 청구 윈도우별 분석
  • 모델별 추적 — Opus, Sonnet 등 사용 중인 모델별 토큰 소비 확인
  • 비용 계산 — USD 기준 일일/월간/세션별 비용 추적
  • 캐시 토큰 분리 — 캐시 생성과 캐시 읽기 토큰을 별도로 추적
  • JSON 출력 — 구조화된 데이터로 내보내기 가능
  • MCP 서버 통합 — MCP 서버로도 사용 가능

Before / After

Before: 토큰을 얼마나 썼는지 모름 → 5시간 블록 한도 초과 → 비용 예측 불가

After: npx ccusage@latest 한 줄로 일일/월간 사용량, 모델별 비용, 세션별 소비 패턴 즉시 확인

실제 사용 시나리오

  1. 월간 토큰 사용량과 비용을 확인하여 예산 관리
  2. 5시간 블록별 사용량을 모니터링하여 한도 초과 방지
  3. 세션별 토큰 소비를 비교하여 효율적인 프롬프팅 전략 수립
§ 5

See also

same category · curated
[01]
[Plugin] fluent-korean · Claude Code가 조사와 어미를 생략한 축약형 한국어 대신 의미가 분명한 문장을 출력하도록 지시하는 output-style 플러그인. 결과를 고치는 것이 아니라 시스템 프롬프트 층위에서 미리 규율합니다. 코딩 지침을 유지하는 판과 제거한 판 두 가지를 제공합니다.
tool · claudekit.io / tools / fluent-korean
[02]
[Tool] OpenViking · 에이전트의 메모리, 참고 자료, 스킬을 하나의 가상 파일시스템에 모아 두는 오픈소스 컨텍스트 데이터베이스. Claude Code에 플러그인으로 연결하면 세션이 끝나도 남는 장기 기억과 자료 검색이 생깁니다.
tool · claudekit.io / tools / openviking
[03]
[Tool] Herdr · Rust로 작성된 단일 바이너리의 터미널 네이티브 에이전트 멀티플렉서. tmux식 세션 유지와 패널 분할에 에이전트 상태 추적(idle, working, blocked, done)을 더해, Claude Code를 포함한 여러 CLI 에이전트를 한 화면에서 관리합니다. Herdr는 Claude Code를 자동 감지해 직접 통합(direct integration) 설치 프롬프트를 띄우고, 승인하면 풀 상태 감지, 로컬 소켓 API를 통한 시맨틱 상태 전달, 재시작 후 에이전트 세션 복원이 동작합니다.
tool · claudekit.io / tools / herdr
§ 6

자주 묻는 질문

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