CodeBurn - AI 코딩 도구 토큰 사용량/비용 추적 TUI 대시보드 완벽 가이드

CodeBurn - AI 코딩 도구 토큰 사용량/비용 추적 TUI 대시보드 완벽 가이드

AI 코딩 도구가 많아지면서 한 가지 불편한 점이 생겼습니다. Claude Code, Codex, Cursor, OpenCode — 도구마다 다른 방식으로 토큰을 소모하고, 비용은 늘 관리자에게 떠넘겨지죠. 결국 한 달이 끝나고 나서야 "어? 이게 왜 이렇게 비싸지?"라는 반응이 나오는 게 현실입니다.

CodeBurn은 바로 이 문제를 해결하는 오픈소스 TUI 도구입니다. 로컬에서 동작하며, 별도의 프록시나 API 키 없이 AI 코딩 세션의 토큰 사용량과 비용을 추적합니다.

CodeBurn이란?

CodeBurn은 18개 AI 코딩 도구의 토큰 사용량과 비용을 실시간으로 추적하는 대화형 TUI 대시보드입니다. GitHub Trending에 등장한 이 도구는 개발자 AgentSeal이 만들었으며, 다음과 같은 특징이 있습니다:

• 로컬 전용 동작: 데이터가 외부로 전송되지 않음

• 별도 API 키 불필요: 세션 파일을 직접 읽어 분석

• LiteLLM 기반 가격 산정: 정확한 비용 계산

• 18개 도구 지원: Claude Code, Codex, Cursor, OpenCode, Pi, GitHub Copilot 등

설치 방법

CodeBurn은 Python 기반으로 만들어졌으며, pip를 통해 간단하게 설치할 수 있습니다.

pip install codeburn

또는 최신 기능을 원한다면 GitHub에서 직접 클론할 수도 있습니다.

git clone https://github.com/getagentseal/codeburn.gitcd codeburnpip install -e .

설치가 완료되면 터미널에서 codeburn 명령어를 실행하면 대시보드가 시작됩니다.

지원되는 AI 코딩 도구

CodeBurn이 추적할 수 있는 도구 목록은 다음과 같습니다:

도구	제공자	특징
Claude Code	Anthropic	에이전트 코딩
Codex	OpenAI	CLI 기반 코딩
Cursor	Cursor	AI 코드 에디터
OpenCode	OpenAI	오픈소스 코딩 에이전트
Pi	Pi AI	코딩 어시스턴트
GitHub Copilot	Microsoft	IDE 내 코딩 지원

핵심 기능 살펴보기

1. 태스크 유형별 비용 분석

CodeBurn의 가장 큰 강점은 13개 태스크 카테고리로 비용을 구분한다는 점입니다. 예를 들어 대화 오버헤드(conversational overhead)가 전체 비용의 56%를 차지하고, 실제 코딩 활동은 21%에 불과하다는 놀라운 사실이 밝혀졌습니다.

이 데이터가 의미하는 바는 명확합니다. 불필요한 질문이나 디버깅 대화를 줄이면 그만큼 비용을 절감할 수 있다는 것이죠.

2. 모델별 비교 기능

여러 AI 모델의 성능과 비용을 나란히 비교할 수 있습니다. 어떤 모델이 특정 작업에 더 효율적인지, 비용 대비 어느 정도의 결과를 내는지를 한눈에 확인할 수 있습니다.

3. 원샷 비율 추적

한 번의 요청으로 해결된 작업과 여러 번의 요청이 필요했던 작업을 구분하여 보여줍니다. 이를 통해 비효율적인 작업 패턴을 발견하고 개선할 수 있습니다.

4. 낭비 감지 기능

토큰을 불필요하게 많이 소모하는 세션을 감지해 줍니다. "이 세션은 왜 이렇게 많은 토큰을 사용했을까?"라는 의문을 잠재우는 데 도움이 됩니다.

5. 프로젝트별 분석

어떤 프로젝트에서 가장 많은 AI 비용이 발생했는지 확인할 수 있습니다. 클라이언트 작업과 개인 프로젝트의 비용을 분리 관리할 수 있어 정산이 쉬워집니다.

실전 사용 예제

CodeBurn을 실행하면 먼저 요약 대시보드가 나타납니다. 전체 비용, 토큰 사용량, 주요 통계가 한 화면에 표시됩니다.

codeburn

화살표 키로 탐색하며, 세부 카테고리로 들어가면 더 세밀한 데이터를 확인할 수 있습니다. 특정 세션이나 프로젝트만 필터링하여 보고 싶은 경우도 있습니다.

# 특정 프로젝트만 분석codeburn --project my-app# 특정 모델만 필터링codeburn --model claude-3-5-sonnet

대안 도구들과의 비교

CodeBurn 외에 AI 비용을 추적하는 방법은 여러 가지가 있습니다.

도구	장점	단점
CodeBurn	로컬 동작, 다중 도구 지원, 오픈소스	CLI 숙지 필요
LiteLLM 대시보드	웹 UI, 상세 분석	프록시 필요
직접 로그 분석	커스터마이징 가능	시간 소요, 오류 발생

CodeBurn의 가장 큰 차별점은 단순함입니다. 별도의 서버나 설정 없이 터미널에서 바로 사용할 수 있습니다.

정리

AI 코딩 도구를 본격적으로 활용하는 시대, 토큰 비용을가시화하는 것은 선택이 아닌 필수입니다. CodeBurn은 그 첫걸음을 돕는 훌륭한 도구입니다.

특히 개인 개발자나 소규모 팀에서 "AI 도구 비용이 불어나고 있다"는 느낌을 받고 있다면, CodeBurn으로 현황을 파악해 보시기를 권합니다. 무료이고, 설치가 간단하며, 로컬에서 동작하므로 보안 걱정도 없습니다.

CodeBurn이 적합한 사람:

• 여러 AI 코딩 도구를 병행 사용하는 개발자

• 팀 전체의 AI 비용을 관리해야 하는 리더

• 개인 프로젝트에서 AI 도구 비용을 최적화하고 싶은 프리랜서

CodeBurn이 불필요한 사람:

• 하나의 AI 도구만 제한적으로 사용하는 경우

• 이미 비용 분석 시스템이 갖춰져 있는 기업

tags: AI, 코딩도구, 토큰추적, 비용관리, Claude Code, Cursor, GitHub Copilot, TUI, 오픈소스, 개발생산성

---

📚 출처

• GitHub - getagentseal/codeburn

• Unpacking Codeburn: Your Dashboard for AI Coding Cost Insights

• CodeBurn: See Where Your AI Coding Tokens Go - PyShine

---

📚 출처

• https://news.hada.io/topic?id=29343