Claude Code를 쓰다 보면 문득 궁금해집니다. “오늘 얼마나 썼지? 이번 달 비용은 얼마나 나왔을까?”
API 대시보드를 매번 열어보는 것도 귀찮고, 터미널에서 claude --stats를 치는 것도 번거롭습니다. 메뉴바에 떠 있으면서 실시간으로 토큰 사용량과 비용을 보여주는 앱이 있으면 얼마나 좋을까요?
그런 앱이 나왔습니다. AI Token Monitor — Tauri v2로 만든 가볍고 아름다운 메뉴바 앱입니다.
왜 필요할까?
Claude Code 사용자들이 겪는 공통된 문제들:
- 비용 파악이 어렵다 — 세션마다 JSONL 파일에 기록되지만, 직접 열어보기는 번거롭다
- 실시간 피드백이 없다 — “이 작업이 얼마나 비용이 들었지?”를 바로 알 수 없다
- 패턴 파악이 어렵다 — 어떤 요일에 많이 쓰는지, 어떤 모델을 주로 쓰는지 한눈에 안 보인다
AI Token Monitor는 이 문제들을 해결합니다. JSONL 파일을 파싱해서 메뉴바에서 바로 보여줍니다.
핵심 기능
1. 실시간 토큰 추적
Claude Code와 Codex의 세션 JSONL 파일을 실시간으로 파싱합니다:
- Claude Code:
~/.claude/projects/**/*.jsonl - Codex:
~/.codex/sessions/**/*.jsonl
파일이 변경되면 즉시 반영됩니다. 별도 설정 없이 앱만 켜면 됩니다.
2. 비용 계산
모델별 가격을 기반으로 자동으로 비용을 계산합니다:
- 입력/출력 토큰 단가 적용
- 캐시 히트 비율 반영
- 오늘 비용을 메뉴바 아이콘 옆에 표시
3. 시각화
7/30일 차트 — 일일 토큰/비용을 막대 그래프로 활동 그래프 — GitHub 스타일 컨트리뷰션 히트맵 (2D/3D 토글) 모델 분석 — Input/Output/Cache 비율 도넛 차트 캐시 효율성 — 캐시 히트 비율 시각화
4. 리더보드
다른 사용자와 비교할 수 있습니다:
- GitHub OAuth로 로그인
- 오늘/이번 주 랭킹 확인
- 공유되는 데이터: 일일 토큰 수, 비용, 메시지/세션 수 (코드나 대화 내용은 공유 안 함)
5. 4가지 테마
GitHub (초록), Purple, Ocean, Sunset — 다크 모드 지원
기술적 깊이
아키텍처
┌──────────────────────────────┐
│ Frontend (React 19 + Vite) │
│ ├── PopoverShell │
│ ├── TabBar (3 tabs) │
│ ├── TodaySummary │
│ ├── DailyChart (SVG) │
│ ├── ActivityGraph (2D/3D) │
│ ├── Heatmap │
│ ├── ModelBreakdown │
│ ├── CacheEfficiency │
│ └── Leaderboard │
├──────────────────────────────┤
│ Backend (Tauri v2 / Rust) │
│ ├── JSONL Session Parser │
│ ├── File Watcher (notify) │
│ ├── Tray Icon + Cost Display │
│ └── Preferences (JSON) │
├──────────────────────────────┤
│ Data Sources │
│ ├── ~/.claude/projects/ │
│ │ └── **/*.jsonl │
│ └── ~/.codex/sessions/ │
│ └── **/*.jsonl │
└──────────────────────────────┘Tauri v2를 써서 번들 크기를 최소화했습니다. React 19 + Vite로 프론트엔드를 구성하고, Rust로 백엔드를 처리합니다.
파일 워처 — notify 크레이트로 JSONL 파일 변경을 감지합니다. 파일이 수정되면 즉시 파싱해서 UI에 반영합니다.
오프라인 우선 — 리더보드를 쓰지 않으면 완전히 오프라인으로 동작합니다. 네트워크 요청이 없습니다.
왜 JSONL 파싱인가?
Claude Code와 Codex는 모든 세션을 JSONL 형식으로 저장합니다. API를 호출하는 대신 로컬 파일을 파싱하면:
- 네트워크 지연 없음 — 즉시 반영
- API 호출 비용 없음 — 완전 무료
- 프라이버시 보장 — 데이터가 로컬에만 있음
실제 사용 시나리오
1. 일일 비용 체크
메뉴바를 보면 오늘 비용이 바로 보입니다. “$2.34” 이런 식으로. 클릭하면 상세 대시보드가 열립니다.
2. 주간 패턴 파악
활동 그래프를 보면 어떤 요일에 많이 쓰는지 한눈에 알 수 있습니다. “월요일에 집중적으로 쓰는구나” 같은 인사이트를 얻을 수 있습니다.
3. 모델 사용 분석
Input/Output/Cache 비율을 보면 캐시를 얼마나 잘 활용하고 있는지 알 수 있습니다. 캐시 히트율이 낮으면 프롬프트 구조를 조정해볼 수 있습니다.
4. 다른 사용자와 비교
리더보드를 통해 “나는 많이 쓰는 편인가?”를 객관적으로 알 수 있습니다. (물론 많이 쓴다고 나쁜 건 아닙니다 🙃)
설치 및 사용법
다운로드
GitHub Releases에서 받으세요:
| 플랫폼 | 파일 | 비고 |
|---|---|---|
| macOS (Apple Silicon) | .dmg | Intel Mac 지원 예정 |
| Windows | .exe 인스톨러 | Windows 10+ (WebView2 필요, 자동 설치) |
실행
- 앱 실행 — 시스템 트레이에 아이콘이 나타납니다
- 아이콘 클릭 — 대시보드가 열립니다
- Overview, Analytics, Leaderboard 탭 전환
설정
톱니바퀴 아이콘 클릭:
- 테마: GitHub / Purple / Ocean / Sunset
- 숫자 형식: Compact (377.0K) vs Full (377,000)
- 트레이 비용: 메뉴바에 오늘 비용 표시 여부
- 리더보드: 사용량 데이터 공유 + GitHub 로그인
마치며: 비용 관리의 새로운 기준
AI Token Monitor는 단순한 모니터링 도구가 아닙니다. Claude Code와 Codex를 쓰는 개발자들에게 비용 인식의 변화를 가져옵니다.
“얼마나 썼지?” → 메뉴바 확인 → “아, 이 작업이 이 정도였구나” → 패턴 파악 → 최적화
이 피드백 루프가 자연스럽게 형성됩니다.
Tauri v2로 만들어져 가볍고, React 19로 만들어져 반응이 빠르고, Rust로 만들어져 안정적입니다. 완전히 오픈소스(MIT)라서 직접 수정해서 쓸 수도 있습니다.
Claude Code를 자주 쓰신다면, 한 번쯤 설치해보세요. 메뉴바에 뜨는 숫자가 생각보다 의미 있을 겁니다.