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]
[Tool] Herdr · Rust로 작성된 단일 바이너리의 터미널 네이티브 에이전트 멀티플렉서. tmux식 세션 유지와 패널 분할에 에이전트 상태 추적(idle, working, blocked, done)을 더해, Claude Code를 포함한 여러 CLI 에이전트를 한 화면에서 관리합니다. Herdr는 Claude Code를 자동 감지해 직접 통합(direct integration) 설치 프롬프트를 띄우고, 승인하면 풀 상태 감지, 로컬 소켓 API를 통한 시맨틱 상태 전달, 재시작 후 에이전트 세션 복원이 동작합니다.
tool · claudekit.io / tools / herdr
[02]
[Tool] CC Workflow Studio · 캔버스 위에서 AI 에이전트 워크플로를 시각적으로 설계해, Claude Code·Cursor·Copilot 등 에이전트가 바로 실행할 수 있는 Markdown(skills·commands·agents)으로 내보내는 VS Code 익스텐션. MCP 서버가 내장돼 'Edit with AI'로 자연어 수정도 가능.
tool · claudekit.io / tools / cc-wf-studio
[03]
[Skill] Find Skills · 사용자가 "X 하는 방법 알려줘" 같은 질문을 하면 자동 활성화되어, 오픈 에이전트 스킬 생태계에서 적합한 스킬을 검색·설치하도록 안내하는 메타 스킬.
tool · claudekit.io / tools / find-skills
§ 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 라이선스입니다.