claudit
claudit es una aplicación web auto-alojada que visualiza estadísticas de uso de Claude Code (costes, tokens, latencia) ingiriendo transcripciones JSONL desde almacenamiento durable como Cloudflare R2.
Ficha actualizada 22 sept 2026, 14:53 · upstream 22 sept 2026, 14:01 · release v0.2.0
Qué es claudit
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
claudit es un dashboard web auto-alojado diseñado para visualizar y analizar métricas de uso de Claude Code. La arquitectura consta de un backend en FastAPI que ingesta transcripciones JSONL desde almacenamiento objeto (como Cloudflare R2) hacia una base de datos PostgreSQL, y un frontend React que se sirve directamente sin pasos de compilación.
El sistema expone estadísticas cuantitativas sobre el uso: costes por modelo, desglose de tokens (input/output/cache), latencia de respuesta, tasa de error de herramientas y patrones temporales de actividad. Incluye visualizaciones interactivas con actualizaciones en tiempo real mediante eventos server-sent.
El proyecto se distingue por su enfoque en la precisión contable: ingesta desde almacenamiento durable para evitar pérdida de datos tras el pruning local, cálculo preciso de costes con desglose TTL-cache (5m/1h) y deduplicación cruzada de UUIDs para sesiones de sub-agentes.
- Auditoría de costes para optimizar el presupuesto de IA en proyectos específicos
- Análisis de rendimiento detectando cuellos de botella en latencia o errores de herramientas
- Monitoreo del crecimiento del contexto por sesión para ajustar estrategias de prompts
- Visualización de patrones temporales de actividad para identificar horas pico de uso
- Ingesta desde almacenamiento durable (R2/mirror) que preserva la línea temporal completa evitando pérdida tras pruning local
- Cálculo preciso de costes con desglose TTL-cache (ephemeral_5m × 1.25×, ephemeral_1h × 2× base)
- Frontend React sin build step para despliegue simplificado y actualizaciones en caliente
- Autenticación flexible con modo guest read-only y hashes PBKDF2 externos compatibles
- Dependencia crítica de Cloudflare R2 o mirror local persistente; no lee directamente ~/.claude/projects/
- No realiza análisis cualitativo, coaching ni auditoría de calidad de sesiones
- Requiere configuración manual del esquema PostgreSQL inicial y variables de entorno
- Parsing secuencial que puede ser lento con buckets grandes sin paralelización
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.
Usar systemd con TimeoutStopSec=10 y --timeout-graceful-shutdown 5s para actualizaciones sin interrupciones. Configurar R2_ENDPOINT=file:///ruta/mirror/ para desarrollo local. Verificar PARSER_VERSION en backend/constants.py antes de cambios de precios. Aplicar migraciones de esquema automáticamente al inicio.
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.