cost-xray

cost-xray es una herramienta local de captura y atribución de costos para agentes de programación con IA. En lugar de leer transcripciones locales a posteriori, intercepta las solicitudes reales de la API que envían Claude Code y Codex, y luego descompone cada solicitud en sus fuentes componentes y les asigna un precio. Por qué existe: las herramientas de uso basadas en registros muestran el costo total de una llamada o sesión, pero el contexto en el momento de la solicitud —prompts del sistema, esquemas de herramientas inyectados, bloques MCP, resultados de herramientas, lecturas/escrituras de caché, bloques de pensamiento previos— se ensambla en el momento de la solicitud y nunca se escribe en la transcripción. Ese prefijo invisible puede representar una gran parte del contexto. cost-xray lee la solicitud sin procesar en el cable para poder atribuir tokens y dólares a esquemas, servidores MCP, herramientas y grupos de mensajes, hasta llamadas de herramientas individuales. Cómo funciona: mitmproxy se ejecuta como un salto de captura local. Claude Code se captura mediante el modo de proxy inverso con una anulación de URL base (sin certificado); Codex usa un proxy de reenvío más una CA local de alcance limitado en la que solo confía el comando codex. El proxy se enlaza a 127.0.0.1, no envía telemetría y redacta encabezados Authorization, claves de API, cookies y campos del cuerpo que parecen secretos antes de escribir en disco bajo ~/.cost-xray/. El análisis se ejecuta fuera de la ruta de la solicitud en un materializador separado, por lo que la tokenización y el cálculo de precios no añaden latencia al relé en vivo. El tráfico capturado se deduplica por bloque único con deltas por turno, manteniendo bajo el uso de disco incluso para sesiones de millones de tokens. Características descritas en el README: atribución de costos por fuente dividida en tokens nuevos, de lectura de caché, de escritura de caché y de salida, con precios hasta la llamada individual; ocupación de la ventana de contexto desglosada en filas a nivel de fuente; detección de servidores y herramientas MCP configurados que se inyectan en cada solicitud pero nunca se llaman; un enfoque de tokenización para Claude que usa estimación con tiktoken más calibración proporcional contra los totales de uso del propio proveedor (totales exactos, desglose por fuente aproximado); envoltorios autorreparables que reinician el proxy o recurren a la ejecución directa del agente; y una TUI en vivo. La instalación es un script de instalación canalizado por curl que pregunta qué agentes capturar, o acepta COST_XRAY_AGENTS=claude|codex|all. La captura es solo hacia adelante y requiere una terminal nueva. La CLI cx abre la TUI y gestiona servicios (status, stop, start, restart, install, uninstall). Los requisitos son macOS o Linux, un agente compatible y ninguna clave de API ni cuenta. Licencia MIT.