Claude Code 사용량 모니터 – 사용량 제한 회피를 위한 실시간 트래커

5 hours ago 1

Claude 세션 이해하기

5시간 롤링 윈도우 방식
- 최초 메시지를 보낸 시점부터 세션 5시간 유지
- 세션별 한도 적용, 복수 동시 활성화 가능
- 실제 리셋은 내 메시지 기준 매 5시간마다 발생
세션/토큰 리셋 시간 기준을 내 스케줄에 맞게 지정 가능

세션 시작과 동시에 모니터링 시작
- Claude 작업을 시작할 때 즉시 모니터 실행 (./ccusage_monitor.py)
- 지원 플랜
  - pro: 약 7,000 토큰(테스트 및 경량 사용)
  - max5: 약 35,000 토큰(일상적 개발)
  - max20: 약 140,000 토큰(대형 프로젝트 및 중/고강도 사용)
  - custom_max: 자동 감지 모드(실제 사용 이력 기준 최대값 사용)
- 세션 전체 토큰 추적 정확도 향상
- 토큰 소모 속도 계산과 한도 임박 조기 경고 가능
Python 가상환경(venv) 사용
- 의존성 충돌 방지, 환경 분리, 프로젝트별 재현성 보장
- 설치 및 실행: python3 -m venv venv source venv/bin/activate pip install pytz
- 삭제 시 가상환경 폴더만 지우면 깨끗한 제거 가능
쉘 Alias 커스텀 등록
- 반복적인 명령을 한 줄로 단축 실행 alias claude-monitor='cd ~/Claude-Code-Usage-Monitor && source venv/bin/activate && ./ccusage_monitor.py'
- .bashrc 또는 .zshrc 등에 추가, 한 번 입력으로 곧바로 모니터 실행 가능

Burn Rate(소모 속도) 상시 모니터링
- 토큰 사용량이 갑자기 치솟는 경우 주의
- 남은 시간·토큰량에 따라 작업 강도 조절
- 세션 리셋(토큰 초기화) 전후로 대규모 리팩터링 등 큰 작업 일정 조정
전략적 세션 스케줄링
- 대규모 작업은 토큰 리셋 직후 시작, 한도 임박 시에는 가벼운 작업 수행 ./ccusage_monitor.py --reset-hour 9
- 세션별 5시간 규칙을 활용해 여러 세션 중첩 운영 가능
타임존 명확히 지정
- 실제 근무/협업 시간대 반영하여 정확한 토큰 리셋 예측 및 일정 관리 ./ccusage_monitor.py --timezone Asia/Seoul
- 여러 국가·팀과 협업 시 시간 오차 방지, 세션 만료 시점 혼동 최소화

터미널 환경 세팅
- 최소 80자 너비 터미널 권장
- 컬러 지원으로 시각적 피드백 극대화
- 별도 전용 창에서 상시 모니터링 추천
워크플로우 통합
- tmux 등 터미널 멀티플렉서 활용해 개발과 동시에 모니터링 가능 tmux new-session -d -s claude-monitor './ccusage_monitor.py' tmux attach -t claude-monitor
멀티 세션 전략
- 세션별로 5시간 고정, 중첩 세션 동시 관리 가능
- 긴 작업은 여러 세션에 분산, 각 세션 한도/만료 주의

대형 프로젝트 개발 ./ccusage_monitor.py --plan max20 --reset-hour 8 --timezone America/New_York
- 오전 8시 토큰 리셋 → 주요 기능 개발 시작
- 10시 Burn Rate 점검 후 작업 속도 조절
- 12시 오후 일정 점검 및 조율
- 14시 새 세션 오픈, 복잡한 이슈 처리
- 16시 가벼운 작업/저녁 세션 준비
러닝/실험 중심 사용 ./ccusage_monitor.py --plan pro
- 가벼운 학습, 실험적 코드 작성에 적합
스프린트 집중 개발 ./ccusage_monitor.py --plan max20 --reset-hour 6
- 집중적인 대량 토큰 소모가 예상되는 개발에 맞춤 설정