CC-Ledger: Rastreie os Custos do Claude Code por Sessão e por PR com SQLite Local

CC-Ledger é um binário Rust local que se registra como um hook do Claude Code e grava cada etapa em um banco de dados SQLite local no momento em que é concluída. Isso oferece visibilidade em tempo real dos custos da sessão — capturando sessões descontroladas antes que esgotem sua cota — e detalhamento de custos por PR sem necessidade de chave de API.

Como Funciona

A ferramenta foi criada depois que uma única sessão do Claude Code consumiu a maior parte da cota do autor, sem que o painel do Claude nunca a sinalizasse. Além disso, descobriu-se que um PR custava 40 vezes a mediana, sem visibilidade integrada do motivo. O CC-Ledger resolve isso registrando cada etapa no SQLite em tempo real.

Veja as análises de três formas:

• Barra de menu macOS — via um plugin SwiftBar
• Painel web — hospedado em ccledger.dev
• CLI — consultas diretas no terminal

Primeiros Passos

Clone o repositório e compile o binário Rust:

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

Em seguida, configure-o como um hook do Claude Code (consulte o README do repositório para configuração detalhada). O hook grava cada etapa no SQLite automaticamente.

Para Quem É

Usuários do Claude Code que precisam de rastreamento granular de custos por sessão e por pull request para depurar anomalias e evitar estouros de cota.