Claude Code 지출을 macOS 메뉴 막대에서 한눈에 보여주는 모든 도구 — sangrokjung의 Swift 네이티브 cc-menubar, AnkMister의 SwiftBar 플러그인, calvindotsg의 Python 예측기 — 는 내부적으로 같은 파서를 사용합니다. 어떤 래퍼를 고를지 정하기 전에, 그 래퍼가 실제로 무엇을 감싸고 있는지부터 알아두면 좋습니다.
ccusage: 모든 트래커가 호출하는 1.7만 스타 파서
ccusage(ryoppippi/ccusage)는 Claude Code의 로컬 JSONL 세션 로그를 읽어 지출을 계산하는 커뮤니티 표준 CLI입니다. API 키도, 프록시도, Keychain 접근도 필요 없습니다. Claude Code가 모든 API 호출, 토큰 수, 모델 선택을 기록하는 ~/.claude/projects/를 감시하고, LiteLLM 가격 스냅샷으로 해당 토큰 비용을 계산합니다. --offline 캐시 fallback도 있어 핵심 수치가 내 컴퓨터 밖으로 나가지 않습니다 . 이렇게 수동적으로 로그를 읽는 구조 덕분에 래퍼들이 존재할 수 있습니다. 어려운 부분은 이미 해결되어 있기 때문입니다.
2026년 7월 기준 ccusage는 GitHub 스타 약 1.71만 개를 보유하고 있으며, Claude Code를 넘어 Codex, Amp, Goose, OpenCode, Gemini CLI, GitHub Copilot CLI 등 10개 이상의 에이전트를 지원합니다 . npx ccusage@latest로 실행하는 TypeScript/bun 도구이며, 일간, 주간, 월간, 세션별, 5시간 과금 창 리포트와 모델별 breakdown, JSON export를 제공합니다.
세 macOS 래퍼 모두 결국 비용 계산은 ccusage --offline을 셸로 호출해 처리합니다. 차이는 순전히 UI 계층, 배포 방식, 그리고 원시 지출 외에 무엇을 보여주느냐에 있습니다. 공통으로 주의할 점도 있습니다. ccusage가 캐시되어 있지 않으면 첫 실행 때 npx로 다운로드하므로, 최초 메뉴 막대 갱신에는 몇 초 정도 지연이 생길 수 있습니다.
SwiftBar, Xcode, npx 중 무엇을 감수할까
비용 엔진은 같기 때문에, 이 세 래퍼를 실제로 가르는 것은 의존성입니다. sangrokjung의 cc-menubar는 네이티브 바이너리입니다. 코드의 96.8%가 Swift입니다 . 따라서 빌드하려면 Xcode 툴체인이 필요합니다. 출시 시점에는 사전 빌드 바이너리나 Homebrew cask가 없고, git clone 후 bash build.sh를 실행해야 합니다. AnkMister의 ccusage-menubar는 100% shell이며 SwiftBar 플러그인으로 동작합니다. 그래서 brew install swiftbar와 Node.js 14+ 가 건너뛸 수 없는 전제 조건입니다. calvindotsg의 cc-menubar(v2.0.1, 2026년 4월)는 SwiftBar 위에서 도는 Python 도구이며, brew install calvindotsg/tap/cc-menubar 또는 uv tool install cc-menubar로 설치할 수 있습니다 . Swift 툴체인은 전혀 필요 없습니다.
| 트래커(org) | 스택 | 설치 경로 | 최소 전제 조건 |
|---|---|---|---|
| sangrokjung/cc-menubar | 96.8% Swift, 네이티브 | clone + build.sh + install.sh | Xcode |
| AnkMister/ccusage-menubar | 100% shell, SwiftBar | curl one-liner | SwiftBar + Node.js 14+ |
| calvindotsg/cc-menubar | Python, SwiftBar | brew / uv tool | Homebrew 또는 uv |
Swift 빌드가 고유하게 보여주는 기능이 필요할 때만 Xcode 비용을 감수하면 됩니다. 이 앱은 http://localhost:3456의 로컬 상태 endpoint를 조회해 teamclaude 계정 로테이션 상태, 즉 로테이션 계정의 사용 가능 여부, quota 경고, reset timing을 모니터링합니다 . clone 전에 조심할 점이 하나 있습니다. sangrokjung/cc-menubar와 calvindotsg/cc-menubar는 표시 이름은 같지만, 서로 다른 언어로 작성된 완전히 별개의 코드베이스입니다. 설치 명령을 실행하기 전에 GitHub org를 반드시 확인하세요.
curl, source, brew: 각 트래커 배포 방식
배포 방식은 세 트래커를 깔끔하게 나눕니다. sangrokjung의 앱은 source-only, AnkMister의 앱은 curl one-liner, calvindotsg의 앱은 유일한 Homebrew formula입니다. 설치 스크립트를 바로 실행하는 것을 얼마나 신뢰하는지, 로컬에서 직접 빌드할지, 그리고 이미 SwiftBar나 Node.js 전제 조건을 갖췄는지에 따라 고르면 됩니다.
sangrokjung/cc-menubar에는 아직 one-liner가 없습니다. 네이티브 Swift 바이너리를 직접 clone하고 빌드해야 합니다. 조사 시점에는 Homebrew cask가 없으므로 source 경로가 유일한 방법입니다:
git clone https://github.com/sangrokjung/cc-menubar
cd cc-menubar
bash build.sh
bash install.shbuild.sh는 단일 네이티브 바이너리를 컴파일하고, install.sh는 이를 제 위치에 배치합니다. 빌드 요구 사항은 repo를 참고하세요.
AnkMister/ccusage-menubar는 SwiftBar 플러그인이므로, installer는 shell script를 배치하고 interval을 설정하는 역할만 합니다. 가장 빠른 방법은 install script를 bash로 pipe하는 것입니다:
curl -fsSL https://raw.githubusercontent.com/AnkMister/ccusage-menubar/main/install.sh | bash먼저 확인하고 싶다면 SwiftBar와 Node.js를 설치한 뒤, ccusage.30m.sh를 ~/Documents/SwiftBarPlugins에 복사하고 chmod +x로 실행 권한을 부여하세요. 자세한 내용은 project README에 있습니다.
calvindotsg/cc-menubar — 별도로 작성된 Python quota 예측기이며, 2026년 4월 22일자로 표시된 v2.0.1입니다 — 는 셋 중 가장 깔끔한 one-liner를 제공합니다:
brew install calvindotsg/tap/cc-menubar
# or
uv tool install cc-menubar갱신 주기는 설계에 따라 다릅니다. AnkMister의 플러그인은 SwiftBar가 ccusage.30m.sh 파일명에서 interval을 그대로 읽기 때문에 30분마다 polling합니다. 더 자주 업데이트하려면 ccusage.5m.sh로 이름을 바꾸면 됩니다. 반면 sangrokjung의 앱은 활성 세션 중 live pulse를 보여주고, 요약을 오늘, 이번 주, 이번 달, 전체 기간 사이에서 순환 표시합니다. 그래서 고정 polling 없이도 거의 실시간에 가까운 피드백을 받을 수 있습니다.
cc-menubar 집계가 Console과 달라질 때, 그리고 얼마나 달라질 수 있는지
메뉴 막대 트래커는 청구서가 아니라 추정치입니다. cc-menubar와 ccusage 기반의 모든 유사 도구는 JSONL 로그에서 비용을 로컬로 계산하며, Anthropic도 이 수치가 실제 청구 금액과 달라질 수 있다고 명확히 밝히고 있습니다. 내장 /usage 명령은 로컬에서 계산한 달러 금액이 포함된 세션 블록을 보여주지만, 문서는 이 숫자가 "may differ from the actual bill"라고 경고하고, 다른 기기와 claude.ai 사용분은 제외되며, Console Usage 페이지를 공식 기준으로 보라고 안내합니다 . 메뉴 막대는 주변 경고등처럼 보고, 청구 금액은 Console 기준으로 대조하세요.
대부분의 차이는 세 가지 실패 모드로 설명됩니다.
- 캐시 티어 오분류. 캐시 쓰기 가격은 비대칭입니다. 5분 쓰기는 기본 입력의 1.25배, 1시간 쓰기는 2배이고, 캐시 읽기는 0.1배로 내려갑니다 . 이 티어들을 뭉뚱그리는 래퍼는 구조적으로 과소 또는 과대 집계하게 됩니다. ClaudeUsageTracker가 한 턴 안의 도구 호출을 하나의 과금 이벤트로 묶는 이유도 여기에 있습니다. 단순 집계는 총액을 2~3배까지 부풀릴 수 있습니다.
- 여러 기기 사용분 누락. 로컬 JSONL 감시기는 Claude Code가 로그를 쓴 해당 기기만 봅니다. 하루 중간에 노트북을 바꾸면 메뉴 막대 총액은 실제 지출이 아니라 한 호스트의 사용분만 반영합니다.
- 모델 가격 변동. ccusage는 캐시된 LiteLLM 스냅샷에서 가격을 가져옵니다. Sonnet 5가 2026년 8월 31일까지 프로모션 가격인 $2/$10이고 9월 1일부터 $3/$15로 오르는 상황에서는 , 오래된
--offline캐시가 같은 토큰을 잘못 가격 책정합니다.
감 잡기용 기준으로 보면, Anthropic은 기업용 Claude Code 지출을 활성 개발자 1인당 하루 약 $13, 월 $150~$250 정도로 제시하며, 활성일 기준 사용자 90%는 $30 미만이라고 설명합니다 . 평범한 하루에 메뉴 막대가 $80을 가리킨다면, 청구서보다 메뉴 막대를 먼저 의심하세요. Anthropic 비용 문서 표현대로 로컬 추정치는 "may differ from actual billing"이며, 기록의 기준 원장은 Console입니다 (source: Claude Code costs docs).
더 자세한 대시보드가 필요할 때: CCSeva, CodexBar, 그 밖의 선택지
메뉴 막대 집계만으로 워크플로에 부족하다면, 같은 로컬 로그 접근법에 더 많은 분석을 얹은 네 가지 무거운 트래커가 있습니다. 실제로 봐야 하는 것이 한도 대비 비율인지, 여러 제공자의 잔액인지, 청구 정확도인지, 터미널 중심 예측인지에 따라 고르면 됩니다.
- CCSeva (Iamshankhadeep) — 색상으로 구분되는 비율 표시, Pro/Max5/Max20/Custom 전반의 플랜 자동 감지, 7일 차트, 모델별 분석, 한도의 70%와 90%에서 초과 위험 알림을 제공하는 실시간 트래커입니다 . 원시 달러보다 플랜 여유분에 연결된 경고등이 필요할 때 가장 잘 맞습니다.
- CodexBar (steipete) — macOS 14+용 멀티 제공자 앱으로, 하나의 메뉴에서 Codex, Claude, Cursor, Gemini, Copilot, Grok을 다루며 크레딧 잔액과 Admin API 지출 대시보드를 추적합니다 . 여러 어시스턴트를 함께 쓰는 스택이라면 이쪽이 맞습니다.
- ClaudeUsageTracker (masorange, v1.15.0, 2026년 3월 17일) — Homebrew cask로 설치하는 네이티브 앱으로, 한 턴 안에서 10초 미만 간격으로 발생한 도구 호출을 하나의 과금 이벤트로 묶어, 단순 호출별 집계가 만드는 2~3배 부풀림을 피합니다 . 비상업적 Personal Use License라는 점은 확인해야 합니다.
- Claude-Monitor (PyPI, v4.0.0) —
uv tool install claude-monitor로 설치하는 터미널 우선 도구이며, 실시간 예측, 공식 statusline 속도 제한 캡처, JSON/CSV 내보내기, 로컬 웨어하우스 보관 기능을 제공합니다.
핵심은 이 도구들이 회계 장부가 아니라 주변 계기판이라는 점입니다. 필요한 만큼만 가벼운 도구를 고르고, 실제 숫자는 Console에서 대조하세요.
자주 묻는 질문
cc-menubar가 사용 데이터를 어디론가 보내나요?
아니요. 핵심 수치는 사용자의 컴퓨터 밖으로 나가지 않습니다. cc-menubar는 ~/.claude/projects/에 있는 JSONL 세션 로그를 읽고 ccusage --offline을 실행해, 네트워크 호출 없이 캐시된 LiteLLM 스냅샷으로 토큰 가격을 계산합니다 . 네트워크를 쓰는 유일한 기능인 teamclaude 계정 로테이션 모니터도 http://localhost:3456의 로컬 엔드포인트를 조회할 뿐입니다 . 원격 서버가 아니라 루프백에서만 동작합니다. Anthropic API 호출도 없고 Keychain을 읽지도 않습니다.
메뉴 막대의 수치가 Anthropic Console과 다른 이유는 무엇인가요?
두 숫자의 계산 방식이 다르기 때문입니다. 로컬 추적 도구는 캐시된 LiteLLM 가격표를 사용해 JSONL 로그에서 지출을 추정하는 반면, Console은 실제 API 계량값을 반영합니다. Anthropic도 로컬 /usage 수치를 청구 금액과 다를 수 있는 추정치라고 명확히 안내합니다 . 차이가 나는 주요 원인은 캐시 쓰기 티어 차이(5분 쓰기는 기본 입력의 1.25배, 1시간 쓰기는 2배) 와, 로컬 로그에 남지 않는 다른 기기나 claude.ai 세션입니다. 메뉴 막대 합계는 주변 지표로 보고, 최종 확인은 Console에서 맞춰보세요.
SwiftBar는 무엇이고 cc-menubar에 꼭 필요한가요?
SwiftBar는 셸 스크립트의 stdout을 메뉴 막대 항목으로 바꿔주는 macOS 유틸리티입니다. ccusage.30m.sh처럼 파일명에 간격을 넣어 새로고침 주기를 정합니다 . 필요한지는 어떤 추적 도구를 선택하느냐에 따라 다릅니다. AnkMister/ccusage-menubar와 calvindotsg/cc-menubar는 SwiftBar가 필요한 플러그인이지만, sangrokjung/cc-menubar는 독립 실행형 네이티브 Swift 앱이라 SwiftBar가 필요하지 않습니다 .
ccusage와 cc-menubar는 같은 프로젝트인가요?
아닙니다. ccusage(ryoppippi 제작)는 로컬 JSONL 로그를 파싱하고 토큰 비용을 계산하는 TypeScript/bun CLI입니다. 메뉴 막대 도구들이 공통으로 사용하는 엔진에 가깝습니다. cc-menubar와 유사 도구들은 ccusage를 실행해 수치를 가져오고 메뉴 막대에 표시하는 UI 래퍼입니다 . 간단히 말해 ccusage가 계산을 맡고, cc-menubar가 위젯을 그립니다.
sangrokjung/cc-menubar용 Homebrew cask가 있나요?
출시 시점에는 없습니다. sangrokjung/cc-menubar는 소스에서 설치합니다. git clone 후 bash build.sh와 bash install.sh를 실행하는 방식이며, 아직 Homebrew cask는 없습니다 . brew install을 원한다면 이름이 비슷한 calvindotsg/cc-menubar가 이를 지원합니다. 다만 이 프로젝트는 할당량 예측에 초점을 둔 별도의 Python 코드베이스로, 이 글에서 다룬 Swift 앱과는 다릅니다 .
이 글이 도움이 되셨다면, 새 글이 올라올 때마다 이메일로 받아보세요.
