jens-duttke/usage-monitor-for-claude

해결하는 문제

Claude Usage Monitor는 사용자가 Claude의 레이트 제한을 실시간으로 추적할 수 있도록 해주는 시스템 트레이 애플리케이션입니다. 이는 claude.ai, Claude Code, VS Code 및 JetBrains IDE 확장과 같은 다양한 인터페이스에서 세션 및 주간 할당량(Sonnet, Opus, Fable 등 모델용)이 얼마나 남아 있는지 알 수 없어 발생하는 문제를 해결합니다.

작동 방식

애플리케이션은 로컬에 저장된 기존의 Claude Code 로그인(OAuth 토큰)을 사용하여 인증합니다. Anthropic API를 주기적으로 요청하여 현재 사용량 데이터를 가져와 네이티브 트레이 아이콘과 진척 막대, 상세 팝업을 통해 표시합니다. 자원 절약을 위한 적응형 폴링, claude update를 통한 자동 토큰 갱신, 다른 설정 디렉터리를 사용해 별도 인스턴스를 실행함으로써 다중 계정을 지원합니다.

대상 사용자

Claude Code 또는 기타 Claude 통합 IDE 확장 기능을 사용하는 Claude 구독자(Pro, Max, Team, Enterprise) 중, 작업 흐름 중 예기치 않게 레이트 제한에 도달하는 것을 방지하고자 하는 사용자에게 적합합니다.

주요 기능

• 초기 설정 없음: 수동 API 키가 필요 없으며, Claude Code 로그인을 통해 자동 인증.
• 실시간 모니터링: 사용자 정의 가능한 진척 막대가 있는 실시간 트레이 아이콘과 계정 정보 및 리셋 카운트다운을 표시하는 상세 팝업 제공.
• 스마트 알림: 사용량이 경과 시간보다 빠를 때 또는 할당량이 재충전될 때 사용자에게 알림을 설정 가능.
• 이동성과 경량성: Windows용은 설치 없이 사용 가능한 단일 EXE 파일, Linux용은 소스에서 실행 가능한 애플리케이션 제공.
• 이벤트 명령어: 할당량이 재충전되거나 임계값을 초과할 때 사용자 정의 쉘 명령어 실행 가능.
• 다중 계정 지원: 별도의 설정 디렉터리를 사용해 여러 Claude 계정을 동시에 모니터링 가능.