클로드 코드 할당량을 위한 윈도우 시스템 트레이 모니터

한 개발자가 Claude Code 사용량 할당을 실시간으로 모니터링하는 Windows 시스템 트레이 애플리케이션을 구축했습니다. 이 도구는 코딩 세션 중 수동으로 사용량 제한을 확인해야 하는 불편함을 해결합니다.

핵심 기능

이 애플리케이션은 다음과 같은 주요 모니터링 기능을 제공합니다:

• 색상 구분 트레이 아이콘: 녹색(0-50% 사용량) → 주황색 → 빨간색 → 진한 빨간색 → 100%에서 회색
• 오른쪽 클릭 컨텍스트 메뉴: 세션 백분율(5시간), 주간 백분율(7일), 재설정까지 남은 시간 표시
• 자동 새로 고침: 공식 Anthropic OAuth API를 사용하여 5분마다 업데이트
• 폴백 메커니즘: API에서 속도 제한될 경우 캐시된 데이터 사용
• 데스크톱 알림: 85% 및 90% 사용량 임계값에서 경고

대시보드 구성 요소

브라우저 기반 대시보드에는 상세한 분석을 위한 네 개의 탭이 포함됩니다:

• 오늘: 시간별 막대 그래프, 어제 대비 토큰 비교, 활성 세션
• 이번 주: 일별 막대 그래프, 최고 사용일 식별, 일일 평균
• 이번 달: 현재 월 분석을 위한 동일한 구조
• 전체 기간: 80%/95% 임계값이 있는 할당량 추세 차트, 상위 세션, 전체 통계

기술적 세부 사항

이 애플리케이션에는 특정 기술 요구 사항과 구현 세부 사항이 있습니다:

• 데이터 소스: 토큰 데이터는 로컬 ~/.claude/projects/*.jsonl 파일에서 가져옴
• 개인정보 보호: 할당량 백분율 호출만 Anthropic API로 전송되며, 다른 모든 데이터는 로컬에 유지됨
• 요구 사항: Windows 10/11, PowerShell 5.1(사전 설치됨), Claude Code 로그인 상태
• 종속성 없음: Node.js 또는 추가 설치가 필요하지 않음

설정 과정

설치는 간단합니다:

• GitHub에서 ZIP 다운로드: https://github.com/edi19863/claude-usage-tray
• start.vbs를 더블 클릭하여 실행
• 로그인 시 자동 실행을 위해 setup-autostart.bat 실행

개발자는 Ko-fi를 통해 지원을 받습니다: https://ko-fi.com/edi1986