macOS 메뉴바 앱 · 무료

v0.2사용 추이 & 소진 예측

Claude와 ChatGPT
구독 사용량을
메뉴바에서 한눈에.

Claude Code와 Codex를 쓰다가 한도에 걸려 흐름이 끊긴 적이 있나요? UsageBar는 두 구독의 남은 한도와 초기화 시각을 메뉴바 한 칸에 띄우고, 한도에 가까워지면 미리 알려 줘요. 이제 최근 사용 속도로 초기화 전에 한도에 닿을지도 보여 줘요.

Mac용 다운로드 어떻게 동작하나요?

macOS 14 이상Apple Silicon읽기 전용수집 없음

구독 사용량

마지막 갱신 —

직접 움직여 보세요

값은 모두 가짜예요. 실제 앱과 같은 규칙으로 반응해요.

상황
38%
21%
7%

추이 & 소진 예측

시간당 8%p

한 시간에 사용률이 몇 %p 오르는지예요. 다른 한도는 고정된 가짜 속도를 써요.

쌓인 기록
메뉴바 표시 방식

70% 이상이면 주황, 90% 이상이면 빨강으로 바뀌어요. 알림을 켜고 macOS 권한을 허용하면 알려 줘요. 같은 초기화 주기에서는 단계가 오를 때만 한 번 알려요.

필요한 것만, 필요한 순간에

메뉴바 한 칸에 두 구독

위는 Claude, 아래는 ChatGPT예요. 가장 많이 쓴 한도를 미니 게이지와 숫자로 보여 줘요. 클릭하면 5시간·주간 한도별 사용률과 초기화까지 남은 시간이 나와요.

70% 주의, 90% 한도 임박

기준 이상이면 색이 주황·빨강으로 바뀌어요. 알림을 켜고 macOS 권한을 허용하면 알려 줘요. 색만 보지 않아도 되게 "주의", "한도 임박" 글자도 함께 붙여요. 기준값은 설정에서 바꿀 수 있어요.

모르면 모른다고 말해요

값을 지어내지 않아요. 데이터가 오래됐거나 초기화 시각이 지났으면 "이전 주기 값", "오래된 데이터"라고 표시하고, 로그인이 필요하면 무엇을 하면 되는지 알려 줘요.

v0.2 새 기능

속도로 보는 한도

38%라는 숫자만으로는 알 수 없어요. 지금 빠르게 쓰고 있다면 초기화 전에 바닥날 수도 있으니까요. UsageBar는 한도별 사용률을 이 Mac에 기록해 최근 추이를 작은 그래프로 그리고, 지금 속도면 언제 한도에 닿는지 한 줄로 알려 줘요.

지금 속도면 약 2시간 15분 뒤 한도에 도달해요 (초기화 45분 전)

5시간 한도 예시 그래프 주기 시작부터 지금까지 사용률이 46%까지 올랐고, 지금 속도를 이어 가면 초기화 45분 전에 100%에 닿는 예시입니다. 100% 90 70 0 지금 초기화 주기 시작 2시간 경과 · 46% 5시간
예시 그래프예요. 실선은 지금까지의 기록, 점선은 지금 속도를 이어 간다고 가정한 계산이에요.

  • 최근 속도로만 계산해요

    지금 주기의 최근 기록에서 시간당 몇 %p씩 오르는지 구하고, 100%에 닿는 시각을 초기화 시각과 비교해요.

  • 모자라면 예측하지 않아요

    기록이 3개 미만이거나 20분이 안 됐으면 숫자 없이 "추이를 모으는 중이에요"라고만 보여 줘요. 기록이 적으면 "대략"을 붙여요.

  • 초기화가 지나면 새 주기

    사용률이 크게 떨어지거나 초기화 시각이 바뀌면 새 주기로 보고 지난 기록은 계산에서 빼요. 초기화가 지난 값으로는 예측하지 않아요.

  • 기록은 이 Mac에만

    퍼센트·시각·ID만 기록하고 앱 실행·갱신 때 최근 14일을 남겨요. 기록은 어디에도 보내지 않아요. 설정에서 끄거나 지울 수 있어요. 무엇을 저장하나요?

어떻게 동작하나요

