Ccusage

ccusage es una potente herramienta de interfaz de línea de comandos (CLI) diseñada para aportar una transparencia esencial al consumo de tokens de Claude Code. Al analizar los archivos de uso JSONL locales generados por Claude Code, ccusage resuelve el problema común para los usuarios con planes ilimitados: cuantificar su uso real, identificar los factores que impulsan los costos y evaluar el valor real derivado de su suscripción. Proporciona informes detallados y procesables para gestionar y optimizar sus interacciones con la IA.

Características Principales

Nos centramos en proporcionar detalles granulares y conocimientos prácticos, garantizando una visibilidad completa de su uso de tokens y sus gastos.

📊 Suite de Informes Exhaustivos

Acceda a datos de uso agregados en múltiples dimensiones, yendo más allá de los simples totales diarios. Los Informes Diarios, Semanales, Mensuales y de Sesión le permiten rastrear tendencias a largo plazo e identificar al instante qué conversaciones o períodos de tiempo impulsaron el mayor consumo. Esta vista granular es esencial para el análisis retrospectivo del uso.

⏰ Bloques de 5 Horas y Monitoreo en Tiempo Real

Rastree el consumo dentro de las ventanas de facturación específicas de 5 horas utilizadas por los sistemas de backend de Claude. Este singular Blocks Report proporciona monitoreo activo, proyecciones de costos y cálculos de tasa de consumo en tiempo real, ofreciéndole alertas tempranas y ayudándole a gestionar el uso de forma alineada con la mecánica subyacente de la plataforma.

💰 Seguimiento Detallado de Costos y Modelos

ccusage proporciona costos estimados en USD basados en el uso actual de tokens y la tarificación específica del modelo. Rastrea automáticamente el uso en diferentes modelos de Claude (Opus, Sonnet, etc.) y ofrece una vista de Desglose por Modelo. Además, distingue con precisión entre tokens estándar y Cache Read/Creation Tokens, proporcionando una imagen más real de sus costos operativos netos.

🔒 Análisis 100% Local y Privado

Su privacidad es primordial. ccusage opera completamente en Offline Mode y realiza todo el análisis localmente en su máquina leyendo los archivos JSONL de Claude Code. Nunca se transmite ni sale de su computadora ningún dato, garantizando una seguridad y soberanía de datos completas sobre sus patrones de uso.

🚀 Huella Ultra-Reducida y Acceso Instantáneo

A diferencia de muchas herramientas CLI complejas, ccusage está diseñado con un tamaño de paquete increíblemente pequeño. Este enfoque en la eficiencia significa que a menudo puede ejecutar la herramienta directamente sin una instalación completa (por ejemplo, usando bunx ccusage), lo que permite un acceso instantáneo a datos de uso críticos con una sobrecarga de configuración mínima.

Casos de Uso

ccusage transforma los datos de uso brutos en conocimientos estratégicos, permitiendo a los usuarios tomar decisiones informadas sobre su flujo de trabajo de IA.

1. Evaluación del Retorno de la Inversión (ROI) para Planes Ilimitados

Si usted está en el plan Max, utilice los Informes Mensuales y de Sesión para calcular cuánto costaría su uso en un plan de pago por uso. Esta comparación proporciona una métrica concreta y cuantificable para determinar si su modelo de suscripción actual ofrece un valor suficiente, ayudándole a justificar o ajustar su plan.

2. Identificación de Flujos de Trabajo Intensivos en Costo

Utilice los Session Reports para identificar proyectos específicos o hilos de conversación que consumen la mayor cantidad de tokens. Al combinar esto con las funciones de Model Tracking y Breakdown, puede determinar si las sesiones de alto costo dependieron desproporcionadamente de modelos premium (como Opus) y evaluar si un modelo de menor costo podría lograr resultados similares para ciertas tareas.

3. Integración de Datos de Uso en Paneles de Control Personalizados

La función JSON Output le permite exportar todo el análisis agregado en un formato estructurado y programático. Desarrolladores y usuarios avanzados pueden canalizar estos datos directamente a sistemas de monitoreo internos, paneles de análisis personalizados o herramientas de hoja de cálculo para un análisis de tendencias más profundo y una integración con sistemas de gestión de proyectos más amplios.

Ventajas Únicas

ccusage ofrece un valor distintivo al centrarse en el detalle granular y el control del usuario sobre los datos.

Informes Granulares Alineados con la Lógica de la Plataforma

No solo ofrecemos resúmenes de calendario; proporcionamos Informes de Bloques de 5 Horas. Este nivel de detalle es crítico porque se alinea con las ventanas de facturación subyacentes de Claude, proporcionándole una comprensión funcional del uso que los informes de calendario estándar pasan por alto.

Soporte Integrado para Ecosistemas de Desarrolladores

El Model Context Protocol (MCP) Server integrado permite a ccusage interactuar sin problemas con otras herramientas y sistemas para desarrolladores. Esta característica posiciona a ccusage no solo como un visor, sino como un componente activo en una cadena de herramientas más grande, permitiendo una automatización e integración más profundas.

Configuración Flexible y Control de Zona Horaria

ccusage ofrece amplias opciones de configuración, incluyendo JSON Configuration Files con soporte IDE para validación y autocompletado, y soporte flexible para Timezone y Locale. Esto garantiza que los informes se agrupen, muestren y formateen con precisión de acuerdo con su entorno operativo específico y ubicación geográfica.

Conclusión

ccusage le proporciona la claridad y el control que necesita para dominar su consumo de Claude Code. Al transformar los datos de uso opacos en informes detallados y procesables, usted adquiere la confianza para optimizar sus flujos de trabajo, rastrear los costos con precisión y maximizar el valor de su inversión en IA.

Descubra cómo ccusage puede ayudarle a tomar el control de su uso hoy mismo. Consulte la herramienta y la documentación en GitHub.