Claude Code Usage Monitor for macOS - 메뉴바에서 클로드 토큰 사용량 실시간 모니터링

 

Claude Code를 쓰다 보면 토큰 사용량이 궁금한데, 이걸 macOS 메뉴바에서 실시간으로 볼 수 있게 해주는 앱이다. Swift로 만들어진 네이티브 macOS 앱이고, 원래 Python 버전(Claude-Code-Usage-Monitor)을 macOS용으로 포팅한 거라고 한다.

주요 기능들

실시간 모니터링

• 6초마다 업데이트
• 토큰 사용량을 색깔별로 표시 (초록/노랑/빨강)
• 메뉴바에 사용률 퍼센테이지랑 번레이트 이모지 표시

번레이트 추적

• 최근 1시간 기준으로 얼마나 빠르게 토큰을 쓰고 있는지 보여줌
• 이모지로 속도 표시:
  • 🐌 100 토큰/분 미만 (여유로움)
  • 🚶 100-300 토큰/분 (보통)
  • 🏃 300-600 토큰/분 (좀 빠름)
  • 🚗 600-1000 토큰/분 (꽤 빠름)
  • ✈️ 1000-2000 토큰/분 (빠름)
  • 🚀 2000 토큰/분 초과 (매우 빠름)

스마트 예측

• 현재 속도로 계속 쓰면 언제 토큰이 떨어질지 예측
• 플랜 자동 감지 (Pro/Max5/Max20)
• 세션 리셋 시간 표시

설치 방법

# 레포 클론  
git clone https://github.com/Sapeet/claude-code-usage-monitor-macos.git  
cd claude-code-usage-monitor-macos  

# 빌드하고 앱 번들 생성  
make bundle  

# Applications 폴더에 복사  
cp -r "output/Claude Code Usage Monitor.app" /Applications/  

어떻게 작동하나?

Claude Code가 만드는 JSONL 파일들을 읽어서 사용량을 계산한다:

• 기본 경로: ~/.claude/projects/*.jsonl
• 환경변수 CLAUDE_DATA_PATHS로 다른 경로도 설정 가능

5시간 세션 윈도우 기준으로 토큰 사용량을 추적하고, 최근 1시간 번레이트를 기반으로 예측한다.

시스템 요구사항

• macOS 13.0 이상
• Swift 5.9 이상
• Claude Code 사용 중이어야 함

생각해볼 점들

장점:

• 메뉴바에서 바로 확인 가능해서 편함
• 실시간 업데이트로 현재 상황 파악하기 좋음
• 이모지로 직관적인 속도 표시
• 네이티브 앱이라 성능 좋을 듯

단점:

• macOS만 지원 (윈도우/리눅스는 원본 Python 버전 써야 함)
• Claude Code 써야만 작동함
• 아직 개발 초기 단계인 것 같음

마무리

Claude Code 많이 쓰는 사람한테는 꽤 유용할 것 같다. 특히 토큰 사용량 신경 쓰면서 작업하는 경우에는 메뉴바에서 바로 확인할 수 있어서 좋을 듯. 다만 아직 새로운 프로젝트라 버그나 이슈가 있을 수 있으니 주의해서 써야겠다.

원본 Python 버전도 있으니 다른 OS 쓰는 사람들은 그쪽 확인해보면 될 것 같고.