새롭게 개발된 Linux 시스템 트레이 위젯은 작업 표시줄에서 직접 Claude AI 구독 사용량에 대한 실시간 업데이트를 제공합니다. 이 가벼운 도구는 특히 5시간 및 7일 속도 제한 기간을 추적하는 데 유용하며, 색상으로 구분된 피드백을 통해 사용량을 효과적으로 관리할 수 있도록 돕습니다.

주요 세부 사항

• 색상 구분 모니터링: 위젯은 작업 표시줄에 5시간 사용량 백분율을 직접 표시하며, 아이콘 색상이 녹색에서 빨간색으로 변하여 현재 소비량을 빠르게 평가할 수 있습니다.
• 상세 사용량 정보: 작업 표시줄 아이콘을 클릭하면 진행률 표시줄과 재설정 타이머를 사용하여 5시간 및 7일 사용량을 모두 보여주는 상세 창이 열려 한계치를 파악할 수 있습니다.
• 스마트 알림: 위젯은 사용량이 75%, 90%, 100%에 도달할 때 데스크톱 알림을 전송하여 예기치 않은 차단을 방지합니다.
• 자동 설정: Linux에서 Claude Code 자격 증명을 자동으로 감지하며 2분마다 새로고침합니다. 시스템 로그인 시 자동 시작하도록 설정하여 지속적인 모니터링이 가능합니다.

기술 스택

위젯은 Python 3와 GTK3를 사용하여 구축되었으며, 시스템 트레이 기능에는 AppIndicator3를, 아이콘 렌더링에는 Cairo를 활용합니다. 이 도구는 Claude Code가 데이터 검색에 사용하는 동일한 내부 API와 상호 작용합니다.

설치 가이드

# 의존성 설치
sudo apt install python3 python3-gi gir1.2-appindicator3-0.1 gir1.2-notify-0.7

복제 및 설치
git clone https://github.com/StaticB1/claude_ai_usage_widget.git
cd claude_ai_usage_widget
chmod +x install.sh && ./install.sh
위젯 시작
claude-widget-start

이 위젯은 GTK3를 지원하는 모든 Linux 배포판과 호환되도록 설계되었으며, pyenv/conda 충돌을 처리하여 깨끗한 실행 환경을 유지합니다.

위젯은 MIT 라이선스 하에 오픈 소스이며, 커뮤니티의 기여를 GitHub 저장소에서 환영합니다.