ccstats
ccstats es una herramienta de código abierto que proporciona estadísticas de uso de Claude Code en un servidor local, con opción de visualización web y firmware para el dispositivo Badgeware Tufty 2350.
Ficha actualizada 22 sept 2026, 20:24 · upstream 22 sept 2026, 20:00 · release sin release detectada
Qué es ccstats
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
ccstats es una herramienta de código abierto que proporciona estadísticas detalladas del uso de Claude Code en un servidor local. La plataforma convierte las sesiones de Claude Code en feeds JSON precalculados y firmware para un badge físico Badgeware Tufty 2350, mostrando estadísticas como avatar en tiempo real, límites diarios/semanales, tokens usados, palabras y caracteres tipografiados, conteo de prompts y estreaks, desglose por proyecto y herramienta. Además ofrece una interfaz web completa sin necesidad del hardware físico.
El sistema opera mediante un servidor Linux que escanea transcripciones de sesiones de Claude Code, calcula métricas y almacena datos en un ledger SQLite duradero. El firmware del badge (Pimoroni Tufty 2350) se encarga de renderizar las estadísticas sobre el LCD de 320×240 píxeles con PicoGraphics.
ccstats soporta múltiples máquinas, permitiendo que los datos se fusionen en un total global. Incluye métricas como ritmo de trabajo diario/semanal, uso por token (sin caché), conteo de palabras y caracteres, prompts por proyecto y herramienta, estimación de costos, comparaciones competitivas entre usuarios y opciones visuales personalizadas.
La arquitectura incluye un pipeline que parsea transcripciones, calcula estadísticas en tiempo real mediante análisis de tráfico de red del cliente, y almacena datos permanentemente. El sistema no realiza cálculos numéricos pesados; el servidor se ejecuta como usuario separado con capacidades mínimas requeridas por seguridad.
Además, ccstats permite visualizar las mismas estadísticas directamente desde un dashboard web en cualquier navegador, eliminando la necesidad de hardware físico. Se soporta despliegue local, en red o en múltiples máquinas conectadas a una misma instancia central.
- Monitorear el uso de Claude Code sin depender de servicios externos como GitHub Copilot
- Seguir métricas de token y rendimiento personal sin costo adicional
- Comparar productividad entre diferentes proyectos o herramientas de IA
- Visualizar estadísticas en tiempo real mediante un badge físico o dashboard web
- Analizar patrones de uso diario/semanal para optimizar el flujo de trabajo
- Estimación de costos de token y planificación de presupuesto de API
- Soporta múltiples máquinas con fusionación centralizada de estadísticas en tiempo real
- No requiere instrumentación del editor; lee transcripciones directamente desde el servidor
- Ledger SQLite persistente permite mantener totales acumulativos incluso tras pruebas de limpieza de Claude Code
- Firmware PicoGraphics para visualización en LCD 320×240 con estado live (trabajando/idle/waiting)
- Dashboard web completo sin necesidad del hardware físico
- Soporte de múltiples paletas de color y configuraciones personalizadas por usuario
- Los subagentes pueden omitir registros finales en transcripciones (bug conocido que afecta ~20% de casos), lo que hace que los conteos de tokens totales sean un límite inferior
- La precisión numérica depende del rendimiento del servidor y la calidad de las transcripciones originales
- El sistema requiere acceso a transcripciones de Claude Code para calcular métricas como palabras y caracteres tipografiados
- No incluye gestión de versiones de modelos o configuración de llaves API por defecto
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.
Para instalar, clona el repositorio en un servidor Linux. Abre Claude Code dentro del proyecto y escribe 'read README.md and set it up'. El pipeline generará automáticamente la configuración, construirá el ledger SQLite e instalará los servicios de systemd y nginx con Let's Encrypt. Actualizaciones: `git pull && sudo ./server/deploy.sh` (solo código). No se toman cambios en config, token o ledger. Si hay divergencia de ramas tras un pull anterior a 2026-08-17, ejecuta el script de actualización temporal. El usuario 'ccollector' no tiene privilegios root; sus unidades systemd tienen capacidades restringidas solo para leer archivos de sesiones (permisos 0600) e I/O en /proc. Migraciones anteriores a este usuario son automáticas y reversibles mediante `sudo ./server/deploy.sh`. Para el firmware, instala MicroPython con la imagen Pimoroni Tufty 2350 que incluye picographics. Edita `/syste
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.