claudekit / tools / codeburn
[ Tool · Claude Code Utilities ]

CodeBurn

Claude Code 토큰 사용량과 비용을 인터랙티브 대시보드로 시각화하는 TUI 도구. 13개 작업 카테고리 자동 분류와 원샷 성공률 추적 지원.

AgentSeal/codeburn ·updated
$ npx codeburn copy

왜 필요한가?

Claude Code의 토큰 사용량을 확인하는 도구는 있지만, 대부분 텍스트 테이블 형태입니다. CodeBurn은 그래디언트 차트와 키보드 네비게이션이 포함된 인터랙티브 TUI 대시보드로 토큰 사용 패턴을 시각적으로 분석할 수 있게 해줍니다. 특히 작업을 13개 카테고리(코딩, 디버깅, 테스트, 리팩토링, 브레인스토밍 등)로 자동 분류하고, 편집→테스트→수정 반복 사이클을 감지하여 원샷 성공률을 측정합니다.

CodeBurn 대시보드

주요 기능

  • 인터랙티브 대시보드 — 그래디언트 차트와 키보드 네비게이션으로 토큰 사용 패턴을 시각적으로 탐색
  • 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 라이선스
§ 5

See also

same category · curated
[01]
[Plugin] fluent-korean · Claude Code가 조사와 어미를 생략한 축약형 한국어 대신 의미가 분명한 문장을 출력하도록 지시하는 output-style 플러그인. 결과를 고치는 것이 아니라 시스템 프롬프트 층위에서 미리 규율합니다. 코딩 지침을 유지하는 판과 제거한 판 두 가지를 제공합니다.
tool · claudekit.io / tools / fluent-korean
[02]
[Tool] OpenViking · 에이전트의 메모리, 참고 자료, 스킬을 하나의 가상 파일시스템에 모아 두는 오픈소스 컨텍스트 데이터베이스. Claude Code에 플러그인으로 연결하면 세션이 끝나도 남는 장기 기억과 자료 검색이 생깁니다.
tool · claudekit.io / tools / openviking
[03]
[Tool] Herdr · Rust로 작성된 단일 바이너리의 터미널 네이티브 에이전트 멀티플렉서. tmux식 세션 유지와 패널 분할에 에이전트 상태 추적(idle, working, blocked, done)을 더해, Claude Code를 포함한 여러 CLI 에이전트를 한 화면에서 관리합니다. Herdr는 Claude Code를 자동 감지해 직접 통합(direct integration) 설치 프롬프트를 띄우고, 승인하면 풀 상태 감지, 로컬 소켓 API를 통한 시맨틱 상태 전달, 재시작 후 에이전트 세션 복원이 동작합니다.
tool · claudekit.io / tools / herdr
§ 6

자주 묻는 질문

자주 묻는 질문
§ 6.1
CodeBurn은 무엇인가요?
Claude Code 토큰 사용량과 비용을 그래디언트 차트와 키보드 네비게이션이 포함된 인터랙티브 TUI 대시보드로 시각화하는 도구입니다. 13개 작업 카테고리 자동 분류와 원샷 성공률 추적을 지원합니다.
§ 6.2
어떤 환경에서 동작하나요?
Claude Code 사용 환경에서 동작하며, Node.js 20 이상이 필요합니다.
§ 6.3
어떻게 설치하나요?
`npx codeburn`으로 설치 없이 실행하거나, `npm install -g codeburn`으로 글로벌 설치할 수 있습니다.
§ 6.4
API 키가 필요하나요?
필요 없습니다. `~/.claude/projects/`의 로컬 JSONL 세션 파일을 직접 읽어 분석합니다. 작업 분류도 LLM 호출 없이 결정적으로 수행되어 추가 비용이 발생하지 않습니다.
§ 6.5
ccusage와 무엇이 다른가요?
ccusage는 텍스트 테이블 위주의 사용량·비용 분석에 강점이 있고, CodeBurn은 인터랙티브 시각화와 13개 작업 카테고리 자동 분류·원샷 성공률 측정에 초점이 있습니다.
§ 6.6
라이선스는 어떻게 되나요?
MIT 라이선스입니다.