Iamshankhadeep/ccseva

해결하는 문제

CCSeva는 Claude Code 사용자가 토큰 소비량, 비용, 서버 측 사용 제한을 실시간으로 추적할 수 있도록 도와주는 가벼운 macOS 메뉴바 앱입니다. 수동으로 제한을 확인할 필요 없이 5시간 세션 블록과 주간 사용량에 대한 즉각적인 시각화를 제공합니다.

작동 방식

이 앱은 Swift와 SwiftUI로 네이티브로 구현되어 메뉴바 전용 앱으로 실행됩니다. 로컬의 ~/.claude 트랜스크립트(JSONL 파일)를 직접 분석하여 사용량을 계산합니다. 또한 Claude Code의 OAuth 사용량 엔드포인트를 읽어 '서버 진실' 기반의 제한 게이지 제공하며, 엔드포인트에 접근할 수 없을 경우 로컬 추정값을 백업으로 사용합니다.

대상 사용자

터미널을 떠나지 않고, 무거운 런타임 종속성 없이 API 비용과 토큰 소모 속도를 모니터링하고 싶은 macOS 사용자 및 개발자.

주요 기능

• 실시간 메뉴바 추적: macOS 메뉴바에 색상으로 구분된 상태로 사용률을 표시합니다.
• 서버 진실 기반 게이지: 다른 디바이스의 사용 포함, 5시간 및 주간 사용량을 추적하고 예측된 종료 시각을 제공합니다.
• 네이티브 성능: 런타임 종속성 없이 약 3MB의 앱 번들입니다 (Electron 또는 Node.js 없음).
• 세부 분석: Swift Charts를 사용해 모델별 및 프로젝트별 비용 분해를 제공합니다.
• 네이티브 알림: 사용률이 70% 및 90%에 도달했을 때 사용자에게 알림을 제공합니다.
• 선택적 동기화: claudecode.directory와 동기화하여 개인 사용 현황 대시보드를 활용할 수 있습니다.