Show GN: AI Usage - 여러 Claude Code·Codex 계정의 사용 한도를 보여 주는 macOS 바탕화면 위젯

2 days ago 12

Claude Code와 Codex 계정을 여러 개 번갈아 쓰다 보니, 어느 계정에 한도가 남았는지 확인하려고 터미널을 여는 일이 잦아서 만들었습니다. 계정마다 5시간·주간 한도를 활동 링으로 바탕화면 위젯에 보여 줍니다.

주요 기능

  • 계정당 게이지 1개, 링 3개 (Claude: 5시간 / 주간 / 주간 Fable, Codex: 5시간 / 7일)
  • ~/.claude-, ~/.codex- 설정 디렉토리 자동 탐지, 켜기/끄기·순서 변경
  • Antigravity(agy) CLI 계정도 지원 (Gemini, Claude/GPT 풀)
  • 임계치(기본 90%) 초과 시 링 색 변경과 알림, Codex 크레딧 소진·토큰 갱신 실패 알림
  • 상세 창: 한도별 퍼센트, 남은 시간, 정확한 리셋 일시
  • 설정에서 계정별 인증 환경(폴더)을 만들 수 있음: 미리보기, 백업 포함
  • 앱 없이 쓰는 aiusage CLI와 MCP 서버 (aiusage mcp → get_usage 도구)
  • 한국어·영어·일본어

동작 방식

  • CLI가 쓰는 사용량 엔드포인트(api.anthropic.com/api/oauth/usage, chatgpt.com/backend-api/wham/usage)를 로컬에서 직접 호출합니다.
  • 결과는 App Group의 스냅샷 파일에 쓰고, 샌드박스 위젯은 이 파일만 읽습니다. 토큰은 스냅샷에 쓰지 않으며 Mac 밖으로 나가지 않습니다.
  • Claude는 앱에서 계정마다 한 번 로그인하면 자체 OAuth 세션을 유지하므로 Claude Code의 자격 증명을 건드리지 않습니다.

설치
brew install --cask typostudio/tap/ai-usage
또는 GitHub Releases에서 dmg를 받으면 됩니다. macOS 14 이상, 오픈소스(Swift/WidgetKit)입니다.
공증을 받지 않은 앱이라 첫 실행이 막히면 xattr -dr com.apple.quarantine /Applications/AIUsage.app 을 한 번 실행해 주세요.

한계

  • 사용량 엔드포인트는 비공개 API라서 바뀔 수 있습니다.

받고 싶은 피드백

  • 여러 계정을 쓰는 분들의 실제 사용 흐름에 맞는지
  • 추가로 보고 싶은 프로바이더나 지표
  • 위젯 크기·레이아웃 의견
Read Entire Article




피플앤툴즈 네트워크
🛍 샵