leeguooooo/claude-code-usage-bar

해결하는 문제

Claude Code는 레이트 제한, 컨텍스트 창 사용량, 프롬프트 캐시 상태에 대한 세부적인 실시간 가시성을 제공하지 않습니다. 이 프로젝트는 잔여 할당량과 리셋 시점을 확인하기 위해 창이나 컨텍스트를 전환할 필요 없이 바로 확인할 수 있도록 합니다.

작동 방식

Claude Code의 statusLine에 직접 통합되어 터미널에 표시되거나, macOS 데스크톱 앱용 플로팅 HUD로 제공됩니다. 공식 5시간 및 7일 레이트 제한을 추적하고, 현재 모델과 컨텍스트 창의 사용률을 모니터링하며, 프롬프트 캐시의 '따뜻함' 지속 시간을 계산한 카운트다운을 제공합니다. 1초마다 데이터를 갱신하면서도 낮은 CPU 사용률(1% 미만)을 유지할 수 있는 가벼운 데몬 모드로 실행 가능합니다.

대상 사용자

Claude Code 또는 Claude 데스크톱 앱을 사용하며 API 사용량과 세션 상태를 즉시 확인할 수 있는 실시간 대시보드를 원하는 개발자 및 고급 사용자.

주요 기능

• 공식 레이트 추적: 5시간/7일 사용량 바와 리셋 카운트다운, 윈도우 종료 예측 표시.
• 캐시 모니터링: 프롬프트 캐시가 '따뜻함'을 유지하는 시간을 보여주는 카운트다운 타이머 포함.
• 이중 인터페이스: 터미널 상태줄과 macOS 플로팅 HUD 모두 지원.
• 사용자 정의 시각 효과: 3가지 스타일과 9가지 테마로 상태바 외관을 변경 가능.
• 낮은 부하: 선택적 데몬 모드로 CPU 영향 최소화.
• 의존성 없는 설치: 사전 빌드된 바이너리 또는 Python 패키지로 제공.