ccburn

실시간 버닝 차트

세션, 주간, 월간 사용량을 실시간으로 업데이트되는 터미널 그래프로 시각화합니다. 차트에는 예산 페이스, 실제 사용량, 예상 사용량, 현재 시점, 소진 시점 등의 요소가 포함됩니다.

페이스 표시기

사용량이 예산 대비 어느 정도인지 이모지로 표시합니다. 🧊는 예산보다 느리게 사용 중(여유 있음), 🔥는 예산에 맞춰 사용 중, 🚨는 예산보다 빠르게 사용 중(주의 필요)을 의미합니다.

다양한 출력 모드

전체 TUI, 상태 표시줄용 한 줄 출력, 스크립트용 JSON 출력을 지원합니다. --compact 옵션으로 간결한 상태를, --json 옵션으로 자동화에 적합한 JSON을 얻을 수 있습니다.

상태 표시줄 통합

ccburn collect 명령을 Claude Code의 statusline에 파이프하여 추가 API 호출 없이 사용량 데이터를 수집하고 저장할 수 있습니다.

다중 프로필 지원

CLAUDE_CONFIG_DIR 환경 변수를 통해 여러 Claude Code 프로필을 분리하여 각각 독립적인 데이터를 유지할 수 있습니다.

자동 데이터 저장

SQLite 기반으로 사용량 기록을 자동 저장하여 추세 분석에 활용할 수 있습니다.

설치 및 시작

ccburn은 다양한 방법으로 설치할 수 있습니다. Windows에서는 WinGet을 통해 winget install JuanjoFuchs.ccburn으로 설치할 수 있으며, npm, pip, npx를 통해서도 설치 가능합니다. 설치 후에는 먼저 Claude Code를 실행하여 로그인하고 자격 증명을 갱신해야 합니다.

기본 사용법은 터미널에서 ccburn을 실행하는 것입니다. 자동 감지 모드로 최적의 데이터 소스를 선택하며, ccburn session, ccburn weekly, ccburn monthly 명령으로 특정 기간의 사용량을 볼 수 있습니다.

활용 예시

• 터미널에서 ccburn을 실행하여 실시간 버닝 차트를 확인합니다.
• 상태 표시줄에 ccburn --compact를 추가하여 현재 사용량을 한 줄로 표시합니다.
• 자동화 스크립트에서 ccburn --json을 사용하여 사용량 데이터를 JSON으로 받아 처리합니다.
• ccburn --since 30m과 같은 옵션으로 최근 활동에 집중한 확대 보기를 사용합니다.

지원 환경 및 요구사항

ccburn은 Python 3.10 이상이 필요하며, Claude Code가 설치되어 있고 유효한 자격 증명이 있어야 합니다. 또한 차트와 이모지가 올바르게 표시되려면 유니코드를 지원하는 터미널이 필요합니다. Windows에서는 Windows Terminal을 권장합니다.

라이선스 및 확인사항

ccburn은 MIT 라이선스로 배포됩니다. 사용량 데이터는 로컬 SQLite 데이터베이스에 저장되며, API 호출을 최소화하기 위해 여러 데이터 소스를 우선순위로 사용합니다. 기본 소스가 불안정할 수 있으므로 ccburn collect를 상태 표시줄에 설정하는 것이 권장됩니다.

화면으로 보는 주요 기능

ccburn 세션(5h) 사용량 그래프

ccburn 앱의 'Session (5h)' 탭에서 5시간 세션의 사용량을 보여주는 그래프입니다. 상단에는 'Usage'와 'Elapsed' 탭이 있으며, 현재는 'Usage'가 선택되어 있습니다. 그래프는 시간에 따른 사용량을 보여주며, 'Budget Pace', 'Usage', 'Projection', 'Now', 'Depleted' 등의 데이터 시리즈가 있습니다. 'Budget Pace'는 파란색 점선, 'Usage'는 노란색 점선, 'Projection'은 회색 점선, 'Now'는 노란색 점, 'Depleted'는 회색 점으로 표시됩니다. 오른쪽 상단에는 'Resets in 2h 21m'과 '59%'라는 텍스트가 있습니다.