Repolode
getagentseal

getagentseal/codeburn

AI 코딩 도구별 토큰 사용량과 비용을 분석하는 로컬 CLI 및 데스크톱 앱입니다.

스타
11,521
포크
969
열린 이슈
30
마지막 커밋
그저께

어떤 프로젝트인가요?

CodeBurn은 Claude Code, Codex, Cursor, Gemini CLI 같은 AI 코딩 도구가 디스크에 저장하는 세션 파일을 읽고, 모든 토큰의 비용을 계산해 지출 내역을 보여줍니다. 월별 청구서에는 총액만 표시되지만, CodeBurn은 프로젝트, 모델, git 브랜치, 작업 유형별로 비용을 세분화합니다. 작업 유형은 세션 내용을 바탕으로 추론하며, 코딩, 디버깅, 계획 등이 해당합니다.

비용 분석 외에도 매번 다시 읽는 파일이나 사용하지 않는 MCP 서버처럼 효과 없이 소비된 토큰을 찾아내는 optimize 명령어를 제공하며, 백업을 만든 뒤 설정 변경을 적용하거나 되돌릴 수 있습니다. 구독 플랜과 실시간 할당량도 추적하고, hooks를 통해 Claude Code의 지출 한도를 선택적으로 설정할 수 있습니다. 터미널 대시보드, 웹 화면, macOS 메뉴 막대 앱, Windows 시스템 트레이 앱, Linux GNOME 확장 프로그램으로 실행할 수 있습니다.

계정이나 API 키는 필요하지 않습니다. 로컬에서 실행되며, LiteLLM에서 가져와 매일 갱신하는 모델 가격 정보를 조회하는 경우 외에는 자체적으로 네트워크 요청을 보내지 않습니다. npx로 설치할 수 있는 npm 패키지이며, README에는 42개 도구 지원이 안내되어 있습니다.

핵심 기능

  • 01도구, 모델, 프로젝트, git 브랜치, 작업 유형별 지출을 분석합니다.
  • 02계정 없이 지원되는 AI 코딩 도구의 로컬 세션 파일을 읽습니다.
  • 03낭비된 토큰을 찾아내고, 백업과 함께 설정 수정 사항을 적용하거나 되돌리는 optimize 명령어를 제공합니다.
  • 04지원되는 제공업체의 구독 플랜과 실시간 할당량 한도를 추적합니다.
  • 05hooks를 통해 Claude Code의 지출 한도를 선택적으로 설정할 수 있습니다.
  • 06터미널 대시보드, 웹 대시보드, macOS 메뉴 막대, Windows 시스템 트레이, Linux GNOME 화면을 제공합니다.

활용 사례

  • AI 코딩 비용의 대부분을 차지하는 프로젝트나 브랜치를 파악할 수 있습니다.
  • 실제 사용 기록으로 모델을 비교해 더 저렴한 모델도 충분한지 확인할 수 있습니다.
  • Claude Max 또는 비슷한 구독이 실제 사용량에 맞는지 확인할 수 있습니다.
  • 사용하지 않는 MCP 서버와 모든 요청에 토큰을 추가하는 비대한 CLAUDE.md 파일을 점검할 수 있습니다.

빠른 시작

  1. 1

    npx로 바로 실행(설치나 계정 필요 없음)

    npx codeburn
  2. 2

    설치해 계속 사용하기

    npm install -g codeburn
  3. 3

    같은 수치를 브라우저에서 보기

    codeburn web

사용 전 알아둘 점

  • CLI를 사용하려면 Node.js 22.13 이상이 필요합니다.
  • 지원되는 도구가 디스크에 이미 저장하는 세션 파일만 읽으므로, 목록에 없는 도구는 표시되지 않습니다.
  • 데스크톱 앱과 메뉴 바 기능은 macOS, Windows, Linux 전용이며 별도로 설정해야 합니다.

토픽

자주 묻는 질문

codeburn은(는) 무엇인가요?
AI 코딩 도구별 토큰 사용량과 비용을 분석하는 로컬 CLI 및 데스크톱 앱입니다. CodeBurn은 Claude Code, Codex, Cursor, Gemini CLI 같은 AI 코딩 도구가 디스크에 저장하는 세션 파일을 읽고, 모든 토큰의 비용을 계산해 지출 내역을 보여줍니다. 월별 청구서에는 총액만 표시되지만, CodeBurn은 프로젝트, 모델, git 브랜치, 작업 유형별로 비용을 세분화합니다. 작업 유형은 세션 내용을 바탕으로 추론하며, 코딩, 디버깅, 계획 등이 해당합니다.
codeburn은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
codeburn은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
codeburn은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. codeburn의 마지막 커밋은 2026년 10월 17일입니다.
codeburn은(는) 어디에 사용할 수 있나요?
AI 코딩 비용의 대부분을 차지하는 프로젝트나 브랜치를 파악할 수 있습니다. 실제 사용 기록으로 모델을 비교해 더 저렴한 모델도 충분한지 확인할 수 있습니다. Claude Max 또는 비슷한 구독이 실제 사용량에 맞는지 확인할 수 있습니다. 사용하지 않는 MCP 서버와 모든 요청에 토큰을 추가하는 비대한 CLAUDE.md 파일을 점검할 수 있습니다.
codeburn는 어떻게 설치하나요?
npx로 바로 실행(설치나 계정 필요 없음): npx codeburn 설치해 계속 사용하기: npm install -g codeburn 같은 수치를 브라우저에서 보기: codeburn web
codeburn은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/getagentseal/codeburn

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트