Claude Usage Dashboard — 토큰/비용 추적 도구

원문: @0xKingsKuan GitHub: phuryn/claude-usage

트윗 요약

GitHub 도구 phuryn/claude-usage 소개. Claude API 사용량 분석 도구로, JSONL 트랜스크립트에서 토큰 소비량/비용/사용 패턴을 파싱해서 localhost:8080 대시보드로 시각화. 명령어: python cli.py dashboard/today/stats/scan.

분석 결과

1. 이미 하고 있는 것 vs 없는 것

있는 것: - OpenClaw Gateway LLM 호출 로그 (JSONL, 일별) - llm_log_summary() — 일별 호출수/성공률/모델별 분류 - 웹앱 대시보드에 LLM 사용량 표시 (_load_llm_usage()) - OTel 환경변수 설정됨 (OTEL_EXPORTER_OTLP_ENDPOINT=localhost:4318)

없는 것 (핵심 갭): - Claude Code 세션별 토큰 추적 — JSONL에 데이터 있으나 수집/분석 안 함 - 실제 API 비용 추정 — Gateway는 글자수만, Claude Code 토큰 데이터 방치 중 - 캐시 토큰 분석 — cache_read 9.1M 토큰이 기록되지만 분석 안 됨 - 프로젝트별/세션별 비용 분류 — 어떤 작업에 얼마 썼는지 전혀 모름

핵심 발견: JSONL 트랜스크립트 2,844개(총 1.7GB)가 ~/.claude/projects/에 있고, 각 응답마다 input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens, model 데이터가 이미 기록돼 있는데 아무도 수집/분석하지 않고 있음.

2. 도입 가치 TOP 3

Claude Code 토큰/비용 스캐너 — JSONL 파싱 → SQLite 저장. 5-에이전트 체제이므로 session_id별 에이전트 분류 필요
기존 웹앱(3344)에 사용량 패널 통합 — 별도 포트 불필요, ops 블루프린트에 Chart.js 차트 추가
비용 알림 + 크론 연동 — 매시간 스캔, 일일 비용 임계치 초과 시 텔레그램 INFO 알림

3. 변형 아이디어

5-에이전트 통합 모니터링: 메인 세션 + 서브에이전트 + Gateway LLM + Codex를 하나의 대시보드로
캐시 효율성 분석: cache_read/create 비율 추적 → 시스템 프롬프트 구조 최적화
OTel 컬렉터 대신 SQLite: OTEL 환경변수는 설정돼 있지만 컬렉터가 없음. 우리 규모에서는 SQLite가 더 실용적

4. 도입하지 말 것

claude-usage 자체를 git clone해서 그대로 쓰는 것 → 단일 사용자 CLI, 별도 포트 중복
Pro/Max 진행률 바 → 정확한 한도 API 없음, 부정확한 게이지가 혼란
OTEL Collector 풀 인프라 → SQLite 기반이 훨씬 가벼움
실시간 자동 새로고침 → 운영 모니터링용이지 실시간 감시 화면 아님

5. 즉시 실행 가능

현재 JSONL 트랜스크립트에서 토큰 사용량 1회 분석 스크립트 실행 → 모델별 토큰 소비량 즉시 확인 가능. 이후 파이프라인 스크립트화 → 크론 → 대시보드 통합 순서로 확장.

Claude Usage Dashboard - 토큰/비용 추적 도구