# ccusage - Claude Code/Codex 사용량 분석용 CLI 도구

> Clean Markdown view of GeekNews topic #26561. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=26561](https://news.hada.io/topic?id=26561)
- GeekNews Markdown: [https://news.hada.io/topic/26561.md](https://news.hada.io/topic/26561.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2026-02-10T13:03:35+09:00
- Updated: 2026-02-10T13:03:35+09:00
- Original source: [github.com/ryoppippi](https://github.com/ryoppippi/ccusage)
- Points: 10
- Comments: 0

## Summary

Claude Code와 Codex의 토큰 사용량을 로컬 로그 기반으로 분석하는 CLI 도구입니다. 일·월·세션 단위 요약과 **모델별 추적 기능**을 통해 비용 흐름을 한눈에 파악할 수 있으며, 컬러 테이블 출력과 반응형 레이아웃으로 콘솔에서도 가독성이 좋습니다.

## Topic Body

- **클로드 코드** 및 **코덱스**의 토큰 사용량과 비용을 빠르게 분석하기 위해 개발  
- 로컬 JSONL 로그를 기반으로 **일별·월별·세션별 사용량**을 요약해서 시각적으로 볼수 있게 제공  
- **컬러 테이블 기반 출력**과 **자동 반응형 레이아웃** 지원, JSON 데이터 내보내기 가능  
- **모델별 추적 기능**을 통해 Claude Opus, Sonnet 등 모델별 사용량 구분  
- 기간별 사용량 조회, 날짜 범위 필터링  
- **5시간 단위 블록 리포트**로 Claude의 청구 주기별 사용량 모니터링도 지원  
- Claude Code 상태 표시줄에 실시간 사용량 표시 가능   
- **MCP(Model Context Protocol)** 서버 내장하여 외부 도구와 실시간 연동 지원  
- **프로젝트 단위 그룹화** 및 여러 인스턴스별 사용량 비교 가능  
- 설치 없이 `npx ccusage@latest` 명령만으로 즉시 실행 가능  
- **[@ccusage/opencode](https://www.npmjs.com/package/@ccusage/opencode)**, **[@ccusage/pi](https://www.npmjs.com/package/@ccusage/pi)**, **[@ccusage/amp](https://www.npmjs.com/package/@ccusage/amp)** 등 확장 패키지를 통해 다양한 AI 코드 환경의 사용량 분석 지원  
- MIT 라이선스

## Comments



_No public comments on this page._