프로젝트 소개

개인 분석을 위한 Claude Code Dashboard는 Claude Code와의 상호작용 방식을 프라이빗하고 오프라인으로 확인할 수 있는 뷰를 제공합니다. 이 도구는 ~/.claude/projects/에 저장된 JSONL 세션 트랜스크립트를 읽어(수정하지 않음) 모델별 토큰 사용량, API 환산 비용, 세션 지속 시간, 도구 호출, 기술 사용 및 git 관련 세부 정보와 같은 메트릭을 추출하며, 빠른 증분 업데이트를 위해 결과를 로컬 SQLite 데이터베이스에 캐싱합니다. 경량 FastAPI 서버가 제공하는 단일 페이지 웹 인터페이스를 통해 개요 KPI, 일일 비용 차트, 모델별 토큰 점유율, 상위 도구 및 기술, 태깅 및 숨기기 제어가 가능한 프로젝트별 합계, 상세 뷰가 포함된 검색 가능한 세션 목록, 활동 히트맵(요일 × 시간), 프로젝트 태그별로 세션에 색상을 입힌 캘린더 스타일의 주간 뷰를 확인할 수 있습니다. 설정은 호스트, 포트, 인증 토큰, 데이터베이스 위치 및 내보낸 데이터의 홈 경로 선택적 편집을 위해 환경 변수나 명령줄 플래그를 통해 처리됩니다. 이 도구는 PyPI를 통해 uvx 또는 pipx로 직접 실행하거나, uv tool 또는 pipx로 영구 설치하거나, 소스 체크아웃에서 uv run python -m claude_dashboard를 사용하여 실행할 수 있습니다. 선택적 정적 내보내기 기능을 통해 로그에 대한 라이브 액세스 없이도 독립 실행형 버전을 호스팅할 수 있습니다. 모든 처리는 사용자가 서버를 신뢰할 수 있는 네트워크에 노출하거나 정적 내보내기 버전을 다른 곳에 배포하지 않는 한 사용자의 머신 내에서만 이루어집니다.