Claude Usage Barometer
Claude 사용량을 위한 작고 배터리 스타일의 메뉴 바 게이지. 5시간과 7일 구간이 실시간으로 줄어드는 것을 — 바로 macOS 메뉴 바에서 — 지켜보세요.
Claude 한도를 언제나 한눈에
Claude Usage Barometer는 macOS 메뉴 바에 자리 잡는 SwiftBar(또는 xbar)용 무료 오픈소스 플러그인입니다. 배터리 스타일의 막대 두 개 — 하나는 Claude의 롤링 5시간 구간, 다른 하나는 7일 구간 — 를 보여주어 남은 할당량을 한눈에 정확히 파악할 수 있습니다. 빌드 과정이 없는 순수 Bash로, macOS Keychain에서 Claude Code 토큰을 로컬로 읽으며, 데이터를 어디에도 전송하지 않습니다.
사용량 한도는 도달하기 전까지 보이지 않는다
Claude는 롤링 사용량 구간을 적용하지만, 데스크톱의 어떤 것도 한도에 얼마나 가까운지 알려주지 않습니다 — 작업 도중 멈춰 버리기 전까지는.
기본 표시기가 없다
5시간과 7일 구간을 위한 내장 게이지가 없어, 세션 도중 예고 없이 한도에 도달할 수 있습니다.
컨텍스트 전환 비용
사용량을 확인하려면 작업을 멈추고 대시보드를 뒤져야 합니다 — 얼마나 남았는지 궁금할 때마다 치르는 마찰입니다.
예상치 못한 중단
한도에 갑작스레 도달하면 흐름이 끊기고, 진행 중이던 작업이 멈춥니다. 한눈에 보이는 게이지가 그 뜻밖의 상황을 막아 줍니다.
Claude 할당량을 위한 배터리
메뉴 바의 막대 두 개, 상세 드롭다운, 그리고 클릭 한 번 없이 상황을 알려주는 색상.
채워진 구간은 남은 양을, 빈 구간은 사용한 양을 보여줍니다. 각 막대는 5시간과 7일 할당량을 소비함에 따라 줄어듭니다.
사용량 69%까지는 초록색, 70%부터는 황색, 90%부터는 빨간색 — 메뉴 바 막대는 더 제약이 큰 구간을 따릅니다.
클릭하면 각 구간의 남은 비율과 정확한 리셋 카운트다운, 그리고 마지막 업데이트 시각을 확인할 수 있습니다.
이 Mac의 Keychain에서 Claude Code OAuth 토큰을 읽습니다. 계정도, 서버도 없으며, 어떤 것도 기기를 벗어나지 않습니다.
작은 게이지, 세심한 디테일
메뉴 바 도구에서 바라는 모든 것, 그리고 군더더기는 없이.
5시간 및 7일 게이지
두 롤링 구간을 한눈에, 드롭다운에서 남은 비율과 리셋 카운트다운까지.
색상 구분 상태
한도에 가까워질수록 초록에서 황색, 빨강으로 — 무엇도 열지 않고도 상태가 한눈에 보입니다.
레이트 리밋 친화적
마지막 정상 측정값을 캐싱하고 API 호출을 최소 3 minutes 간격으로 제한하여, 짧은 429에도 무리 없이 견딥니다.
업데이트 인지
하루에 한 번 GitHub을 확인하고, 더 새로운 릴리스가 나오면 드롭다운에 "업데이트 가능" 링크를 표시합니다.
조절 가능한 새로고침
드롭다운에서 1, 3, 5분 새로고침 간격을 골라 최신성과 API 호출 사이의 균형을 맞추세요.
빌드 없는 순수 Bash
읽고, 감사하고, 손보기 쉽습니다. 설계부터 프라이빗하며 MIT 라이선스로 배포됩니다.
터미널에 한 줄
인스톨러가 Homebrew로 jq와 SwiftBar를 추가하고, 플러그인을 설치한 뒤 실행합니다. 첫 실행 시 Keychain 프롬프트에서 "항상 허용"을 선택하세요.
curl -fsSL https://raw.githubusercontent.com/taka-avantgarde/claude-usage-barometer/main/install.sh | bashmacOS 12+, Homebrew, 그리고 이 Mac에 로그인된 Claude Code가 필요합니다.
자주 묻는 질문
Claude Usage Barometer는 무료인가요?
네. MIT 라이선스의 오픈소스이며 무료로 사용할 수 있습니다. Mac에 이미 있는 Claude Code 세션만 있으면 됩니다.
실행하려면 무엇이 필요한가요?
macOS 12 이상, SwiftBar(또는 xbar), jq와 curl, 그리고 같은 Mac에 로그인된 Claude Code가 필요합니다. 한 줄 인스톨러가 jq와 SwiftBar를 대신 설정해 줍니다.
제 Claude 토큰은 안전한가요?
네. 이 플러그인은 macOS Keychain에서 Claude Code OAuth 토큰을 로컬로 읽어, 오직 본인의 사용량을 가져오는 데에만 사용합니다. 순수 Bash이며, 제3자에게 아무것도 전송하지 않고, 텔레메트리도 없습니다.
색상은 무엇을 의미하나요?
막대는 사용량 70% 미만에서 초록색, 70%에서 89%까지는 황색, 90%에서 100%까지는 빨간색입니다. 메뉴 바 색상은 두 구간 중 한도에 더 가까운 쪽을 따릅니다.
SwiftBar뿐 아니라 xbar도 지원하나요?
네. SwiftBar 또는 xbar 플러그인으로 동작합니다. SwiftBar를 권장하며, 한 줄 인스톨러도 SwiftBar를 설정합니다.