작업 도중 주간 사용량 제한에 지쳐서 만든 앱: Claude Code 사용량을 실시간 %로 표시
요약
Claude Code 사용량 제한의 불편함을 해소하기 위해 macOS용 무료 메뉴 바 앱 'Headroom'이 개발되었습니다. 이 앱은 실시간 세션 및 주간 사용량을 퍼센트(%)로 표시하고, 색상 코딩과 초기화 카운트다운 기능을 제공합니다. 특히 네트워크 호출이나 외부 의존성 없이 로컬 파일만 읽어 신뢰성을 높였습니다.
핵심 포인트
- Claude Code의 사용량 제한을 실시간 %로 보여주는 macOS 앱 'Headroom' 출시.
- 색상 코딩 및 초기화 카운트다운 기능으로 사용자 경험 개선.
- 네트워크 호출이나 외부 의존성 없이 로컬 파일만 읽어 높은 신뢰성 확보.
5시간 세션과 7일 주간 측정기는 늘 불편했습니다. /usage는 숫자를 보여주지만, 저는 실행하는 것을 깜빡하곤 했습니다.
그래서 Headroom이라는 작은 무료 macOS 메뉴 바 앱을 만들었습니다. 이 앱은 실시간 세션 및 주간 사용량을 %로 표시하며, 색상 코딩(차분 → 호박색 → 빨간색)과 드롭다운에서 초기화 카운트다운 기능을 제공합니다. 또한 컨텍스트 창 채움 정도와 현재 활성 모델(Sonnet 4.6 / Opus / Fable)도 보여줍니다.
신뢰의 문제도 있습니다. Claude 설정 근처에 있는 앱은 감사 가능해야 합니다: Headroom은 네트워크 호출을 전혀 하지 않습니다. Claude Code는 이미 공식적인 사용량 제한 숫자를 가져와 상태 표시줄에 렌더링하며, Headroom은 이것을 연결하여 로컬 파일을 읽습니다. 토큰 없음, Keychain 없음, API 폴링 없음, 분석 기능 없음. MIT 라이선스이며 약 650줄로 구성되어 있고 의존성도 없습니다. 데이터 경로는 GitHub의 두 개의 작은 파일입니다.
다운로드: https://headroom.walls.sh (~259 KB, 서명 및 공증됨) · Brew: brew install --cask patwalls/tap/headroom · 소스: https://github.com/patwalls/headroom
재미있는 공개 사항: 이 앱은 주로 Claude가 자율 빌드 루프를 실행하면서 만들어졌습니다. 모든 과정은 아키텍처를 삭제해야 했던 것까지 포함하여 리포지토리의 VISION.md에 기록되어 있습니다. 피드백을 환영합니다.
/u/youngrichntasteless 제출
AI 자동 생성 콘텐츠
본 콘텐츠는 r/ClaudeAI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기