Claude Usage Tracker

¿Qué es Claude Usage Tracker?

Claude Usage Tracker es una herramienta local-first que detecta automáticamente y agrega los costos de uso de Claude AI en múltiples herramientas de desarrollo local. Escanea directorios de datos conocidos, analiza archivos JSONL/log, calcula costos usando precios específicos por modelo y muestra los resultados en un panel interactivo.

El propósito principal es el seguimiento y visualización de costos, para que puedas revisar el gasto por fuente, modelo y período de tiempo sin enviar datos de uso a la nube. Todo se ejecuta en tu máquina y el panel está impulsado por Chart.js.

Características principales

• Detecta automáticamente 9+ herramientas integradas con Claude y fusiona los datos de uso para una vista consolidada.
• Cálculo de costos usando precios por millón de tokens específicos del modelo para familias de modelos Anthropic (Opus, Sonnet, Haiku), incluyendo entrada/salida y lectura/escritura de caché cuando aplica.
• Panel interactivo con tema oscuro usando Chart.js con gráficos visuales y desgloses.
• Seguimiento de costos por tiempo con vistas diarias, semanales, mensuales y de todos los tiempos.
• Análisis por modelo y fuente incluyendo desgloses de costos por modelo y filtros (fuente, modelo, rango de fechas y costo mínimo).
• Visualización de patrones pico mediante mapas de calor y dos vistas: Peak Hours (rejilla día × hora) y Peak Days (calendario estilo GitHub).
• Detalles a nivel de sesión incluyendo un registro de sesiones expandible con tarjetas de fuente codificadas por color, resúmenes de costos por sesión (ej. sesión más cara) y un panel de detalles de sesión.
• Proyección de cadencia de proyecto con proyecciones mensuales basadas en el ritmo de gasto actual.
• Opción de paquete de app para macOS para construir un .app independiente que se lanza con doble clic.

Cómo usar Claude Usage Tracker

1. Instala y lanza la última versión (recomendado) o ejecuta la herramienta localmente desde el código fuente.
2. Ejecuta un escaneo para recopilar datos y renderizar el panel: la app de macOS recopila datos frescos y muestra el panel interactivo, y el modo navegador inicia un servidor local y carga dashboard.html.
3. Revisa el panel para explorar costos totales y desglosarlos por fuente/modelo y por períodos de tiempo usando los gráficos, mapas de calor y filtros disponibles.

Opciones de inicio rápido (desde el repositorio):

• macOS (Apple Silicon/Intel): descarga la última versión, descomprime, mueve Claude Usage Dashboard.app a Aplicaciones, luego haz doble clic para lanzar.
• Construir desde fuente: clona el repo, ejecuta ./build-app.sh, luego haz doble clic en la app construida.
• Modo navegador (cualquier SO): ejecuta node collect-usage.js, inicia un servidor local con python3 -m http.server 8765 y abre http://localhost:8765/dashboard.html.

Casos de uso

• Consolidar gasto en múltiples herramientas Claude: Si usas varias integraciones locales (por ejemplo, Cursor, Windsurf, Claude Desktop y Continue.dev), el tracker fusiona el uso de estas fuentes en un solo panel.
• Identificar cuándo el gasto es más alto: Usa Peak Hours (mapa de calor día × hora) y el calendario Peak Days para detectar los momentos y días con las sesiones de uso más caras.
• Auditar sesiones o días específicos: Expande el registro de sesiones de una fecha para inspeccionar costos por sesión y ver desglose de tokens e historial de conversación en el panel de detalles de sesión.
• Comparar cambios día a día: Usa Yesterday Delta para comparar el gasto de hoy con el de ayer de un vistazo.
• Planificar expectativas para el mes actual: Revisa Monthly Projections para estimar costos mensuales proyectados basados en el ritmo de gasto actual.

Preguntas frecuentes

• ¿El tracker envía datos de uso a un servidor? No. La descripción del proyecto indica que no hay “nube” ni “telemetría”, y que todo permanece en tu máquina.

• ¿Qué herramientas soporta? El repositorio lista uso de Claude de OpenClaw/Clawdbot, Claude Code CLI, Claude Desktop (modo agente local), Cursor, Windsurf, Cline, Roo Code, Aider y Continue.dev. La detección de herramientas es automática.

• ¿Qué formatos de datos lee? Escanea directorios conocidos y analiza archivos JSONL/log; la sección de herramientas soportadas especifica JSONL para cada herramienta listada.

• ¿Qué pasa si una herramienta no está instalada o no tiene datos de uso? El comportamiento de detección de herramientas se describe como: si una herramienta no está instalada o no tiene datos, se omite silenciosamente.

• ¿Cómo calcula los costos? Los costos se calculan usando los precios por millón de tokens de Anthropic para las familias de modelos soportadas (Opus, Sonnet, Haiku), basados en entrada/salida y lectura/escritura de caché cuando se proporciona.

Alternativas

• Análisis de logs locales + hojas de cálculo: Exporta o recopila tus logs de uso de Claude y calcula los costos manualmente en una hoja de cálculo. Es más manual que un panel interactivo, pero puede adaptarse a flujos de trabajo personalizados.
• Paneles de uso proporcionados por el proveedor (si están disponibles): Algunos proveedores ofrecen vistas de uso para facturación/informes. Estos suelen centrarse en un solo producto/cuenta en lugar de agregar varios tools locales.
• Herramientas generales de análisis de tiempo/costos para desarrolladores: Herramientas que analizan la actividad del IDE o calculan costos basados en eventos de uso pueden ayudar, pero quizás no modelen la facturación por tokens específica de Claude ni analicen automáticamente el formato de almacenamiento de cada tool.
• Otros paneles de monitoreo locales: Herramientas similares que visualizan logs locales en el navegador pueden ofrecer gráficos parecidos, aunque podrían requerir que prepares los datos en lugar de depender de la detección automática y el análisis JSONL del tracker.