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]
[Tool] Herdr · Rust로 작성된 단일 바이너리의 터미널 네이티브 에이전트 멀티플렉서. tmux식 세션 유지와 패널 분할에 에이전트 상태 추적(idle, working, blocked, done)을 더해, Claude Code를 포함한 여러 CLI 에이전트를 한 화면에서 관리합니다. Herdr는 Claude Code를 자동 감지해 직접 통합(direct integration) 설치 프롬프트를 띄우고, 승인하면 풀 상태 감지, 로컬 소켓 API를 통한 시맨틱 상태 전달, 재시작 후 에이전트 세션 복원이 동작합니다.
tool · claudekit.io / tools / herdr
[02]
[Tool] CC Workflow Studio · 캔버스 위에서 AI 에이전트 워크플로를 시각적으로 설계해, Claude Code·Cursor·Copilot 등 에이전트가 바로 실행할 수 있는 Markdown(skills·commands·agents)으로 내보내는 VS Code 익스텐션. MCP 서버가 내장돼 'Edit with AI'로 자연어 수정도 가능.
tool · claudekit.io / tools / cc-wf-studio
[03]
[Skill] Find Skills · 사용자가 "X 하는 방법 알려줘" 같은 질문을 하면 자동 활성화되어, 오픈 에이전트 스킬 생태계에서 적합한 스킬을 검색·설치하도록 안내하는 메타 스킬.
tool · claudekit.io / tools / find-skills
§ 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시간 블록별 사용량 모니터링으로 한도 초과 방지, 세션별 토큰 소비 비교로 효율적 프롬프팅 전략 수립에 적합합니다.