claude-usage-dashboard
Dashboard auto-hospedado en Node.js que rastrea uso de tokens y costes de suscripción Claude Code leyendo logs locales y autenticación OAuth, sin servidor ni API keys expuestas.
Ficha actualizada 26 sept 2026, 5:42 · upstream 26 sept 2026, 5:24 · release v1.11.0
Qué es claude-usage-dashboard
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Claude Usage Dashboard es una herramienta de monitorización para usuarios de Claude Code que permite visualizar el valor real obtenido por su suscripción. Lee logs JSONL generados automáticamente por la CLI (~/.claude/projects/) y autentica con las credenciales OAuth locales de Anthropic para consultar la cuota restante.
El dashboard muestra métricas detalladas: consumo de tokens dividido en cache read/write, input y output; ciclos semanales de uso con comparativas delta entre ventanas; sesiones individuales con mezcla de tokens; y proyecciones de cuándo el coste API superaría la tarifa plana. Todo se actualiza automáticamente cada 5 segundos sin reinicio.
El diseño es minimalista y offline-first: tipografías incluidas (Instrument Serif, IBM Plex), localStorage para persistencia de configuración, y un solo archivo HTML con D3.js. Soporta sincronización multi-máquina apuntando a una carpeta compartida (Drive, Dropbox, NAS, rsync).
- Monitorizar el valor real obtenido por la suscripción Claude Code frente al coste API
- Detectar picos de consumo anómalo o cambios en patrones de uso entre ventanas temporales
- Agregar logs de múltiples máquinas mediante carpeta sincronizada para análisis agregado
- Analizar distribución de tokens por sesión y proyecto con filtros y ordenación
- Verificar cuándo la cuota se agota o cuándo el coste API superaría la tarifa plana
- Sin servidor ni base de datos: todo corre en Node.js local con Express
- Actualización automática cada 5 segundos sin reinicio del proceso
- Tipografías incluidas (SIL OFL) para funcionamiento offline completo
- Soporte multi-máquina vía carpeta sincronizada (Drive, Dropbox, NAS, rsync)
- Solo OAuth local de Anthropic sale de la máquina: no expone API keys
- Diseño minimalista con alertas visuales (colores solo como indicadores de estado)
- Requiere Claude Code instalado y generando logs JSONL en ~/.claude/projects/
- Depende de OAuth local de Anthropic: no funciona sin la CLI instalada
- Historial limitado a los últimos 10 ciclos de cuota (7 días)
- Sin soporte nativo para Docker o contenedores
- No soporta autenticación con API key directa, solo OAuth
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Ejecutar con npx claude-usage-dashboard. Port configurable (3000 por defecto, fallback a 8080/8765). Para multi-máquina: exportar CLAUDE_DASH_SYNC_DIR y CLAUDE_DASH_MACHINE_NAME en variables de entorno. Carpeta de sync opcional para agregar logs de múltiples equipos. No requiere instalación global ni base de datos externa.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.