← cd ..

배경

Claude Code를 쓰다 보면 지금 사용량이 얼마나 남았는지 궁금해집니다. 그런데 확인하려면 매번 웹이나 앱에 접속해야 했고, 사용 패턴을 실시간으로 파악할 방법이 없었습니다.

해결 방법

그래서 macOS 메뉴바 앱 SPRT를 만들었습니다. 메뉴바를 클릭하면 현재 세션량과 주간 한도가 바로 보입니다.

Claude Code Session Monitor

공식 API 기반으로 동작

로컬에 저장된 Claude Code OAuth 인증 정보로 Anthropic API에서 실시간 사용량을 가져옵니다. 활동 데이터는 로컬 ~/.claude/projects/ JSONL 파일을 파싱하며, 데이터가 외부로 전송되지 않습니다.

공식 API 기반으로 동작

주요 기능

사용량 관리에 필요한 기능을 메뉴바 하나에 모았습니다.

  • 실시간 속도 제한: 현재 사용률과 리셋 카운트다운을 실시간으로 확인하고, 제한에 가까워지면 경고
  • 주간 사용량: All Models, Sonnet 주간 사용량을 모니터링하여 남은 용량을 정확히 파악
  • 7일 활동 차트: 지난 7일간의 일별 메시지 수와 시간대별 사용 패턴을 한눈에 파악
  • 메뉴바 상주: 클릭하면 간단한 팝오버, 더블클릭하면 전체 대시보드

사용량 관리 기능

눈여겨볼 점

  • Claude Code 사용량이라는 "우리 조직만의 문제"를 발견하고 직접 해결한 점이 인상적입니다. AI 도구 도입이 늘수록 사용량 가시성은 비용 관리의 기본 전제가 됩니다.
  • Tauri 2 + React 19 + TypeScript + Rust 조합의 네이티브 앱으로, 별도 창 없이 메뉴바에서 바로 확인할 수 있습니다. 개발자 워크플로우를 방해하지 않는 UX 설계입니다.
  • OAuth API 기반 실시간 모니터링에 시간대별 사용 패턴 분석까지 제공합니다. 단순 대시보드가 아니라 데이터 기반 의사결정을 지원하는 도구입니다.