richhickson/claudecodeusage

해결하는 문제

Claude Usage는 Claude Code CLI 도구 사용자가 사용 제한을 관리하고 세션 상태를 최신 상태로 유지할 수 있도록 설계된 macOS 메뉴바 앱입니다. 사용 할당량을 수동으로 확인하거나 AI 에이전트 세션에서 사용자 입력 또는 권한이 필요할 때 알림을 놓치는 문제를 해결합니다.

작동 방식

이 앱은 macOS Keychain에서 OAuth 자격 증명을 읽어 Anthropic의 사용량 API를 쿼리합니다. 세션 알림을 제공하기 위해 Claude Code의 hooks 시스템을 활용하며, 세션 상태(작업 중, 주의 필요, 완료)를 로컬 JSON 파일에 기록하는 작은 셸 스크립트를 설치하여 앱이 이를 모니터링합니다.

대상 사용자

macOS에서 Claude Code CLI를 사용하며, 토큰 제한을 실시간으로 시각화하여 확인하고 AI 코딩 세션에서 주의가 필요할 때 알림을 받고 싶은 개발자.

주요 특징

• 사용량 추적: 세션, 주간 및 모델별 제한을 모니터링하며 색상으로 구분된 상태 표시기(녹색, 노란색, 빨간색)와 초과 사용량을 추적합니다.
• 세션 알림: 세션에 입력이 필요할 때 macOS 알림과 메뉴바 벨을 제공하며, '클릭하여 포커스' 기능을 통해 특정 터미널 탭으로 바로 이동할 수 있습니다.
• Claude 상태: status.claude.com의 장애 알림을 통합합니다.
• Claude Code 구성: 전역 CLAUDE.md 파일용 내장 편집기와 대화 보존 설정을 포함합니다.
• 경량: 네이티브 Swift로 구축되어 리소스 사용을 최소화합니다.