Claude Usage Tracker

Claude Usage Tracker란 무엇인가요?

Claude Usage Tracker는 여러 로컬 개발 도구에서 Claude AI 사용 비용을 자동으로 탐지하고 집계하는 로컬 우선 도구입니다. 알려진 데이터 디렉터리를 스캔하고 JSONL/로그 파일을 파싱하며, 모델별 가격을 사용해 비용을 계산한 후 결과를 인터랙티브 대시보드에 표시합니다.

핵심 목적은 비용 추적 및 시각화입니다—소스, 모델, 기간별 지출을 클라우드에 데이터를 보내지 않고 검토할 수 있습니다. 모든 작업이 로컬 머신에서 실행되며 대시보드는 Chart.js로 구동됩니다.

주요 기능

9개 이상의 Claude 통합 도구 자동 탐지하고 사용 데이터를 병합해 통합 뷰를 제공합니다.
모델별 백만 토큰당 가격으로 비용 계산 (Anthropic 모델 패밀리: Opus, Sonnet, Haiku), 입력/출력 및 캐시 읽기/쓰기 포함 (해당 시).
Chart.js를 사용한 다크 테마 인터랙티브 대시보드로 시각적 차트와 세부 분석 제공.
시간 기반 비용 추적으로 일별, 주별, 월별, 전체 기간 비용 뷰 지원.
모델 및 소스 분석으로 모델별 비용 세분화와 필터링 (소스, 모델, 날짜 범위, 최소 비용).
피크 패턴 시각화로 히트맵과 두 가지 뷰: Peak Hours (요일 × 시간 그리드) 및 Peak Days (GitHub 스타일 캘린더).
세션 수준 세부 정보로 확장 가능한 세션 로그, 색상 코딩된 소스 카드, 세션별 비용 강조 (예: 가장 비싼 세션), 세션 상세 패널 포함.
프로젝트 속도 기반 월간 예측으로 monthly projections 제공.
macOS 앱 번들 옵션으로 독립 .app을 빌드해 더블 클릭 실행 가능.

Claude Usage Tracker 사용 방법

설치 및 실행 최신 릴리스(권장) 또는 소스에서 로컬 실행.
데이터 수집 및 대시보드 렌더링 스캔 실행: macOS 앱은 신규 데이터를 수집해 인터랙티브 대시보드를 표시하고, 브라우저 모드는 로컬 서버를 시작해 dashboard.html을 로드합니다.
대시보드 검토로 총 비용을 탐색하고 차트, 히트맵, 필터를 사용해 소스/모델 및 기간별로 세분화합니다.

빠른 시작 옵션 (리포지토리에서):

macOS (Apple Silicon/Intel): 최신 릴리스 다운로드, 압축 해제, Claude Usage Dashboard.app을 Applications로 이동 후 더블 클릭 실행.
소스 빌드: 리포 클론, ./build-app.sh 실행 후 빌드된 앱 더블 클릭.
브라우저 모드 (모든 OS): node collect-usage.js 실행, python3 -m http.server 8765로 로컬 서버 시작, http://localhost:8765/dashboard.html 열기.

사용 사례

여러 Claude 도구 지출 통합: 여러 로컬 통합(Cursor, Windsurf, Claude Desktop, Continue.dev 등)을 사용 중이라면 트래커가 이들 소스의 사용 데이터를 하나의 대시보드로 병합합니다.
지출 피크 시점 파악: Peak Hours (요일 × 시간 히트맵)과 Peak Days 캘린더로 가장 비싼 사용 세션이 발생한 시간과 요일을 식별합니다.
특정 세션 또는 날짜 감사: 날짜별 세션 로그 확장으로 세션별 비용 검사, 토큰 세분화 및 대화 기록을 세션 상세 패널에서 확인합니다.
일별 변화 비교: Yesterday Delta로 오늘 지출을 어제와 한눈에 비교합니다.
현재 월 예상 계획: Monthly Projections로 현재 지출 속도 기반 월간 비용 추정치를 검토합니다.

자주 묻는 질문

트래커가 사용 데이터를 서버로 전송하나요? 아니요. 프로젝트 설명에 “No cloud” 및 “No telemetry”로 명시되어 있으며 모든 데이터가 로컬 머신에 머무릅니다.
어떤 도구를 지원하나요? 리포지토리에 OpenClaw/Clawdbot, Claude Code CLI, Claude Desktop (로컬 에이전트 모드), Cursor, Windsurf, Cline, Roo Code, Aider, Continue.dev의 Claude 사용 데이터가 나열되어 있습니다. 도구 탐지는 자동입니다.
어떤 데이터 형식을 읽나요? 알려진 디렉터리를 스캔하고 JSONL/로그 파일을 파싱합니다. 지원 도구 섹션에 나열된 각 도구에 대한 JSONL 지정.
도구가 설치되지 않았거나 사용 데이터가 없으면? 도구 탐지 동작: 도구가 설치되지 않았거나 데이터가 없으면 조용히 건너뜁니다.
비용은 어떻게 계산하나요? 지원 모델 패밀리(Opus, Sonnet, Haiku)에 대한 Anthropic의 백만 토큰당 가격을 사용해 입력/출력 및 제공된 캐시 읽기/쓰기 기반으로 계산합니다.

대안

로컬 로그 분석 + 스프레드시트: Claude 사용 로그를 내보내거나 수집해 스프레드시트에서 비용을 수동 계산하세요. 인터랙티브 대시보드보다 수동적이지만, 맞춤 워크플로에 적합할 수 있습니다.
벤더 제공 사용 대시보드 (사용 가능한 경우): 일부 제공업체가 청구/사용 보고를 위한 사용 뷰를 제공합니다. 이는 일반적으로 단일 제품/계정에 초점을 맞추며, 여러 로컬 도구 간 집계는 하지 않습니다.
일반 개발자 시간/비용 분석 도구: IDE 활동을 분석하거나 사용 이벤트 기반 비용을 계산하는 도구가 도움이 될 수 있지만, Claude 특화 토큰 가격 모델링이나 각 도구의 저장 형식을 자동 파싱하지 않을 수 있습니다.
기타 로컬 우선 모니터링 대시보드: 브라우저에서 로컬 로그를 시각화하는 유사 도구가 비슷한 차트를 제공할 수 있지만, 트래커의 자동 감지와 JSONL 파싱에 의존하지 않고 데이터를 준비해야 할 수 있습니다.