Claude Code 토큰 사용량과 비용을 인터랙티브 대시보드로 시각화하는 TUI 도구. 13개 작업 카테고리 자동 분류와 원샷 성공률 추적 지원.
npx codeburn npm install -g codeburn 왜 필요한가?
Claude Code의 토큰 사용량을 확인하는 도구는 있지만, 대부분 텍스트 테이블 형태입니다. CodeBurn은 그래디언트 차트와 키보드 네비게이션이 포함된 인터랙티브 TUI 대시보드로 토큰 사용 패턴을 시각적으로 분석할 수 있게 해줍니다. 특히 작업을 13개 카테고리(코딩, 디버깅, 테스트, 리팩토링, 브레인스토밍 등)로 자동 분류하고, 편집→테스트→수정 반복 사이클을 감지하여 원샷 성공률을 측정합니다.
주요 기능
- 인터랙티브 대시보드 — 그래디언트 차트와 키보드 네비게이션으로 토큰 사용 패턴을 시각적으로 탐색
- 13개 작업 카테고리 — 코딩, 디버깅, 테스트, 리팩토링, 브레인스토밍 등 활동을 자동 분류
- 원샷 성공률 — 편집→테스트→수정 반복 사이클을 감지하여 AI 정확도 측정
- 멀티 모델 지원 — Claude(Opus/Sonnet/Haiku), GPT-4o, Gemini 등 여러 모델의 사용량 통합 추적
- macOS 메뉴 바 위젯 — SwiftBar 플러그인으로 메뉴 바에서 토큰 사용량 모니터링
- 데이터 내보내기 — CSV, JSON 형식으로 리포트 내보내기
사용법
codeburn # 인터랙티브 대시보드 (기본: 7일)
codeburn today # 오늘 사용량
codeburn month # 이번 달 사용량
codeburn status # 한 줄 요약
codeburn export # 리포트 생성알아두면 좋은 점
- API 키 불필요 —
~/.claude/projects/의 로컬 JSONL 세션 파일을 직접 읽어 분석 - 작업 분류는 LLM 호출 없이 결정적(deterministic)으로 수행되어 추가 비용 없음
- Node.js 20 이상 필요
- ccusage와 유사하지만 인터랙티브 시각화와 작업 분류에 초점
- MIT 라이선스
자주 묻는 질문
CodeBurn은 무엇인가요?
Claude Code 토큰 사용량과 비용을 그래디언트 차트와 키보드 네비게이션이 포함된 인터랙티브 TUI 대시보드로 시각화하는 도구입니다. 13개 작업 카테고리 자동 분류와 원샷 성공률 추적을 지원합니다.
어떤 환경에서 동작하나요?
Claude Code 사용 환경에서 동작하며, Node.js 20 이상이 필요합니다.
어떻게 설치하나요?
`npx codeburn`으로 설치 없이 실행하거나, `npm install -g codeburn`으로 글로벌 설치할 수 있습니다.
API 키가 필요하나요?
필요 없습니다. `~/.claude/projects/`의 로컬 JSONL 세션 파일을 직접 읽어 분석합니다. 작업 분류도 LLM 호출 없이 결정적으로 수행되어 추가 비용이 발생하지 않습니다.
ccusage와 무엇이 다른가요?
ccusage는 텍스트 테이블 위주의 사용량·비용 분석에 강점이 있고, CodeBurn은 인터랙티브 시각화와 13개 작업 카테고리 자동 분류·원샷 성공률 측정에 초점이 있습니다.
라이선스는 어떻게 되나요?
MIT 라이선스입니다.