로그인은 이미 쓰고 있는 CLI가 해 둔 그대로 써요. UsageBar는 그 정보를 읽기만 해요.

데이터 흐름도 내 Mac 안의 키체인과 Codex 세션 기록을 UsageBar가 읽고, Claude 사용량만 Anthropic 사용량 API 한 곳에 물어본 뒤, 메뉴바에 표시합니다. 추이용 사용률 기록은 이 Mac 안에만 남습니다. 내 Mac 키체인 Claude Code 로그인 읽기 전용 Codex 기록 ~/.codex/sessions 읽기 전용 읽기 네트워크 없음 UsageBar 2분마다 확인 Anthropic 사용량 API oauth/usage Claude만 HTTPS 외부 호출 1곳 메뉴바 C70% G20% 오후 4:37 70% 주의 · 90% 한도 임박 → 색 + 알림 자체 서버 없음 · 기록은 이 Mac에만
  1. 1

    이미 된 로그인을 읽어요

    Claude는 Claude Code가 macOS 키체인에 저장해 둔 자격증명을, ChatGPT는 Codex CLI가 남긴 ~/.codex/sessions 기록을 읽어요. 새로 로그인하거나 비밀번호를 입력할 일은 없어요.

    읽기만 해요. 토큰을 갱신하거나 키체인과 파일에 쓰지 않아서 CLI 자격증명을 변경하지 않아요.

  2. 2

    사용량을 확인해요

    Claude 사용량은 Anthropic 사용량 API 한 곳에만 물어봐요. 이 요청에 Claude 인증 토큰이 포함돼요. ChatGPT(Codex) 값은 로컬 이벤트 기록 시각이 가장 최신인 한도 정보를 읽고, 플랜 이름은 로컬 auth.json에서 확인해요. OpenAI 서버에는 요청하지 않아요.

    기본 2분마다 확인하고, 1·2·5·10·15분 중에서 고를 수 있어요.

  3. 3

    메뉴바에 띄워요

    가장 많이 쓴 한도를 메뉴바 게이지로 보여 주고, 클릭하면 한도별 상세와 초기화 시각이 나와요. 기본 70%·90% 이상에서 색이 바뀌어요. 알림을 켜고 macOS 권한을 허용하면 알려 줘요.

    확인한 사용률은 이 Mac에 기록해 두었다가 최근 추이 그래프와 "지금 속도면 언제 한도에 닿는지" 한 줄 예측을 계산해요.

    사용률은 지어내지 않아요. 확인할 수 없으면 확인할 수 없다고 표시하고, 기록이 모자라면 예측하지 않아요.

내 계정 정보로 무엇을 하는지, 전부 적었어요

  • 읽기 전용

    키체인과 Codex 기록은 읽기만 해요. 자격증명 파일이나 키체인 항목을 만들거나 고치지 않아요. UsageBar가 쓰는 파일은 자기 설정과 아래의 사용률 기록뿐이에요.

  • 토큰 갱신 안 함

    만료된 토큰을 몰래 새로 받지 않아요. CLI 로그인이 풀릴 수 있기 때문이에요. 만료되면 CLI에서 다시 로그인하라고 안내해요.

  • 외부 호출은 단 한 곳

    Claude 사용량을 묻는 Anthropic 사용량 API 하나뿐이에요. ChatGPT 쪽은 로컬 기록만 읽고 OpenAI 서버에는 요청하지 않아요.

    api.anthropic.com/api/oauth/usage

  • 자체 서버·수집 없음

    개발자 서버가 없어요. 분석 도구를 쓰지 않고, 사용률 기록도 이 Mac 밖으로 보내지 않아요. 토큰은 화면이나 로그에 남기지 않아요. 사이트 코드에는 분석 스크립트나 외부 요청이 없어요. 화면 설정은 이 브라우저에만 저장해요.

  • 비공식 엔드포인트

    Anthropic이 공개 문서로 보장하는 API가 아니에요. 언제든 바뀌거나 막힐 수 있고, 그러면 "불러오지 못했어요"로 표시돼요.

  • Apple 공증 없음

    ad-hoc 서명만 되어 있어서 처음 실행할 때 macOS가 경고해요. 여는 방법은 설치 2단계에 있어요.

