CodeBurn

25개 코딩 CLI의 토큰·비용을 로컬에서 보여주는 인터랙티브 TUI 대시보드

npx codeburn

Claude Code·Codex·Cursor를 비롯한 25개 AI 코딩 도구가 디스크에 남긴 세션 기록을 읽어 토큰과 비용을 한 화면에 모으는 TUI 대시보드입니다. 프록시나 API 키 없이 로컬 파일만 읽고, 가격은 LiteLLM 엔진으로 계산합니다.

판단

이럴 때 씁니다

  • Claude뿐 아니라 Codex·Cursor·Copilot 등 여러 코딩 도구를 함께 쓰고 그 비용을 한 화면에서 보고 싶을 때.
  • 프록시·API 키 없이 로컬에서만 사용량을 집계하고 싶을 때.
  • 모델 비교나 최적화 분석 같은 인터랙티브 화면으로 비용 구조를 파고들고 싶을 때.
  • 메뉴바 앱으로 상시 비용을 띄워 두고 싶을 때.

이럴 땐 쓰지 마세요

  • 일부 도구의 토큰은 추정값입니다. Cursor Auto·Copilot·Kiro·Warp는 실제 모델·토큰이 노출되지 않아 단가나 길이로 추정하니, 정산용 단일 진실로 쓰긴 이릅니다.
  • Claude 사용량만 기간·과금창 단위로 깊게 보려면 ccusage가 더 결에 맞을 수 있습니다.
  • 비용을 줄여 주지는 않습니다. 어디서 새는지 보여줄 뿐이라 절감은 RTK·라우터와 짝지어야 합니다.

차별점

  • Claude Code 하나가 아니라 25개 코딩 도구(Codex·Cursor·Copilot·Gemini CLI·OpenCode 등)의 사용량을 한 대시보드에 모읍니다. p 키로 공급자를 전환합니다.
  • 프록시도 API 키도 없이 디스크의 세션 기록(JSONL·SQLite·JSON)만 직접 읽습니다. 전부 로컬에서 돕니다.
  • 가격은 LiteLLM 엔진으로 모든 모델을 계산하고, Claude·GPT는 하드코딩 폴백을 둬 오산정을 막습니다.
  • 모델 비교(c)·최적화 분석(o)·기간 단축키(1~5)를 갖춘 인터랙티브 TUI입니다. 메뉴바 앱과 162개 통화 표시도 지원합니다.

워크플로

  1. 01npx codeburn으로 설치 없이 바로 대시보드를 띄웁니다(또는 npm install -g codeburn).
  2. 02화살표로 기간을 넘기고, p로 도구를 전환해 어느 도구가 얼마를 쓰는지 봅니다.
  3. 03c로 모델별 비용을 비교하고, o로 최적화 여지를 분석합니다.
  4. 04codeburn report -p 30days처럼 기간을 지정해 리포트를 뽑습니다.

주요 명령

명령설명
codeburn인터랙티브 대시보드를 띄웁니다
codeburn today오늘 사용량을 봅니다
codeburn report -p 30days최근 30일 리포트를 출력합니다

함정

설치 전에 확인하세요

  • Cursor가 Auto 모드로 실제 모델을 숨기면 토큰을 Sonnet 단가로 추정합니다. 큰 데이터베이스는 첫 실행에 1분가량 걸릴 수 있습니다.
  • GitHub Copilot은 VS Code 기록에 토큰 수가 없어 글자 길이로 추정합니다. Kiro·Warp 등 일부 도구도 모델 미노출 시 추정값입니다.
  • Claude 설정 디렉터리가 여러 개면 CLAUDE_CONFIG_DIRS에 OS 구분자로 경로를 묶어야 세션이 합쳐집니다.

직접 써본 메모

여러 코딩 도구를 갈아 쓰는 사람에게 값이 큽니다. Claude Code 하나만 본다면 ccusage로도 충분하지만, Codex·Cursor·Copilot까지 섞어 쓰면서 '이번 달 코딩에 도대체 얼마를 썼나'를 한 화면에서 보려면 25개 도구를 한데 모으는 폭이 유리합니다.

프록시 없이 디스크 기록만 읽는다는 설계는 회사 코드를 다루는 환경에서 특히 중요합니다. 사용 데이터를 밖으로 내보내지 않고, API 키도 요구하지 않습니다.

숫자를 절대값으로 믿기 전에 한 가지는 짚어야 합니다. 모든 도구가 토큰을 정직하게 노출하지는 않습니다. Cursor가 Auto로 모델을 가리거나 Copilot처럼 기록에 토큰 수가 없는 경우엔 단가나 글자 길이로 추정하므로, 추세를 보는 데는 충분해도 정산서로 쓰기엔 이릅니다.

비교

ccusage가 주로 Claude 계열 사용량을 기간·과금창 단위로 집계하는 데 집중한다면, CodeBurn은 25개 도구로 폭을 넓히고 모델 비교·최적화 분석 같은 인터랙티브 화면을 더했습니다. 둘 다 로컬 파일만 읽어 데이터를 밖으로 보내지 않는 점은 같습니다. 비용을 줄이는 RTK·라우터와 달리 어디서 새는지를 보여주는 계측 쪽입니다.

최근 변경

v0.9.19에서 집계 경로와 장기 기록을 통합하고 Quick·Kimi 공급자, 대형 로그 파싱 성능과 동시성 캐시를 개선했다.

공식 변경 내역