클로드리틱스: 클로드 코드 토큰 사용량 및 비용 추적을 위한 셀프 호스팅 대시보드

Claudlytics의 기능

Claudlytics는 Claude Code 토큰 사용량과 비용을 실시간으로 추적하는 셀프 호스팅 대시보드입니다. 데스크톱 앱의 로컬 머신 추적이 충분하지 않은 원격 VPS나 서버에서 Claude Code를 헤드리스로 실행하는 개발자에게 특히 유용합니다.

작동 방식

Claude Code는 모든 대화를 ~/.claude/projects/**/*.jsonl 파일에 기록합니다. Claudlytics는 이 파일들을 읽어 토큰 사용량을 파싱하고 Sonnet 4.6 가격을 사용해 비용을 계산합니다. 기본 사용에는 Claude API 호출이 필요하지 않습니다 — 모든 처리가 로컬에서 이루어집니다.

대시보드 기능

• 현재 세션 토큰 수와 비용
• 롤링 5시간 창 사용량 및 재설정 카운트다운 (Claude Pro/Max 세션 제한과 일치)
• 오늘 / 지난 7일 / 청구 주기별 분석
• 세션 및 주간 메시지 수

설정 및 설치

설정에는 세 가지 명령어가 필요합니다:

git clone https://github.com/iansugerman/Claudlytics.git
cd Claudlytics
node server.js

이 명령어들을 실행한 후 브라우저에서 http://localhost:3031을 열어주세요.

보안 및 원격 접근

서버는 127.0.0.1에만 바인딩되므로 공개적으로 노출되지 않습니다. 원격 서버 접근을 위해서는 SSH 터널을 사용하세요:

ssh -L 3031:localhost:3031 user@your-server

그런 다음 로컬 머신에서 localhost:3031로 브라우징하세요.

프로덕션 배포

Claudlytics는 백그라운드 가용성을 위해 systemd 서비스로 실행할 수 있습니다. 전체 지침은 GitHub 저장소의 README에서 확인할 수 있습니다.