Después de usar Claude Code por un tiempo empiezas a preguntarte: ¿cuántos tokens estoy consumiendo realmente? ¿Qué herramientas se llaman más? ¿Mis sesiones se están volviendo muy largas? ¿Soy más productivo a la mañana o a la noche?

claude-stats responde todo eso. Lee los archivos de sesión que Claude Code escribe localmente en ~/.claude/projects/ y te muestra un análisis completo en la terminal. Un binario de Go, funciona completamente offline, no envía nada a ningún lado.

Instalación

# Linux / macOS / WSL
curl -fsSL https://raw.githubusercontent.com/Andrevops/claude-stats/main/install.sh | sh

O con Go: go install github.com/Andrevops/claude-stats/cmd/claude-stats@latest

Comandos

Ejecuta claude-stats para un menú interactivo, o usa los comandos directamente:

claude-stats tokens --week        # tokens y costo de los últimos 7 días
claude-stats tools --month        # qué herramientas Claude llamó más
claude-stats heatmap --month      # cuándo trabajas, por hora y día de la semana
claude-stats sessions --week      # salud de las sesiones — detecta contextos inflados
claude-stats efficiency --week    # líneas por turno, archivos por turno, tasa de errores
claude-stats report --week        # todo en una vista compacta con una calificación general
claude-stats digest --ai          # resumen generado por IA de lo que trabajaste
claude-stats trends               # esta semana vs la semana pasada, con flechas de tendencia

Todos los comandos aceptan --yesterday, --week, --month, --all o una fecha específica. Los comandos tokens, report y trends también soportan --json para salida estructurada.

[!note] El comando digest --ai usa la CLI de Claude para generar un resumen en lenguaje natural de lo que trabajaste — proyectos, branches, commits y archivos modificados. Muy útil para los stand-ups diarios.

Lo que detecta

El comando sessions marca las sesiones donde el contexto creció más del 200% y recomienda cuándo reiniciar. Los contextos inflados cuestan más y producen peores resultados. El comando prompts simula tu allowlist de settings.json y sugiere patrones nuevos para reducir la cantidad de prompts de permiso que tienes que aprobar manualmente cada día.

El comando report combina todo en un scorecard con una calificación general para que puedas ver de un vistazo si tus patrones de uso son saludables.

[!important] Si usas el comando yolo de claude-sandbox, esas sesiones se guardan en el mismo directorio ~/.claude/projects/ — claude-stats las lee y analiza de la misma forma.

Descargarlo: github.com/Andrevops/claude-stats — binario único, Linux / macOS / WSL / Windows.