codeburn
무엇인가
CodeBurn은 AI 코딩 도구가 남긴 세션 로그를 사후에 분석하는 비용 관측 도구다. 코드를 생성하거나 요청을 중계하지 않고, 이미 끝난 세션을 읽기만 한다. 청구서가 주지 않는 모델·프로젝트·작업 단위 귀속 정보를 만드는 것이 목적이다.
어떻게 동작하나
동작 방식은 파일 읽기다. Claude Code, Cursor, Codex, Gemini, Grok 등 지원 도구가 디스크에 기록한 세션 파일을 직접 파싱한다. Cursor와 OpenCode는 SQLite 세션을 쓰며 better-sqlite3가 자동 설치된다. 모델 단가표는 LiteLLM에서 가져와 매일 갱신한다. 터미널 대시보드, 웹(codeburn web), macOS 메뉴바·Windows 트레이 앱, 데스크톱 앱이 모두 같은 세션 파일을 읽는다.
무엇과 다른가
제공자 청구 대시보드와의 차이는 귀속 단위다. 청구서는 총액과 모델별 합계까지만 보여주는 반면, CodeBurn은 세션을 작업·모델·도구·프로젝트로 쪼갠다. 요청 경로에 끼어드는 프록시나 게이트웨이가 아니므로 트래픽을 가로채지 않고 API 키도 요구하지 않는다. codeburn optimize는 ~/.claude/ 설정까지 스캔해 세션 간 재읽기, 낮은 Read:Edit 비율, 상한 없는 bash 출력, 호출되지 않는 MCP 서버의 스키마 오버헤드 같은 낭비 패턴을 찾아 A~F 등급으로 요약한다.
어떻게 쓰나
실행은 npx codeburn 한 줄로 시작한다. 오늘 사용량이 없으면 최근 7일을 보여주는 대화형 대시보드가 열리고, 화살표 키로 기간을 바꾸고 q로 종료한다. codeburn overview는 복사해 붙일 수 있는 텍스트 요약을 출력하며 비터미널 출력에서는 색이 자동으로 빠진다. codeburn optimize --apply는 설정 계열 발견 사항을 백업·저널링한 뒤 적용하고, codeburn act list와 codeburn act undo <id>로 되돌린다. codeburn menubar는 메뉴바·트레이 상주 앱을 설치한다.
전제와 한계
전제 조건은 Node.js 22.13+와 디스크에 세션 데이터를 남긴 지원 도구 하나 이상이다. 세션 파일이 없는 도구는 집계 대상이 되지 않는다. 비용 계산의 정확도는 LiteLLM 단가표 갱신에 의존한다. 데스크톱 앱은 사용자가 동의할 때만 익명·구간화된 사용 보고를 보낸다. act undo는 적용 이후 파일이 바뀌었으면 --force 없이는 거부하고, act report는 적용한 수정이 3일 이상 지나야 추정 절감액을 실제 사용량과 비교한다.