CodeBurn — AI 코딩 토큰·비용 로컬 관측 도구 (getagentseal/codeburn)

고정 커밋 c9dab7de…(main HEAD와 일치 확인) 기준 정적 검사 요약. 빌드·테스트는 실행하지 않았고 기능 서술은 README(원본 캡처)에 근거한다. 수치는 수집 시점 관측값.[unverified]

개요

CodeBurn은 Claude Code, Codex, Cursor, Gemini CLI 등 지원 AI 코딩 도구가 디스크에 남긴 세션 파일(JSONL·SQLite·protobuf 등)을 읽기 전용으로 파싱해 토큰 사용량과 비용을 로컬에서 분석하는 무료 오픈소스 도구다(라이선스 MIT). 래퍼·프록시·API 키 없이 동작하며 실행 결과를 외부로 보내지 않는다. 청구서가 알려주지 않는 것 — 대화에 태운 돈, 싼 모델이 원샷했을 작업을 비싼 모델이 태운 돈 — 을 도구·모델·프로젝트·작업 단위로 분해해서 보여준다는 것이 핵심 가치다. 가격표는 LiteLLM 데이터를 24시간 로컬 캐시로 사용한다.[1]

초판 노트(2026-04-15) 시점에는 Claude Code·Codex 중심의 TUI였으나, 현재는 저장소가 AgentSeal 조직에서 getagentseal로 이전(구 URL HTTP 301 확인)되고 지원 도구가 크게 확장됐다. 이 페이지는 2026-08-23 고정 커밋 기준으로 전면 갱신한 것이다.

네 가지 표면

같은 로컬 데이터를 네 UI가 읽는다(“Four surfaces, one source of truth”).[1]

터미널 TUI — npx codeburn. 화살표로 기간 전환, q 종료.
웹 대시보드 — codeburn web → http://localhost:4747. 차트 기반, localhost 바인딩만.
메뉴바/트레이 — macOS codeburn menubar(네이티브 Swift 앱 다운로드), Windows .msi 트레이 앱, Linux는 GNOME Shell 확장(GNOME 45+).
데스크톱 앱 — macOS(dmg)/Windows(Microsoft Store)/Linux(deb·rpm·AppImage) 배포.

주요 기능

낭비 진단(optimize) — 반복 재독파일, 낮은 Read:Edit 비율, 무제한 bash 출력, 안 쓰는 MCP 스키마 오버헤드, ~/.claude/의 유령 에이전트·스킬, 비대한 CLAUDE.md(@-import 포함), 캐시 생성 오버헤드 등을 스캔. 결과는 Fix now/Habits/FYI로 분류되고 A–F 헬스 등급으로 요약된다.[1]
수정 적용과 감사(--apply, act) — 설정류 발견사항을 대화형 적용. 모든 변경은 저널+백업 후 적용되며 act undo로 되돌리고, 3일 후 act report가 추정 절감액과 실측을 대조해 “worked / under estimate / did not help” 판정을 남긴다. --auto-revert는 효과 없던 수정을 자동 철회한다.[1]
예산 가드(guard) — Claude Code에 opt-in 훅 설치: 소프트캡(기본 $5 경고), 하드캡 ($ 15 세션 중단, guard allow 해제), 체크포인트($3, 편집·커밋 없이 끝나면 재시작 권고). 훅은 fail-open.[1]
모델 비교(compare) — one-shot rate, retry rate, self-correction, 호출당·편집당 비용, 캐시 적중률 등을 모델별 나란히 비교.[1]
성과 추적(yield) — 세션과 git 커밋을 타임스탬프 창으로 연결해 Productive/Reverted/Abandoned/Ambiguous로 분류(휴리스틱, methodology: timestamp-window).[1]
MCP 서버(codeburn mcp) — stdio MCP로 get_usage·get_savings 두 도구를 에이전트에 노출. 프로젝트명은 기본 가명화, 명시적 요청 시에만 실명.[1]
기타 — 월간 요약(overview, 파이프 친화적), CSV/JSON export, 기기 간 PIN 페어링 합산(devices), 구독 플랜 추적(plan), 162개 통화(Frankfurter 환율), 모델 별칭·가격 오버라이드, 팀 텔레메트리 sync(프리뷰).[1]

지원 도구와 데이터 읽기

