Repolode
Enviar
tigerless-labs

tigerless-labs/cost-xray

Proxy local que captura el tráfico API sin procesar de Claude Code y Codex y atribuye el costo de tokens a cada origen de la solicitud.

Ver en GitHub
Estrellas
5,813
Forks
375
Issues abiertos
35
Último commit
hace 16 horas

¿Qué es?

cost-xray muestra qué envía realmente un agente de programación con IA a la API del modelo y cuánto cuesta cada parte. Las herramientas de uso basadas en logs solo muestran los totales a posteriori, mientras que cost-xray funciona como un punto de captura local, por lo que puede ver el contexto en el momento de la solicitud, como los prompts del sistema, los esquemas de herramientas, los bloques de servidores MCP, los resultados de herramientas, las lecturas y escrituras de caché y los bloques de razonamiento anteriores.

El tráfico capturado se decodifica y se atribuye a sus fuentes, hasta llegar a llamadas individuales a herramientas. Cada fila desglosa el costo en entrada nueva, lectura de caché, escritura de caché y salida. Una TUI en tiempo real agrupa las sesiones por agente, proyecto y sesión; también informa sobre la ocupación de la ventana de contexto y los servidores MCP o las herramientas que se insertan en las solicitudes, pero nunca se llaman.

La captura funciona en macOS o Linux y se enlaza a 127.0.0.1 sin enviar telemetría. Las credenciales y los campos que parecen secretos se ocultan antes de escribir cualquier dato en ~/.cost-xray/. Claude Code se captura mediante una sobrescritura de la URL base, mientras que Codex usa un proxy de reenvío con una CA local de alcance limitado, en la que solo confía el comando codex.

Funciones clave

  • 01Captura solicitudes API sin procesar de Claude Code y Codex mediante un proxy local, sin claves API ni cambios en la configuración del agente.
  • 02Desglosa el costo de cada origen en entrada nueva, lectura de caché, escritura de caché y salida.
  • 03Atribuye el costo hasta llegar a llamadas individuales a herramientas y servidores MCP.
  • 04Muestra la ocupación de la ventana de contexto por prompts del sistema, esquemas de herramientas, bloques MCP y mensajes.
  • 05Señala los servidores MCP y las herramientas que se insertan en cada solicitud, pero nunca se llaman.
  • 06Oculta las credenciales antes de almacenar los datos localmente.

Casos de uso

  • Averiguar por qué una sesión de un agente de programación resulta inesperadamente costosa.
  • Comprobar si los servidores MCP no utilizados o los esquemas de herramientas grandes están aumentando el tamaño de cada solicitud.
  • Confirmar que el almacenamiento en caché de prompts está aprovechando el prefijo estable y detectar reescrituras inesperadas de la caché.
  • Auditar localmente el contexto que un agente de programación envía a la API del modelo.

Inicio rápido

  1. 1

    Comprueba que estás en macOS o Linux y que tienes Claude Code o Codex instalado

  2. 2

    Ejecuta el script oficial de instalación del README

  3. 3

    Abre una nueva terminal e inicia la TUI en vivo

    cx

Antes de usarlo

  • Solo funciona en macOS o Linux.
  • En Claude Code, el reparto de tokens entre fuentes de una solicitud es aproximado, aunque el coste total es exacto.
  • La captura de Codex utiliza una autoridad de certificación local en la que solo confía el comando codex.

En colecciones

Herramientas, skills y plugins para Claude CodeAsistentes y agentes de programación con IAPlataformas de OpenTelemetry y observabilidad

Temas

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

Preguntas frecuentes

¿Qué es cost-xray?
Proxy local que captura el tráfico API sin procesar de Claude Code y Codex y atribuye el costo de tokens a cada origen de la solicitud. cost-xray muestra qué envía realmente un agente de programación con IA a la API del modelo y cuánto cuesta cada parte. Las herramientas de uso basadas en logs solo muestran los totales a posteriori, mientras que cost-xray funciona como un punto de captura local, por lo que puede ver el contexto en el momento de la solicitud, como los prompts del sistema, los esquemas de herramientas, los bloques de servidores MCP, los resultados de herramientas, las lecturas y escrituras de caché y los bloques de razonamiento anteriores.
¿cost-xray es gratuito? ¿Qué licencia tiene?
cost-xray es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿cost-xray sigue mantenido?
Mantenimiento activo. El último commit de cost-xray fue el 5 nov 2026.
¿Para qué puedo usar cost-xray?
Averiguar por qué una sesión de un agente de programación resulta inesperadamente costosa. Comprobar si los servidores MCP no utilizados o los esquemas de herramientas grandes están aumentando el tamaño de cada solicitud. Confirmar que el almacenamiento en caché de prompts está aprovechando el prefijo estable y detectar reescrituras inesperadas de la caché. Auditar localmente el contexto que un agente de programación envía a la API del modelo.
¿Cómo se instala cost-xray?
Comprueba que estás en macOS o Linux y que tienes Claude Code o Codex instalado Ejecuta el script oficial de instalación del README Abre una nueva terminal e inicia la TUI en vivo: cx
¿Dónde consigo cost-xray?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/tigerless-labs/cost-xray

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados