f-is-h/Usage4Claude

Monitor all your Claude/Codex usage limits in real-time from your macOS menu bar - supports 5-hour, 7-day, extra usage, 7-day Opus and 7-day Sonnet quotas.

Usage4Claude – Claude(및 선택적 Codex) 사용량을 실시간으로 모니터링하는 macOS 메뉴바 앱

무엇인가요 – Swift/SwiftUI로 작성된 네이티브 macOS 유틸리티로, Anthropic Claude 구독(무료, Pro, Team, Max)의 사용량을 실시간으로 표시합니다. OpenAI Codex 크레딧도 추적할 수 있습니다. 모든 데이터는 로컬에만 저장되며, 서버로 전송되지 않습니다.

왜 사용하고 싶을까 – Claude의 사용 제한은 여러 범주(5시간, 7일, 추가 사용, 모델별 제한(Opus, Sonnet 등))로 나뉩니다. 이를 감시하면 예기치 않은 차단을 피할 수 있으며, 특히 웹, CLI, 데스크톱, 모바일, Cowork 에이전트 등 여러 Claude 접근점에서 작업할 때 유용합니다. 앱은 메뉴바에 컴팩트한 시각적 인디케이터를 표시하며, 사용량이 90%에 도달하거나 할당량이 리셋될 때 색상 기반 경고 및 옵션 알림을 제공합니다.

핵심 기능 (README에 기술됨)

실시간 모니터링 – 모든 Claude 할당량 유형과 선택적 Codex 크레딧을 실시간으로 모니터링.
스마트 표시 모드 – 자동으로 표시할 제한을 선택합니다. 원하는 조합을 수동으로 선택할 수도 있습니다.
적응형 리프레시 – 사용 중일 때는 빠르게, 사용하지 않을 때는 느리게(1분 → 3분 → 5분 → 10분) 조절하는 4단계 '스마트' 시스템. 고정 간격 모드도 제공됩니다.
다중 계정 지원 – 여러 Claude 계정(각 계정에 여러 조직 포함)과 별도의 Codex 계정을 저장 가능하며, 메뉴에서 즉시 전환 가능.
사용자 정의 UI – 퍼센트만, 아이콘만, 또는 아이콘 + 퍼센트 선택 가능. 라이트, 다크, 시스템 외관 선택 가능. 12시간/24시간 형식 설정 가능.
사용량 알림 – 할당량의 90%에 도달했을 때 및 할당량이 리셋되었을 때 macOS 알림 제공.
내장 브라우저 로그인 – 임베디드 브라우저를 열어 Claude 또는 ChatGPT에 로그인하고, 필요한 세션 키/토큰을 자동으로 추출합니다. Claude의 경우 수동으로 세션 키를 붙여넣을 수도 있습니다.
로컬 전용 저장 – 자격 증명은 macOS Keychain에 저장되며, 기타 설정은 로컬 파일에 저장됩니다. 태레메트리 없음.
접근성 – 웹, Claude Code CLI, 데스크톱 앱, 모바일 앱, Cowork 에이전트 등 모든 Claude 제품이 동일한 할당량을 공유하므로, 어떤 제품에서도 작동합니다.
키보드 단축키 – ⌘R(새로고침), ⌘, (설정), ⌘⇧A(인증), ⌘U(업데이트 확인), ⌘Q(종료).
앱 내 업데이트 – Sparkle 기반. 서명된 릴리스를 확인하고, EdDSA 서명을 검증한 후 DMG를 다시 다운로드하지 않고 설치합니다.

시작하기

설치 – GitHub Releases 페이지에서 최신 .dmg를 다운로드하고, 애플리케이션 폴더로 드래그한 후 실행합니다(처음 실행 시 서명되지 않은 앱 허용이 필요할 수 있음). 또는 리포지토리 클론 후 Xcode 15+와 macOS 13+에서 빌드.
인증 – 처음 실행 시 환영 워즈드가 나타납니다. 브라우저 로그인을 클릭하여 Claude에 로그인합니다. 앱이 미니 브라우저를 열고, 로그인 후 세션 키를 자동으로 캡처합니다. (수동으로 세션 키를 붙여넣을 수도 있습니다.)
표시 설정 – 원하는 메뉴바 스타일, 색상 테마, 리프레시 모드, Codex 모니터링 여부를 선택합니다(필요 시 ChatGPT 로그인으로 Codex 계정 추가).
사용 – 메뉴바 아이콘에 원형 프로그레스 인디케이터가 표시되며, 사용량에 따라 색상이 변경됩니다. 아이콘을 클릭하면 각 제한, 남은 시간, 수동 새로고침 버튼이 포함된 세부 창이 열립니다.
옵션 – 자동 시작, 사용량 경고 알림 활성화, 또는 설정 → 인증에서 추가 계정 추가.

누가 도움이 될까?

개발자 – Claude Code 또는 Claude 데스크톱 클라이언트를 사용하고 할당된 토큰 내에서 사용해야 하는 사람.
파워 유저 – 웹 UI, 모바일 앱, Cowork 에이전트를 전환하며 사용하고, 통합된 할당량을 한 곳에서 확인하고 싶은 사람.
팀 – Claude Team/Max 플랜을 사용하며, 여러 구성원의 모델별 사용량(Opus, Sonnet 등)을 모니터링해야 하는 사람.
누구나 – 예기치 않은 할당량 고갈을 피하고 싶은, 가벼우면서도 프라이버시 중심의 방법을 원하는 사람.

기술 사양

항목	세부 사항
언어	Swift 5+
UI	SwiftUI + AppKit 하이브리드
아키텍처	MVVM
네트워킹	URLSession
반응성	Combine
로컬라이제이션	내장 i18n (영어, 일본어, 간체자 중국어, 번체자 중국어, 한국어, 프랑스어, 독일어 등)
지원하는 macOS	13.0 (Ventura) 이상, Intel & Apple-Silicon
라이선스	MIT
배포 방식	사전 빌드된 DMG + 앱 내 Sparkle 업데이트

로드맵 (README 기준)

핵심 모니터링 및 UI는 이미 완료됨.
지속적인 작업은 Codex 통합 개선, 언어 로컬라이제이션 확장, 커뮤니티 요청 기능 추가.

결론

Usage4Claude는 워크플로우를 떠나지 않고 Claude(및 선택적 Codex) 사용량을 모니터링할 수 있는 집중형 오픈소스 macOS 메뉴바 도구입니다. 네이티브 Apple 기술로 구축되었으며, Keychain에 자격 증명을 안전하게 저장하고, 풍부한 사용자 정의 기능을 제공하면서도 가볍습니다(약 20MB RAM, 아이들 시 0.1% 미만 CPU).