Monitorear el consumo de recursos en herramientas de inteligencia artificial es crucial para una gestión eficiente de los costos. Aunque las estimaciones basadas en tokens ofrecen una visión útil del uso de Claude Code y Codex CLI, es importante comprender que estas cifras no siempre se traducen directamente en el cargo final de una suscripción. Para una supervisión efectiva, es necesario diferenciar entre el uso registrado localmente, las tarifas aplicadas y los datos proporcionados por el proveedor.

La importancia de una medición precisa

Cuando utilizas herramientas de IA para desarrollo o análisis, como Claude Code o Codex CLI, puedes llevar un seguimiento de tu consumo mediante registros locales. Estos registros te permiten estimar el gasto al convertir los tokens utilizados en una cifra monetaria. Sin embargo, esta estimación no es automáticamente equivalente al importe que verás reflejado en tu factura de suscripción.

Para tener un control real sobre el gasto, debes considerar varios factores:

  • El uso registrado localmente en tus archivos.
  • Las tarifas específicas que el proveedor aplica a tu cuenta.
  • Los datos de uso y facturación que te ofrece directamente el proveedor.

Elementos clave antes de iniciar la medición

El método propuesto por tutoriales como el de Shattered.io implica recopilar registros locales en formato JSONL, que guarda cada evento en una línea, y aplicar una tabla de tarifas personalizada. Esto permite agrupar el uso por día, modelo, proyecto o herramienta. Es fundamental recordar que los informes generados por estos métodos suelen ser sintéticos y no representan mediciones de cuentas reales.

La ubicación de los registros es vital. Por ejemplo, los registros de Claude Code suelen encontrarse en ~/.claude/projects y los de Codex CLI en ~/.codex/sessions. Un registro local solo puede contabilizar las sesiones cuyos datos se almacenan en estos archivos. Herramientas como optimAIzr pueden leer sesiones de la pestaña Code de la aplicación de escritorio de Claude, pero no los chats habituales, y también pueden procesar registros de sesiones de Claude Code dirigidas por Remote Control de iOS que se ejecutan en tu ordenador, no en la nube.

Pasos para calcular y revisar tu consumo

  1. Define qué quieres medir: Es crucial distinguir entre el uso de API y el uso de una suscripción, ya que se facturan por separado. Una estimación basada en tarifas de API no indica el consumo de una suscripción.
  2. Identifica los registros locales: Asegúrate de que los archivos JSONL que vas a procesar correspondan a las herramientas y sesiones que deseas analizar.
  3. Verifica cómo el parser cuenta los tokens: En el código de OpenAI, existen campos como total_token_usage (uso acumulado) y last_token_usage (uso por petición). Algunos parsers, como el del tutorial, calculan diferencias entre instantáneas acumuladas y pueden no guardar campos como cache_write_input_tokens. Es importante que la tabla de tarifas que apliques cubra todos los modelos y categorías de tokens que tu parser contabiliza.
  4. Revisa el control de costes: Si construyes un control de presupuesto, asegúrate de que no solo compruebe la suma en dólares, sino que también rechace el paso si quedan tokens sin precio, mostrándolos aparte. Esto evita que el uso sin coste calculado pase desapercibido.
  5. Contrasta tu estimación con la cuenta del proveedor: Una cifra local basada en tokens es una herramienta útil para comparar sesiones o proyectos. Sin embargo, para obtener el uso real de tu suscripción o los cargos de API, siempre debes consultar la vista de uso o facturación que te ofrece directamente el proveedor.

Para valorar el coste de un resultado aceptado, es fundamental considerar también la revisión humana. Un usuario de Reddit, u/Gooner-Psy, compartió cómo separaba el coste en tokens (equivalente a API) de un borrador aceptado del tiempo dedicado a la edición. En un caso, el coste en tokens fue de 2,40 dólares, pero la edición humana tomó tres horas, lo que subraya que el gasto en tokens no mide el esfuerzo total por sí solo.

Beneficios de un panel de seguimiento

Un panel de seguimiento, como CodeBurn, ofrece estimaciones diarias, desgloses por proyecto y modelo, y actividad de herramientas y servidores, permitiendo filtrar por proveedor. Sin embargo, es importante recordar que estas cifras se calculan con tarifas de API y no siempre representan el consumo o el coste real de una suscripción. Estos paneles son herramientas valiosas para tener una visión general y granular de tu consumo, pero siempre deben complementarse con los datos oficiales del proveedor para una gestión financiera precisa.