Claude Code 사용량, 실제로 얼마나 되나 — ccusage로 재보기

Claude Code는 코드 생성과 이해 능력이 좋아 생산성에 확실히 보탬이 된다. 그런데 본격적으로 쓰려고 하면 곧 사용량 제한이라는 벽에 부딪힌다.

한도의 구조

Claude의 대화형 서비스는 일정 시간 안에 쓸 수 있는 메시지(토큰) 양에 제한을 둔다. 대규모 프로젝트나 복잡한 코드 작업을 하다 보면 금방 한도에 닿는다. 그래서 앤트로픽은 사용량을 더 주는 Claude Code Max 같은 유료 구독을 제공한다.

사용자들에 따르면 Max 요금제는 5시간마다 한도가 초기화되는 방식이다. 그런데 월 $100 요금제를 쓰더라도 집중적으로 쓰면 3시간 만에 한도에 도달한다. 사용량이 많은 사람에게는 이마저 부족하게 느껴진다. 결국 월 $200으로 올리게 되고, 이는 상당한 비용 부담이 된다.

여기서 자연스럽게 궁금해진다. 고정 요금제 대신 쓴 만큼 내는 API 방식이었다면 비용이 얼마였을까?

ccusage로 확인하기

그 궁금증을 풀어 주는 서드파티 유틸리티가 ccusage다. 오픈소스로 공개돼 있고, Claude Code의 사용량을 추적·분석해 실제 비용을 가늠하게 해 준다.

GitHub 저장소: ryoppippi/ccusage

터미널에서 간단한 명령어로 일별·월별·세션별 사용량을 볼 수 있어, 자기 코딩 패턴과 사용량을 객관적인 데이터로 파악할 수 있다.

설치

npm install -g ccusage

기본 사용법 (일일 리포트)

ccusage

기간별 리포트

# 일별 토큰 사용량 및 비용
ccusage daily

# 월별 집계 리포트
ccusage monthly

세부 분석

# 대화 세션별 사용량
ccusage session

# 5시간 단위 과금 기간별 사용량
ccusage blocks

실시간 모니터링 및 기타 옵션

# 실시간 사용량 대시보드
ccusage blocks --live

# 기간 지정 (예: 2025년 5월 25일부터 30일까지)
ccusage daily --since 20250525 --until 20250530

# JSON 형태로 출력
ccusage daily --json

그래서 얼마가 나왔나

ccusage 같은 도구를 쓰면 월 $200이라는 고정 비용이 나에게 합리적인지, 아니면 API 종량 과금이 유리한지 판단할 근거가 생긴다. 환산 비용이 $100 미만이면 지금 구독이 과하다고 보고 패턴을 조절할 수 있고, $200을 훌쩍 넘으면 Max 요금제가 오히려 비용 효율적이라는 확인이 된다.

6월 내 사용량을 확인해 보니 $1,379가 나왔다. 캐시까지 고려한 금액이라고 하니, $200 Max 요금제가 아니었다면 7배의 비용이 들었을 것이다.

Claude Code는 분명 강력한 도구다. 다만 그 가치를 제대로 쓰려면 자기 사용 패턴을 정확히 파악하고 그에 맞는 비용 전략을 세우는 것이 중요하다.