cost-xray

cost-xray é uma ferramenta de captura local e atribuição de custos para agentes de codificação de IA. Em vez de ler transcrições locais após o fato, ela intercepta as requisições reais de API que Claude Code e Codex enviam, então divide cada requisição em seus componentes de origem e os precifica. Por que existe: ferramentas de uso baseadas em logs mostram o custo total de uma chamada ou sessão, mas o contexto no momento da requisição — prompts de sistema, esquemas de ferramentas injetados, blocos MCP, resultados de ferramentas, leituras/gravações de cache, blocos de pensamento anteriores — é montado no momento da requisição e nunca é escrito na transcrição. Esse prefixo invisível pode ser uma grande parcela do contexto. cost-xray lê a requisição bruta do wire para atribuir tokens e dólares a esquemas, servidores MCP, ferramentas e buckets de mensagens, até chamadas individuais de ferramentas. Como funciona: mitmproxy roda como um hop de captura local. Claude Code é capturado via modo proxy reverso com override de URL base (sem certificado); Codex usa um proxy direto mais uma CA local escopada confiável apenas pelo comando codex. O proxy liga em 127.0.0.1, não envia telemetria e redige cabeçalhos Authorization, chaves de API, cookies e campos de corpo com aparência de segredo antes de gravar em disco sob ~/.cost-xray/. A análise roda fora do caminho da requisição em um materializador separado, então tokenização e precificação não adicionam latência ao relay ao vivo. O tráfego capturado é deduplicado por bloco único com deltas por turno, mantendo o uso de disco pequeno mesmo para sessões de milhões de tokens. Recursos descritos no README: atribuição de custo por fonte dividida em tokens frescos, leitura de cache, gravação de cache e saída, precificados até a chamada individual; ocupação da janela de contexto dividida em linhas por fonte; detecção de servidores MCP e ferramentas configurados que são injetados em cada requisição mas nunca chamados; abordagem de tokenização para Claude que usa estimativa tiktoken mais calibração proporcional contra os totais de uso do próprio provedor (totais exatos, divisão por fonte aproximada); wrappers auto-reparáveis que reiniciam o proxy ou caem para execução direta do agente; e uma TUI ao vivo. A instalação é um script de instalação via curl que pergunta quais agentes capturar, ou aceita COST_XRAY_AGENTS=claude|codex|all. A captura é somente direta e requer um novo terminal. O CLI cx abre a TUI e gerencia serviços (status, stop, start, restart, install, uninstall). Requisitos são macOS ou Linux, um agente suportado e sem chaves de API ou conta. Licenciado MIT.