Headroom: Claude 사용량을 추적하는 macOS 메뉴바 앱

실용적 조언

Claude 사용량이 많은 경우 Headroom의 폴링 간격을 30초로 설정하여 가장 최신의 사용 상태를 유지할 것
메뉴바 공간이 부족하다면 설정에서 {sl_eta}만 사용하여 한도 도달까지 남은 시간만 간결하게 표시할 것

섹션별 상세

사용자가 Claude의 사용량 제한을 실시간으로 관리할 수 있는 Headroom이라는 macOS 메뉴바 앱이 개발됐다. 이 앱은 {sl}, {wl} 등의 플레이스홀더를 사용해 메뉴바에 표시될 정보를 사용자가 직접 구성할 수 있는 유연한 인터페이스를 제공한다.

선형 회귀 알고리즘을 활용하여 현재 사용 패턴을 분석하고 한도 도달 예상 시간을 계산한다. 최근 사용량 샘플을 롤링 윈도우 방식으로 처리하여 '7시간 18분 후 한도 도달'과 같은 구체적인 예측치를 사용자에게 전달함으로써 계획적인 사용을 유도한다.

Headroom 앱의 상세 사용량 모니터링 대시보드 화면 — Screenshot세션 한도(16%), 주간 한도(19%), 그리고 추가 사용 금액($53.25 / $100.00)을 시각적인 진행 바와 수치로 보여준다. 각 항목 아래에 'Hit limit in ~7h 18m'과 같은 예측 데이터와 시간당 사용률(12.2%/hr)이 표시되어 사용자가 직관적으로 남은 자원을 파악할 수 있음을 입증한다.

보안을 위해 macOS Keychain을 통한 세션 저장과 네이티브 WebView 기반의 Google OAuth 인증 방식을 채택했다. 사용자의 인증 데이터는 시스템 보안 영역에 저장되며, 앱 재시작 시에도 과거 사용 이력이 시계열 데이터로 유지되어 연속적인 모니터링이 가능하다.

이 프로젝트는 MIT 라이선스로 공개되어 GitHub에서 누구나 소스 코드를 확인하고 기여할 수 있다. 개발자는 Sparkle 프레임워크를 통합해 자동 업데이트 시스템을 구축했으며, 사용자들이 Claude를 직접 활용해 새로운 기능을 추가하고 PR을 보내는 방식의 협업을 장려했다.

용어 해설

선형 회귀(Linear Regression): — 과거의 사용량 데이터 포인트들을 분석하여 미래의 추세를 예측하는 통계적 기법이다. 이 앱에서는 최근 사용 패턴을 바탕으로 사용자가 언제쯤 할당된 토큰이나 횟수 제한에 도달할지 예상 시간을 계산하는 데 사용된다.
오픈 인증(OAuth): — 사용자의 비밀번호를 직접 노출하지 않고도 서드파티 애플리케이션에 특정 계정의 접근 권한을 안전하게 부여하는 표준 프로토콜이다. 이 앱은 Google OAuth를 지원하여 사용자가 안전하게 Claude 계정에 연동할 수 있도록 돕는다.
키체인(Keychain): — macOS에서 암호, 인증서, 키와 같은 민감한 정보를 암호화하여 저장하는 시스템 수준의 보안 저장소이다. 앱은 사용자의 세션 정보를 키체인에 보관하여 앱 종료 후에도 안전하게 인증 상태를 유지한다.

언급된 도구

Headroom추천링크

macOS용 Claude 사용량 추적 및 예측 메뉴바 앱

Sparkle중립

macOS 앱 자동 업데이트 프레임워크

언급된 리소스

GitHubHeadroom GitHub Repository