uxis-ccviz

Claude Code 세션 로그를 분석해 토큰·비용 사용 현황을 브라우저에서 시각화하는 로컬 대시보드 도구입니다.

바로 실행

npx uxis-ccviz

실행하면 브라우저에서 http://localhost:3456이 자동으로 열립니다.
종료하려면 터미널에서 Ctrl+C를 누르세요.

전역 설치

npm install -g uxis-ccviz
ccviz

주요 기능

보고서

• 시간대별·요일별 비용 분포 차트
• 절감 인사이트 카드 (캐시 히트율, 상위 세션 집중도, 긴 세션 탐지)
• AI 분석용 JSON 데이터 내보내기 + 프롬프트 예시 (Claude/ChatGPT에 바로 붙여넣기 가능)

Overview

• 일별 비용 막대 차트 — 막대 클릭 시 해당일 세션 바로 조회
• 토큰 타입 분포 도넛 차트 (Input / Output / Cache Write / Cache Read)

Sessions

• 세션 목록 테이블 (날짜, 프로젝트, 첫 메시지, 모델, 비용)
• 실시간 검색 / 날짜 필터 / 컬럼 정렬

Session Detail

• 턴별 비용 드릴다운 차트
• 질문 전체 내용 펼쳐보기 (행 클릭 시 expand)
• 도구 호출 횟수 표시

Projects

• 기간 필터 (전체 / 이번달 / 지난달 / 최근 3개월)
• 프로젝트 별칭 설정 — 인라인 편집, localStorage 저장
• 프로젝트별 비용 가로 막대 차트

데이터 소스

Claude Code가 자동으로 생성하는 로컬 JSONL 파일을 직접 읽습니다.

| OS | 경로 | |---|---| | Windows | C:\Users\{사용자}\.claude\projects\ | | macOS / Linux | ~/.claude/projects/ |

개인정보 보호

• 모든 처리는 로컬 PC에서만 이루어집니다
• 외부 서버로 데이터가 전송되지 않습니다
• 네트워크 요청: Chart.js CDN 로드 1회가 전부입니다

비용 주의사항

입력 토큰은 이전 대화 전체를 포함한 누적 컨텍스트 값입니다.
표시 비용은 API 단가 기준 참고용 추정치입니다.
Max/Pro 구독 사용자는 실제 결제 방식이 다를 수 있습니다.

요구사항

• Node.js 18 이상

라이선스

MIT