Contribuição open source · Rust · CLI · AI Tooling
viniciusdsandrade/ ccusage
Ferramenta de terminal em Rust para monitoramento e auditoria em tempo real de consumo de tokens e custos de agentes e modelos de inteligência artificial.
- 1 PR em revisão
- 1 commit no projeto
- +9 linhas adicionadas
- 21/10/2026 primeiro PR
O projeto
O ccusage é um utilitário de linha de comando de alto desempenho escrito em Rust, desenvolvido para calcular, consolidar e auditar custos e volumes de tokens consumidos por ferramentas de IA no terminal.
Ao interceptar históricos e registros locais de execuções de agentes de desenvolvimento, a ferramenta fornece relatórios diários e semanais de uso, auxiliando equipes de engenharia no controle orçamentário de consumo de grandes modelos de linguagem.
Como cada PR foi feito
-
Um problema por PR
Cada PR resolve uma coisa só, com a menor mudança possível. Isso simplifica a revisão, reduz o risco de efeito colateral e permite desfazer uma mudança sem levar outras junto.
-
O problema vira teste
As correções chegam com testes automatizados que cobrem o caso que falhava, para o problema não voltar sem que ninguém perceba.
-
Os critérios do próprio projeto
Formatação, análise estática e a suíte completa de testes rodam na integração contínua do projeto, e a mudança só entra depois da revisão do mantenedor.
-
Escrito para quem revisa
A descrição de cada PR explica o problema, a mudança e como ela foi testada, para o mantenedor decidir com segurança.
Cada PR, em linguagem de negócio
Estes PRs estão em revisão pelos mantenedores e ainda não foram incorporados. Clique em um deles para ver o problema, a proposta e o valor esperado.
-
#1aberto em 21/10/2026Em revisão Mapeamento do identificador do Claude Opus 5.5 na CLI de consumo de IA Sessões com Claude Opus 5.5 geravam alertas de modelo sem preço e custo zerado na CLI; o PR propõe mapear o identificador para tarifação correta.
- O problema
- A ferramenta de linha de comando monitora o uso de tokens e custos de modelos de inteligência artificial em ambientes locais de desenvolvimento. Ao analisar históricos de conversas com o modelo Claude Opus 5.5, o analisador não reconhecia o identificador numérico interno gerado pela plataforma e recorria a um nome temporário não catalogado. Como esse marcador genérico não possuía tabela de preços associada, a CLI emitia avisos constantes de modelo não precificado e exibia custo zero nos relatórios financeiros.
- O que o PR propõe
- O PR propõe mapear o código numérico do Claude Opus 5.5 e normalizar os marcadores provisórios diretamente no módulo de interpretação de histórico da ferramenta. Com essa correspondência, os dados de consumo passam a apontar para o catálogo oficial de preços do modelo, calculando valores reais de entrada e saída. A alteração acompanha testes unitários para validar a identificação e a normalização do modelo em diferentes variantes de nome.
- Valor esperado
- Permite que times e desenvolvedores acompanhem com exatidão os custos e o volume de tokens consumidos por agentes executando sobre o Claude Opus 5.5.
Números atualizados em 21/10/2026.
O mesmo cuidado no seu sistema
Os mesmos hábitos destes PRs valem para backends que movimentam dinheiro: reproduzir o problema antes de corrigir, provar a correção com teste e não deixar dado sensível escapar.