OpenUsage ↗는 여러 AI 코딩 도구의 사용량 한도를 macOS 메뉴바에 모아 보여주는 무료 오픈소스 앱입니다. 별도 로그인 없이 기기에 있는 자격증명을 재사용하므로 설치 직후 바로 동작합니다.
Claude Code, Codex, Cursor 같은 구독제 AI 코딩 도구는 작업 중에 “한도에 도달했습니다” 메시지를 띄우고, 리셋까지 몇 시간을 기다리게 합니다. 남은 사용량이 미리 보이면 작업을 나눠 배치할 수 있습니다. 비슷한 도구가 이미 여럿 있어서 이 글에서는 CodexBar·OpenCode Bar·caut·Claude Usage Tracker도 함께 비교합니다.
2026-07-02 · OpenUsage v0.7.1, CodexBar v0.37.2, OpenCode Bar v2.11.1, Claude Usage Tracker v3.1.1 기준. 이 카테고리 도구들은 릴리스 주기가 빠르므로 지원 provider 목록은 각 저장소에서 최신 상태를 확인하세요.
이 글에서 다루는 내용:
- 왜 AI 코딩 사용량 추적 도구가 갑자기 여럿 등장했는지
- OpenUsage의 구조와 설치 방법, 로컬 HTTP API 활용
- 유사 도구 4종과의 비교, 그리고 상황별 선택 가이드
배경: 왜 이런 도구가 필요해졌나
API 종량제 시대에는 비용 대시보드만 보면 됐습니다. 하지만 Claude Code Pro/Max, Codex 구독제, Cursor 요금제처럼 세션·주간 한도 방식이 주류가 되면서 상황이 달라졌습니다. Claude 공식 지원 문서 ↗에 따르면 Pro/Max 플랜의 사용량 한도는 Claude 웹과 Claude Code가 공유하며, 한도에 가까워지면 경고 메시지가 표시됩니다.
이 한도는 provider마다 확인하는 곳이 다릅니다. Claude Code는 /status 명령으로, Codex는 자체 명령으로, Cursor는 웹 대시보드에서 확인합니다. 여러 도구를 함께 쓰는 개발자는 어느 도구에 여유가 있는지 알려면 이곳을 모두 돌아봐야 합니다.
2025년 말부터 이 확인 과정을 메뉴바나 CLI 한 곳으로 모아주는 도구들이 연이어 나왔습니다. 한도 자체를 아끼는 방법은 로컬 LLM 라우터로 토큰 비용 줄이기에서 다뤘습니다. 한도·장애 상황에서 세션을 유지하는 방법은 Claude Code fallbackModel에서 다뤘습니다. 이 글은 그 앞 단계인 남은 사용량을 보이게 만드는 방법을 다룹니다.
OpenUsage: 플러그인 기반 범용 사용량 메뉴바
OpenUsage ↗는 robinebers/openusage ↗ 저장소에서 개발되는 MIT 라이선스 오픈소스 앱입니다. 2026년 2월에 시작한 프로젝트이고, 작성 시점 기준 star는 3,000개를 넘었습니다.
메뉴바 팝오버는 위 스크린샷처럼 provider별 세션·주간 한도와 크레딧, 지출을 보여줍니다. 자주 보는 지표는 메뉴바에 핀으로 고정할 수 있습니다. README ↗ 기준 지원 provider는 Antigravity, Claude, Codex, Cursor, Devin, Grok, OpenRouter, Z.ai입니다. v0.7.1 릴리스 ↗에서 OpenRouter·GitHub Copilot·Z.ai 지원과 한도 소진 속도(quota pace) 알림이 추가됐습니다.
로컬 자격증명 재사용 구조
OpenUsage는 별도 로그인 없이 기기에 이미 있는 자격증명을 읽습니다. Claude Code나 Codex CLI를 인증해서 쓰고 있다면, provider별 플러그인이 그 keychain 항목이나 auth 파일을 읽어 사용량 API를 조회합니다.
flowchart TD
A[로컬 자격증명<br/>keychain · auth 파일 · 앱 상태] --> B[provider별 플러그인]
B --> C[각 provider 사용량 API 조회]
C --> D[메뉴바 팝오버 표시]
C --> E["로컬 HTTP API<br/>127.0.0.1:6736"]조회 결과는 stale-while-revalidate 방식으로 캐싱되어 5분 주기로 갱신됩니다. 앱 자체는 SwiftUI 콘텐츠를 AppKit의 NSStatusItem과 NSPopover에 호스팅하는 구조로, Swift 6 strict concurrency로 작성되어 있습니다.
설치와 로컬 API
설치는 Homebrew cask 한 줄입니다. macOS 15(Sequoia) 이상이 필요합니다.
brew install --cask openusageOpenUsage는 로컬 HTTP API도 제공합니다. 앱이 127.0.0.1:6736에서 인증 없는 로컬 API를 열어 두므로, 메뉴바를 클릭하지 않고 스크립트에서 사용량을 조회할 수 있습니다.
curl localhost:6736/v1/usage유사 도구 4종 비교
OpenUsage 외에도 대상과 형태가 다른 도구 4종이 있습니다.
CodexBar — 가장 넓은 provider 커버리지
CodexBar ↗는 Peter Steinberger가 만든 메뉴바 앱입니다. 작성 시점 기준 star 15,000개 이상으로 이 카테고리에서 가장 많습니다. README ↗ 기준 54개 provider를 지원합니다. Codex, OpenAI, Claude, Cursor, Gemini, Copilot, OpenRouter, LiteLLM에 더해 ElevenLabs, AWS Bedrock 같은 비(非)코딩 provider도 포함합니다.
위 화면처럼 여러 provider의 사용량 바와 리셋 시각이 하나의 팝오버에 모입니다. 기능은 세 가지입니다. provider별 세션·주간·월간 윈도우와 리셋 카운트다운(Reset Planning), 크레딧 잔액과 청구 요약(Spend Tracking), provider 장애 상태 폴링과 배지 표시(Status Monitoring)입니다. 자격증명은 OAuth·device flow·API 키·로컬 파일을 재사용하고, 브라우저 쿠키 접근은 opt-in입니다. macOS 14+ 대상이고 설치는 brew install --cask codexbar입니다.
OpenCode Bar — OpenCode 사용자를 위한 자동 감지
OpenCode Bar ↗는 OP.GG가 공개한 오픈소스로, OpenCode ↗에 등록된 provider의 사용량을 추적합니다. OpenCode의 auth.json을 표준 경로 세 곳($XDG_DATA_HOME, ~/.local/share, ~/Library/Application Support)에서 자동으로 찾습니다. OpenCode 사용자라면 설치 직후 수동 설정 없이 동작합니다.
메뉴바 앱과 함께 CLI도 제공합니다.
opencodebar status
opencodebar status --jsonmacOS 13+로 요구사항이 이 목록에서 가장 낮고, 설치는 brew install --cask opgginc/tap/opencode-bar입니다. OpenCode를 쓰지 않는다면 자동 감지 기능을 쓸 수 없습니다.
caut — 터미널과 에이전트를 위한 CLI
caut ↗(Coding Agent Usage Tracker)는 유일한 CLI 전용 도구입니다. README에서 스스로를 CodexBar의 크로스플랫폼 Rust 포트라고 소개하며, macOS·Linux·Windows에서 동작합니다. crates.io에 배포되지 않아 git에서 직접 설치합니다.
cargo install --locked --git https://github.com/Dicklesworthstone/coding_agent_usage_tracker사람이 읽는 터미널 출력 외에 JSON·Markdown 출력도 지원합니다.
caut usage
caut usage --json
caut usage --format mdJSON 출력에는 "schemaVersion": "caut.v1" 필드가 들어 있어 스크립트나 AI 에이전트가 형식 변경을 감지하며 파싱할 수 있습니다. 메뉴바 앱은 사람이 확인하는 용도이고, caut는 자동화 파이프라인과 에이전트가 읽는 용도입니다.
Claude Usage Tracker — Claude 전용의 깊이
Claude Usage Tracker ↗는 Claude 하나만 지원하는 메뉴바 앱입니다. 5시간 롤링 윈도우와 주간 사용량, Opus 전용 소비량을 구분해서 보여줍니다. 여러 Claude 계정의 자격증명을 자동으로 바꿔 쓰는 멀티 프로필도 지원합니다. 한국어를 포함한 13개 언어 UI도 제공합니다.
Claude Code 터미널 statusline에 실시간 사용량을 표시하는 기능도 있습니다. 이 기능은 OAuth 대신 세션 키를 직접 설정해야 합니다. macOS 14+ 대상이고, 설치는 개인 tap 경로를 사용합니다.
brew install --cask hamed-elfayome/claude-usage/claude-usage-tracker한눈에 비교하기
작성 시점(2026-07-02) 기준으로 다섯 도구를 정리하면 다음과 같습니다.
| 항목 | OpenUsage | CodexBar | OpenCode Bar | caut | Claude Usage Tracker |
|---|---|---|---|---|---|
| 형태 | 메뉴바 | 메뉴바 | 메뉴바 + CLI | CLI | 메뉴바 |
| 주요 대상 | Claude·Codex·Cursor 등 8+ | 54개 provider | OpenCode 등록 provider | Codex·Claude·Gemini 등 16+ | Claude 전용 |
| OS 요구 | macOS 15+ | macOS 14+ | macOS 13+ | macOS·Linux·Windows | macOS 14+ |
| 설치 | brew install --cask openusage | brew install --cask codexbar | brew install --cask opgginc/tap/opencode-bar | cargo install --locked --git … | brew install --cask hamed-elfayome/claude-usage/claude-usage-tracker |
| 차별점 | 플러그인 구조, 로컬 HTTP API | 최다 provider, 리셋·지출·상태 통합 | OpenCode config 자동 감지 | JSON/MD 출력, 에이전트 연동 | 5시간/주간 윈도우, 멀티 프로필 |
| 라이선스 | MIT | MIT | MIT | MIT 기반(추가 조항) | MIT |
| GitHub stars | 약 3,100 | 약 15,600 | 약 280 | 약 70 | 약 2,900 |
상황별 선택 기준은 다음과 같습니다.
- 여러 AI 코딩 도구를 함께 쓰고 macOS 15 이상이라면 OpenUsage. 플러그인 구조와 로컬 API를 제공합니다.
- 가장 많은 provider를 한곳에서 보고 싶거나 macOS 14라면 CodexBar. 사용자가 가장 많고 기능 범위가 가장 넓습니다.
- OpenCode 사용자라면 OpenCode Bar. 설정 없이 자동 감지로 동작합니다.
- 터미널·스크립트·에이전트 연동이 목적이거나 Linux/Windows라면 caut. 이 목록에서 유일한 CLI 도구입니다.
- Claude만 쓰고 여러 계정을 운영한다면 Claude Usage Tracker. Claude 전용 윈도우와 멀티 프로필을 제공합니다.
마무리
OpenUsage는 로컬 자격증명을 재사용하고, provider를 플러그인으로 추가하며, 로컬 HTTP API로 데이터를 내보냅니다. provider 수와 기능 범위가 필요하면 CodexBar를, CLI·에이전트 연동이 필요하면 caut를 고릅니다.
메뉴바에 사용량이 보이면 작업 순서를 정할 수 있습니다. 무거운 리팩터링은 한도가 넉넉할 때 하고, 한도가 얼마 남지 않으면 가벼운 작업으로 바꿉니다.
로컬 자격증명(OAuth)을 재사용하는 다른 사례는 Hermes Agent 시작하기: 맥에 설치하고 ChatGPT OAuth로 GPT 모델 연결하기에서 다뤘습니다.
참고 자료
- OpenUsage 공식 사이트 ↗ — 지원 provider와 소개
- robinebers/openusage ↗ — 설치, 아키텍처, 로컬 API 문서
- steipete/CodexBar ↗ — 54개 provider 목록과 기능 설명
- Dicklesworthstone/coding_agent_usage_tracker ↗ — caut 설치와 출력 포맷
- Claude 공식 지원 문서: Pro/Max 플랜에서 Claude Code 사용하기 ↗ — 사용량 한도 공유 근거