라이브로 클로드 코드 사용량 확인 가능한 ccusage.. MCP로도 사용 가능
- ccusage는 클로드 코드 사용자들이 세션 길이, 사용량, 남은 토큰을 실시간으로 확인할 수 있게 돕는 툴입니다. 📊
- bunx를 통해 설치하며,
bunx ccusage 명령어로 일별 토큰 사용량, 모델별 인풋/아웃풋 토큰, 캐시 사용량, 총 비용 등을 확인할 수 있습니다. 📈
--since와 --until 플래그를 사용하여 특정 기간의 데이터를 조회할 수 있으며, --breakdown 옵션으로 모델별 상세 사용량과 예상 비용을 분석할 수 있습니다. 📅
monthly 명령어로 월별 사용량을, session 명령어로 개별 세션(실행)별 토큰 사용량, 비용, 시간을 상세하게 파악할 수 있습니다. 🔍
- 특히
session 기능은 Worktree와 연동 시 특정 이슈 해결에 소요된 토큰을 정확히 추적하여 공수 파악에 유용합니다. 🧩
blocks 명령어를 통해 클로드 코드의 5시간 윈도우 블록별 사용 현황(남은 시간, 현재 사용량, 예상 사용량)을 확인할 수 있습니다. ⏳
blocks --live 명령어로 현재 블록의 상태를 1초마다 실시간으로 모니터링할 수 있어, 토큰 소진 현황과 블록 리셋 시점을 파악하는 데 매우 효과적입니다. ⚡
- MCP(Multi-Client Proxy) 기능을 통해
ccusage 서버를 실행하고 클로드 코드와 연동하여 개발 과정에서 토큰 사용량을 질의하고 분석할 수 있습니다. 💻
- 이 툴은 클로드 코드의 토큰 사용량과 비용을 투명하게 관리하고, 효율적인 개발 워크플로우를 구축하는 데 큰 도움을 줍니다. ✅