Show HN: macOS 메뉴 바에 Claude Code 할당량 게이지 표시
출처: Hacker News
Claude Code 할당량을 표시하는 메뉴 바 게이지 — 계정당 하나의 바, 예시:
(다크 메뉴 바용으로 그린 이미지 — 흰색 외곽선)
각 바는 5시간 윈도우 사용량을 표시하며, 초록 / 주황(≥70%) / 빨강(≥90%) 색으로 구분됩니다.
5시간 윈도우가 완전히 사용되면 바는 백분율 대신 리셋까지 남은 시간을 카운트다운(4:28)으로 표시합니다.
주간 제한에 도달하면 바가 검정색으로 바뀌고 주간 리셋까지 남은 시간을 카운트다운(2D)으로 표시합니다 — 이는 5시간 윈도우와 관계없이 적용되는 더 강력한 제한입니다.
드롭다운 메뉴에는 각 계정에 대한 전체 세부 정보가 인라인으로 표시됩니다: 5시간 및 주간 윈도우, 플랜에서 보고하는 모델별 윈도우, 추가 사용 크레딧, 리셋 시간 등.
5분마다 자동으로 새로 고침되며(SwiftBar 파일명 규칙) 수동 “Refresh now” 항목도 제공합니다.
Quick install
curl -fsSL https://raw.githubusercontent.com/grzegorz-raczek-unit8/claude-quota/main/install.sh | bashmacOS와 Homebrew가 필요합니다. macOS에서 첫 번째 새로 고침 시 키체인 권한 대화 상자가 나타나면 Always Allow(항상 허용)를 클릭하세요.
How it works
플러그인은 macOS 키체인에서 Claude Code OAuth 토큰을 읽기 전용으로 가져옵니다(절대 토큰을 갱신하거나 다시 쓰지 않으므로 로그아웃되지 않습니다). 그리고 Claude Code의 /usage 화면이 사용하는 동일한 사용량 엔드포인트에 쿼리합니다. 비밀번호, 스크래핑, 제3자 서비스가 전혀 필요 없습니다.
참고: 해당 엔드포인트는 Claude Code 내부 전용이며 문서화되지 않았기 때문에, 향후 Claude Code가 변경되면 여기서 작은 수정이 필요할 수 있습니다.
Install from a checkout
git clone https://github.com/grzegorz-raczek-unit8/claude-quota.git
cd claude-quota
./install.sh설치 경로는 Homebrew를 통해 SwiftBar를 자동으로 설정합니다(설치되어 있지 않은 경우). 계정에 ⚠️ 표시가 뜨면 토큰이 사용되지 않아 만료된 것입니다 — claude CLI를 한 번 실행하면 다음 사이클에 위젯이 복구됩니다.
Accounts
플러그인은 기본적으로 자동으로 계정을 탐색합니다: Claude Code 키체인 항목이 있는 ~/.claude 또는 ~/.claude-* 설정 디렉터리마다 바가 생성되며, 디렉터리 접미사(~/.claude-work → W)가 라벨로 표시됩니다. 자동 탐색된 단일 계정은 라벨 없이 바만 표시됩니다.
여러 CLAUDE_CONFIG_DIR를 사용하고 라벨을 지정하거나 고정하고 싶다면, 다음과 같이 ~/.config/claude-quota/accounts 파일을 만들고 각 라인에 path [label] 형식으로 입력합니다(라벨은 한 단어):
~/.claude-work Work
~/.claude-priv Priv계정의 메뉴 바 게이지를 숨기고 싶다면(드롭다운 상세 내용은 유지) 해당 계정 행의 드롭다운 메뉴에서 Hide from menu bar를 선택하거나 ~/.config/claude-quota/hidden 파일을 편집합니다(라벨을 한 줄에 하나씩 적음).
CLAUDE_CONFIG_DIR를 이용한 다중 계정 설정 예시 (.bashrc·.zshrc 등):
claude() { CLAUDE_CONFIG_DIR="$HOME/.claude-work" command claude "$@"; }
claude-priv() { CLAUDE_CONFIG_DIR="$HOME/.claude-priv" command claude "$@"; }Uninstall
SwiftBar 플러그인 폴더(~/.swiftbar가 기본)에서 claude-quota.5m.py 파일을 삭제하면 됩니다.