Ferramenta aberta detalha custos e contexto de agentes Claude Code e Codex

Dados rápidos

• Repositório: tigerless-labs/cost-xray
• Licença: MIT
• Linguagem principal: Python
• Popularidade: 2.440 estrelas, 153 estrelas no período e 236 forks
• Posição no ranking: 15º lugar diário no Trendshift
• Data da consulta: 27 de setembro de 2026

Gargalo de visibilidade em assistentes de código

A maioria dos utilitários de medição de uso baseia suas leituras em arquivos de registro gravados em disco. Essa abordagem fornece o total gasto em uma sessão ou execução pontual, mas oculta o contexto montado imediatamente antes do envio para o modelo.

Sem inspecionar essa montagem prévia, o usuário não tem clareza sobre o impacto de instruções do sistema, esquemas de ferramentas, blocos de protocolos de contexto de modelo e dados de raciocínio prévio. Como resultado, torna-se comum pagar faturas elevadas sem saber quais partes da estrutura técnica causaram o salto no processamento.

O cost-xray responde a esse cenário capturando o tráfego local de rede antes que ele chegue aos servidores remotos. Ao relacionar os dados trafegados com as fontes que os geraram dentro de cada requisição, a ferramenta exibe a justificativa individual do custo de cada turno da conversa.

Configuração e fluxo de operação

A aplicação roda em segundo plano em sistemas operacionais macOS e Linux sem demandar cadastro, chaves de acesso adicionais ou modificações na configuração dos agentes. Para o Claude Code, o sistema utiliza um proxy reverso sem necessidade de certificados digitais. Para o Codex, o monitoramento adota um proxy de encaminhamento acompanhado de uma autoridade certificadora local restrita.

O script de instalação pode ser executado diretamente pelo terminal:

curl -fsSL https://raw.githubusercontent.com/tigerless-labs/cost-xray/master/install.sh | bash

Durante a instalação, o terminal solicita a escolha dos agentes monitorados, seja Claude Code, Codex ou ambos. Em seguida, o usuário abre uma nova janela de terminal e executa seus comandos habituais. A visualização e o gerenciamento ocorrem pela interface de linha de comando cx. O comando isolado cx inicializa uma interface textual interativa, enquanto variações como cx status e cx stop verificam portas ativas ou interrompem os proxies para execuções diretas.

Aplicações práticas no fluxo de trabalho

• Identificação de desperdício em servidores de contexto: detecta ferramentas configuradas que são injetadas continuamente nas mensagens, mas que nunca chegam a ser invocadas pelo agente durante a sessão.
• Monitoramento de ocupação da janela de contexto: exibe em linhas dedicadas o espaço preenchido por prompts de sistema, esquemas de validação e histórico de mensagens, revelando estruturas estáticas que reduzem o espaço para o código em si.
• Precificação individual de ferramentas: calcula o custo exato de uma leitura de arquivo específica, separando esse valor do montante geral agrupado por tipo de ação.
• Decomposição de uso de cache de instruções: divide o valor processado entre leituras de cache, gravações de cache, novas entradas e texto gerado, facilitando a mensuração da economia real propiciada pelo cache de comandos.

Diferenças técnicas frente a outras opções

Softwares convencionais de monitoramento limitam-se a somatórios gerais por requisição ou agrupamentos genéricos de ferramentas. O cost-xray se diferencia por rastrear custos em nível microscópico, associando valores monetários diretamente a cada chamada individual de uma ferramenta e aos dados retornados por ela.

A medição física da janela de contexto também introduz uma separação prática entre volume e preço. Mesmo quando blocos extensos de esquemas se tornam financeiramente baratos por meio de leitura em cache, eles continuam consumindo espaço de memória da janela. O programa destaca essa ocupação linha a linha, mantendo a operação estritamente local e sem envio de telemetria externa.

Limitações e aspectos de maturidade

O projeto iniciou suas atividades públicas em 6 de junho de 2026 e teve sua última atualização de código em 1º de setembro de 2026. Até o momento da consulta, nenhuma versão estável em formato de release oficial foi disponibilizada pelos mantenedores, e existem 14 chamados abertos no rastreador de pendências.

Na parte de precisão, a Anthropic não disponibiliza um tokenizador público oficial para os modelos Claude, e a utilização constante da API de contagem esbarraria em limites operacionais. Por essa razão, a ferramenta utiliza um estimador calibrado para o Claude, o que pode trazer pequenas divergências na contagem de tokens. O suporte inicial está restrito a dois agentes específicos no Linux e no macOS sob a licença permissiva MIT. A existência de um sítio eletrônico próprio não foi informada no repositório.

Resumo rápido

• Projeto: cost-xray (desenvolvido por tigerless-labs)
• Licença: MIT
• Linguagem: Python
• Estrelas: 2.440 (com 153 no período e 236 forks)
• Ranking: 15º lugar no ranking diário do Trendshift
• Risco principal: ausência de versões estáveis lançadas e uso de proxies locais baseados em estimadores para determinados modelos

Fontes

• Repositório no GitHub: https://github.com/tigerless-labs/cost-xray
• Última versão lançada: nenhuma release encontrada
• Site oficial: sem site oficial
• Classificação diária: Trendshift (daily: #15)