실시간 데스크톱 오버레이로 Claude 코드 사용 제한 모니터링

새로운 오픈소스 도구를 통해 개발자들은 실시간 데스크톱 오버레이로 Claude Code 사용량 제한을 모니터링할 수 있습니다. 항상 최상위에 표시되도록 제작된 이 위젯은 /usage 명령어를 수동으로 실행하지 않고도 세션 및 주간 사용량을 즉시 확인할 수 있게 해줍니다.

주요 세부사항

• 세션 및 주간 추적: 5시간 창 내에서 현재 세션 사용량(재설정 시간 포함)을 표시하며, 모든 모델에 대한 주간 사용량과 Sonnet 전용 사용량을 추적합니다.
• 알림: 사용량 막대가 제한에 가까워지면 빨간색으로 변하며 깜빡여, 사용 중 제한에 도달하는 것을 피할 수 있도록 명확한 시각적 경고를 제공합니다.
• 맞춤 설정: 위젯은 드래그 가능하며 화면 어디에나 배치할 수 있고, 사이버펑크 라이트/다크 모드 전환을 지원합니다. 또한 시스템 트레이를 통해 불투명도 조절 기능을 갖추고 있습니다.
• 지속성 및 새로 고침: 세션 간 위치를 기억하며, 최신 정보를 제공하기 위해 5분마다 자동으로 새로 고침됩니다.
• 기술적 구현: Electron과 node-pty를 사용하여 Claude Code의 /usage 명령어를 의사 터미널 내에서 실행하며, API 키 없이 기존 인증을 활용합니다.
• 플랫폼 지원: 현재 Windows 11에서 사용 가능하며, macOS와 Linux에 대한 커뮤니티 기여 기회가 열려 있습니다.

설정

설치는 간단합니다: 저장소를 복제하고, npm install을 실행한 다음 npm start를 실행하세요. 또는 Windows 사용자는 start.bat 파일을 더블클릭할 수 있습니다. 이 도구는 MIT 라이선스로 제공되어 무료로 영구히 사용할 수 있습니다.