ccusage로 쉽게 확인하는 클로드 코드 사용량과 비용 관리법

클로드 코드(Claude Code)를 사용하다 보면 토큰 사용량과 비용이 얼마나 발생하는지 궁금할 때가 많습니다. 특히 개발자라면 로컬에 저장된 로그 파일을 기반으로 간편하게 사용량을 분석하고 싶을 텐데요. 이때 추천하는 도구가 ccusage입니다.

ccusage는 클로드 코드의 JSONL 형식 로그를 읽어 일별, 월별, 세션별 사용량과 비용을 빠르게 계산해 주는 경량 CLI 도구입니다. 설치 없이도 실행할 수 있으며, 실시간 모니터링 기능까지 지원해 효율적인 토큰 관리가 가능합니다.

ccusage 설치 및 실행 방법

별도 설치 없이 실행또는입력만으로 바로 실행할 수 있어 간편합니다.
bash

bunx ccusage daily
bash

npx ccusage@latest daily
글로벌 설치 후 사용이렇게 하면 시스템 어디서나 ccusage 명령을 쓸 수 있습니다.
bash

npm install -g ccusage ccusage daily

주요 명령어와 옵션

명령어설명

ccusage 또는 ccusage daily	기본 일별 사용량 및 비용 보고서 출력
ccusage monthly	월별 사용량 및 비용 집계
ccusage session	세션별 사용량 그룹화
ccusage blocks	5시간 청구 블록별 토큰 사용량 집계
ccusage blocks --live	실시간 블록 단위 사용량 대시보드 보기
ccusage daily --since YYYYMMDD --until YYYYMMDD	특정 기간 사용량 필터링
ccusage daily --json	일별 사용량을 JSON 포맷으로 출력
ccusage daily --breakdown	모델별 비용 상세 분석

주요 특징

다양한 기간별 보고서: 일, 월, 세션 단위로 토큰 사용량과 비용을 세밀하게 보고할 수 있습니다.
실시간 모니터링: 5시간 단위의 청구 블록별 사용량을 실시간으로 확인해 토큰 한도 관리에 유용합니다.
비용 환산 지원: 사용한 토큰 수를 기준으로 USD 비용을 계산해 경제적인 비용 관리에 도움을 줍니다.
모델별 분석: Opus, Sonnet 등 모델 별 사용량과 비용을 세분화해 분석할 수 있습니다.
JSON 출력: JSON 형식으로 결과를 출력해 다른 툴과 연동하거나 자동화에 활용할 수 있습니다.
로컬 로그 분석: 클라우드 접속 없이 로컬에 저장된 로그 파일을 직접 읽어 분석합니다.

실시간 사용량 모니터링 예시

실시간으로 토큰 사용률과 비용을 보고 싶다면 다음 명령을 사용하세요.

bash

ccusage blocks --live

이 명령은 현재 청구 블록에서 소모 중인 토큰과 예상 비용, 세션 토큰 소모 속도를 실시간으로 보여줍니다. 토큰 한도 임박 시점을 예측해 사전에 대응할 수 있습니다.

마치며

ccusage는 클로드 코드 사용량과 비용을 손쉽고 정확하게 파악할 수 있는 필수 도구입니다. 설치가 간편하고 주요 기능을 CLI 명령어로 바로 사용할 수 있어 개발 환경에 최적화되어 있습니다. 토큰 관리와 비용 최적화를 고민하는 사용자라면 꼭 한번 사용해 보시길 추천합니다.

추가 질문하기

소스 확인

728x90

저작자표시 변경금지 (새창열림)