사용률 기록은 이 Mac에만 남아요

추이 그래프와 소진 예측을 그리려면 지난 값이 필요해서, v0.2부터 확인한 사용률을 이 Mac에 기록해요. 무엇을 남기고 무엇을 남기지 않는지 그대로 적었어요.

저장하는 것

  • 한도별 사용률(%)과 확인·초기화 시각
  • 서비스·한도 구분 ID (예: Claude · 5시간)
  • 앱 실행·갱신 때 최근 14일만 남기고 오래된 기록은 지워요

위치~/Library/Application Support/UsageBar/

저장하지 않는 것

  • 토큰·자격증명
  • 사용량 API 응답 본문
  • 이메일, 계정 이름, 대화 내용

기록은 어디에도 보내지 않아요. 파일은 내 계정만 읽을 수 있는 권한(0600), 폴더는 0700으로 만들어요. 손상 파일은 복구용으로 최대 3개, 감지 후 14일까지 보관하며 기록 삭제 시 함께 지워요.

팝오버의 설정에서 기록 저장을 끄거나 기록 삭제로 바로 지울 수 있어요. 기록을 끄면 새 기록과 추이·예측 표시를 멈춰요. 기존 기록은 남으니 지우려면 기록 삭제를 눌러 주세요.

요구 사항

운영체제
macOS 14 Sonoma 이상
칩
Apple Silicon(M1 이상) 전용 · arm64 단일 빌드라 Intel Mac에서는 실행되지 않아요
Claude
Claude Code에 Claude 구독 계정(Pro/Max)으로 로그인되어 있어야 해요
ChatGPT
Codex CLI에 ChatGPT 계정으로 로그인하고 한 번 이상 사용한 기록이 있어야 해요

둘 중 하나만 써도 괜찮아요. 쓰지 않는 쪽은 "로그인되어 있지 않아요"로 표시돼요.

UsageBar 내려받기

버전 0.2.0 · DMG

DMG 다운로드

macOS 14.0 이상 · Apple Silicon (arm64)

SHA-256 릴리스 때 공개돼요

내려받은 파일이 원본과 같은지 확인하려면 터미널에서 아래 명령을 실행하고 결과를 위 값과 비교하세요.

shasum -a 256 ~/Downloads/UsageBar-0.2.0.dmg

설치는 3단계

  1. Applications 폴더로 드래그

    내려받은 DMG를 열고 UsageBar 아이콘을 Applications 폴더로 끌어다 놓으세요. 다 끝나면 DMG는 꺼내도 돼요.

  2. 처음 실행할 때 경고가 떠요 — "그래도 열기"

    솔직히 말씀드리면, UsageBar는 Apple 공증(notarization)을 받지 않은 앱이에요. 유료 개발자 인증서 없이 ad-hoc 서명만 했기 때문에 처음 열면 macOS가 "UsageBar"을(를) 열 수 없습니다 같은 경고를 띄워요. 악성 코드가 발견됐다는 뜻이 아니라 Apple이 검사하지 않았다는 뜻이에요.

    1. Applications에서 UsageBar를 한 번 열어요. 경고가 뜨면 완료를 눌러 닫아요.
    2. 시스템 설정 → 개인정보 보호 및 보안으로 가서 아래로 스크롤해요.
    3. "UsageBar"이(가) 차단되었습니다 옆의 그래도 열기를 누르고 암호나 Touch ID로 확인해요.

    출처를 믿을 수 있을 때만 여세요. 먼저 SHA-256이 이 페이지 값과 같은지 확인하는 것을 권해요.

  3. Claude Code·Codex 로그인 확인

    메뉴바에 게이지가 나타나요. 한쪽이 로그인되어 있지 않아요로 나오면 터미널에서 해당 CLI를 한 번 실행해 로그인한 뒤, 팝오버의 새로고침을 누르세요.

    Claudeclaude
    ChatGPTcodex

    Codex 값은 최근 Codex 세션 기록에서 읽어요. 로그인 후 Codex로 대화를 한 번 하면 표시돼요. Mac을 켤 때 자동으로 실행하려면 팝오버의 설정에서 로그인 시 자동 실행을 켜세요.

자주 묻는 질문