CC-Ledger: 로컬 SQLite로 세션 및 PR별 클로드 코드 비용 추적

CC-Ledger는 로컬 Rust 바이너리로, Claude Code 후크로 등록되어 각 턴이 완료되는 즉시 로컬 SQLite 데이터베이스에 기록합니다. 이를 통해 세션 비용을 실시간으로 확인할 수 있어, 할당량을 소진하기 전에 문제 세션을 잡아내고 API 키 없이 PR별 비용 내역을 파악할 수 있습니다.

작동 방식

이 도구는 한 Claude Code 세션이 작성자의 할당량 대부분을 소비했는데도 Claude 대시보드에서 이를 알리지 않았고, 한 PR의 비용이 중앙값의 40배에 달했지만 내부적으로 그 이유를 알 수 없었던 경험에서 비롯되었습니다. CC-Ledger는 모든 턴을 실시간으로 SQLite에 기록하여 이 문제를 해결합니다.

세 가지 방법으로 분석 결과를 확인할 수 있습니다:

• macOS 메뉴바 — SwiftBar 플러그인 사용
• 웹 대시보드 — ccledger.dev에서 호스팅
• CLI — 터미널에서 직접 쿼리

시작하기

리포지토리를 클론하고 Rust 바이너리를 빌드하세요:

git clone https://github.com/delta-hq/cc-ledger
cd cc-ledger
cargo build --release

그런 다음 Claude Code 후크로 설정합니다 (자세한 설정은 리포지토리 README 참조). 후크는 각 턴을 자동으로 SQLite에 기록합니다.

대상 사용자

세션 및 풀 리퀘스트별로 세부 비용을 추적하여 이상 징후를 디버깅하고 할당량 초과를 방지하려는 Claude Code 사용자.