README 기준 37개(설명란)~41개(본문) 도구·에이전트를 자동 감지하며, src/providers/ 아래 TypeScript 프로바이더 파일 46개가 정적으로 관측됐다(공용 파서 모듈 포함 집계 차이). 각 프로바이더 문서(docs/providers/*.md)가 데이터 위치·형식·특이점을 문서화한다.[1]

Claude Code ~/.claude/projects/**/*.jsonl(실제 토큰 수), Codex ~/.codex/sessions/**/rollout-*.jsonl(token_count 이벤트), Gemini CLI(실측), OpenCode(SQLite, 서브태스크 제외) 등은 실측값 기반.
Cursor는 SQLite state.vscdb에서 입력 토큰만 실측(출력은 추정), Kiro·Copilot 일부 소스는 길이 기반 추정 — README가 추정치임을 명시한다. Vercel AI Gateway만 클라우드 리포팅 API 연동(자격증명 없으면 자동 생략).[1]
메시지 dedupe(Claude는 API 메시지 ID, Codex는 누적 토큰 교차검증 등)로 이중 계산을 방지한다.[1]

아키텍처 (정적 검사)

npm 패키지 codeburn v0.9.20, bin.codeburn = dist/cli.js, Node ≥22.13(엔진 제약 관측). Zed·DeepSeek Harness 파서는 Node 22.15+(내장 zstd) 필요.[1][2]
빌드 tsup, 테스트 vitest(30s timeout). 작업 분류기는 LLM 호출 없이 도구 사용 패턴+키워드로 13개 카테고리를 결정적으로 부여(Coding/Debugging/Feature Dev/Refactoring/Testing/Exploration/Planning/Delegation/Git Ops/Build-Deploy/Brainstorming/Conversation/General).[1]
외부 조회는 LiteLLM 가격표(24h 캐시, Claude·GPT-5 계열은 하드코딩 폴백)와 Frankfurter 환율뿐이라는 것이 README의 프라이버시 서술이다. One-shot rate는 파일 단위 재편집 사이클(Edit→Bash→Edit 같은 파일)로 측정한다.[1]

버전·라이선스·출처

라이선스: MIT (LICENSE, 1,066 bytes). AgentSeal 오픈소스 프로젝트이며 코드버.hu와 무관하다고 명시.[2]
버전: npm 0.9.20; 릴리스는 서피스별 태그(windows-v0.9.20 2026-08-18, desktop-v0.9.20) 운영 — 단일 latest 태그 체계가 아니다.[3]
수집 시점 관측값: stars 9,611 · forks 766 · TypeScript · homepage https://codeburn.app · created 2026-04-13.[2]

정적 검사 한계

빌드·테스트·실실행 없음. 기능 동작은 README 서술에 의존하며 confidence: medium.
“41 tools”는 마케팅 수치로, 프로바이더 파일 수(46)와 1:1 대응하지 않는다. Cursor 등 일부 수치는 도구 자체가 추정치임을 README가 인정한다.[1]

위키 내 기록

2026-04-15 초판: Claude Code·Codex 2종 관측 TUI로 요약. 이후 저장소 성장으로 본 페이지가 대체함.
서드파티 관점: 2026-07-30-pytorchkr-topic-11469-codeburn-ai-36 — PyTorchKR 9bow의 36종 지원 시절 소개 글 노트(원문 그대로의 별도 출처).
유사 영역 도구: 2026-05-01-tokscale 등 토큰 어카운팅 계열과 비교 가능.

Sources

[1] https://github.com/getagentseal/codeburn — README (고정 커밋 c9dab7de…, 원본 캡처: raw/articles/2026-08-23-github-getagentseal-codeburn.md) [2] https://api.github.com/repos/getagentseal/codeburn — GitHub REST API (stars/forks/license/homepage/created, 2026-08-23 수집) 및 LICENSE [3] https://api.github.com/repos/getagentseal/codeburn/releases/latest — 릴리스 태그 확인 (windows-v0.9.20)

description	37~41개 AI 코딩 도구의 디스크 세션 파일을 프록시 없이 읽어 토큰·비용을 도구·모델·프로젝트·작업별로 분해하고 optimize·guard·compare·yield로 낭비를 줄이는 오픈소스 관측 도구.
tags	ai-coding, claude-code, codex, cli, productivity
aliases	codeburn, CodeBurn, AgentSeal codeburn

LLM Wiki

탐색기