Repolode
Enviar
tigerless-labs

tigerless-labs/cost-xray

Proxy local que captura o tráfego bruto de API do Claude Code e do Codex e atribui o custo em tokens a cada origem da requisição.

Ver no GitHub
Estrelas
5,813
Forks
376
Issues abertas
35
Último commit
anteontem

O que é?

cost-xray mostra o que um agente de programação com IA realmente envia para a API do modelo e quanto custa cada parte. Ferramentas de uso baseadas em logs só mostram os totais depois que tudo acontece; já o cost-xray funciona como um ponto de captura local e consegue ver, durante a requisição, itens como prompts de sistema, schemas de ferramentas, blocos de servidores MCP, resultados de ferramentas, leituras e gravações de cache e blocos de raciocínio anteriores.

O tráfego capturado é decodificado e atribuído às respectivas origens, até chegar a cada chamada de ferramenta. Cada linha separa o custo em entrada nova, leitura de cache, gravação de cache e saída. Uma TUI em tempo real agrupa as sessões por agente, projeto e sessão, além de mostrar a ocupação da janela de contexto e os servidores ou ferramentas MCP injetados nas requisições, mas nunca chamados.

A captura funciona no macOS ou Linux e se vincula a 127.0.0.1, sem enviar telemetria. Credenciais e campos que parecem conter segredos são ocultados antes de qualquer dado ser gravado em ~/.cost-xray/. O Claude Code é capturado por meio de uma substituição da URL base, enquanto o Codex usa um proxy de encaminhamento com uma CA local com escopo limitado, confiável apenas pelo comando codex.

Recursos principais

  • 01Captura requisições brutas de API do Claude Code e do Codex por meio de um proxy local, sem chaves de API nem alterações na configuração do agente.
  • 02Separa o custo em entrada nova, leitura de cache, gravação de cache e saída para cada origem.
  • 03Atribui custos até cada chamada de ferramenta e servidor MCP.
  • 04Mostra a ocupação da janela de contexto por prompt de sistema, schemas de ferramentas, blocos MCP e mensagens.
  • 05Sinaliza servidores e ferramentas MCP injetados em todas as requisições, mas nunca chamados.
  • 06Oculta credenciais antes que os dados sejam armazenados localmente.

Casos de uso

  • Descobrir por que uma sessão de agente de programação está custando mais do que o esperado.
  • Verificar se servidores MCP não utilizados ou schemas de ferramentas grandes estão inflando todas as requisições.
  • Confirmar se o cache de prompts está aproveitando o prefixo estável e identificar regravações inesperadas do cache.
  • Auditar localmente qual contexto um agente de programação envia para a API do modelo.

Início rápido

  1. 1

    Confirme que está usando macOS ou Linux e que tem o Claude Code ou o Codex instalado

  2. 2

    Execute o script oficial de instalação indicado no README

  3. 3

    Abra um novo terminal e inicie a TUI ao vivo

    cx

Antes de usar

  • Funciona apenas no macOS ou Linux.
  • No Claude Code, a divisão de tokens entre as fontes em uma solicitação é aproximada, mas o custo total é exato.
  • A captura do Codex usa uma autoridade certificadora local que só é confiável para o comando codex.

Em coleções

Ferramentas, skills e plugins para Claude CodeAssistentes e agentes de programação com IAPlataformas de OpenTelemetry e observabilidade

Tópicos

#claude-code#codex#cost-tracking#llm-observability#prompt-caching#token-counting#proxy#codex-cli#observability

Perguntas frequentes

O que é cost-xray?
Proxy local que captura o tráfego bruto de API do Claude Code e do Codex e atribui o custo em tokens a cada origem da requisição. cost-xray mostra o que um agente de programação com IA realmente envia para a API do modelo e quanto custa cada parte. Ferramentas de uso baseadas em logs só mostram os totais depois que tudo acontece; já o cost-xray funciona como um ponto de captura local e consegue ver, durante a requisição, itens como prompts de sistema, schemas de ferramentas, blocos de servidores MCP, resultados de ferramentas, leituras e gravações de cache e blocos de raciocínio anteriores.
cost-xray é gratuito? Qual é a licença?
cost-xray é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
cost-xray ainda é mantido?
Manutenção ativa. O último commit de cost-xray foi em 5 de nov. de 2026.
Para que posso usar cost-xray?
Descobrir por que uma sessão de agente de programação está custando mais do que o esperado. Verificar se servidores MCP não utilizados ou schemas de ferramentas grandes estão inflando todas as requisições. Confirmar se o cache de prompts está aproveitando o prefixo estável e identificar regravações inesperadas do cache. Auditar localmente qual contexto um agente de programação envia para a API do modelo.
Como instalar cost-xray?
Confirme que está usando macOS ou Linux e que tem o Claude Code ou o Codex instalado Execute o script oficial de instalação indicado no README Abra um novo terminal e inicie a TUI ao vivo: cx
Onde consigo cost-xray?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/tigerless-labs/cost-xray

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados