Monitor de uso de tokens en tiempo real para Claude AI

Domina el uso de tu IA Claude con monitorización en tiempo real

Para los desarrolladores y usuarios intensivos de la IA Claude, gestionar el consumo de tokens puede ser un desafío crucial. Alcanzar los límites de tasa de forma inesperada puede interrumpir los flujos de trabajo y afectar la productividad. Presentamos el Claude-Code-Usage-Monitor, un proyecto robusto de Python de código abierto diseñado para ofrecerte un control y una visibilidad inigualables sobre el uso de tus tokens de la IA Claude.

¿Qué es Claude-Code-Usage-Monitor?

Desarrollada por Maciek-roboblog, esta intuitiva herramienta basada en terminal proporciona una visualización en tiempo real del consumo de tokens de tu IA Claude. Es más que un simple contador; ofrece análisis predictivos, barras de progreso visuales y sistemas de advertencia inteligentes para alertarte antes de que te quedes sin tokens. Ya sea que tengas un plan Pro, Max5, Max20, o límites personalizados variables, este monitor se adapta a tus necesidades.

Características clave que potencian tu flujo de trabajo:

• Monitorización en tiempo real: Se actualiza cada 3 segundos con una suave y fluida visualización, mostrando el consumo de tokens en vivo a través de múltiples sesiones.
• Barras de progreso visuales: Barras de progreso de tokens y tiempo codificadas por colores ofrecen una comprensión inmediata y de un vistazo de tu uso y el tiempo restante de la sesión.
• Predicciones inteligentes: Basándose en tu tasa de consumo actual, el monitor predice con precisión cuándo se agotarán tus tokens, ayudándote a planificar con antelación.
• Sistema de autodetección: Cambia inteligentemente al modo custom_max si tu uso excede los límites de plan estándar, escaneando sesiones anteriores para descubrir tus límites de tokens reales.
• Soporte Multiclase: Funciona perfectamente con Claude Pro, Max5, Max20, y detecta automáticamente los límites personalizados basándose en tu uso anterior.
• Sistema de advertencia avanzado: Recibe alertas cuando tus tokens estén cerca de agotarse o si se prevé que se agoten antes de que tu sesión se restablezca.
• Interfaz de usuario profesional: Disfruta de una interfaz de terminal limpia, colorida y altamente legible, diseñada para la eficiencia.
• Programación personalizable: Establece tus propios tiempos de restablecimiento de sesión y zonas horarias para alinearlos con tu flujo de trabajo personal o de equipo.

Cómo funciona: Entendiendo las sesiones de Claude

La IA Claude opera con una ventana de sesión continua de 5 horas. Esto significa que cada interacción inicia un nuevo reloj de 5 horas para el consumo de tokens. Puedes tener varias sesiones superpuestas, y la actualización de tus tokens ocurre exactamente 5 horas después de tu primer mensaje en cada sesión. El Claude-Code-Usage-Monitor rastrea estas complejas dinámicas, calculando tu 'tasa de consumo' al analizar el uso de tokens de todas las sesiones activas en la última hora para proporcionar predicciones precisas.

Instalación y primeros pasos:

Configurar el Claude-Code-Usage-Monitor es sencillo. El proyecto enfatiza el uso de un entorno virtual para el aislamiento y la portabilidad, evitando conflictos de dependencias con la instalación de Python de tu sistema.

Requisitos previos: * Python 3.6+ * Node.js (para la herramienta CLI ccusage)

Configuración rápida para producción (Recomendado):

1. Instala ccusage globalmente:

   npm install -g ccusage
   

2. Clona el repositorio:

   git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git
   cd Claude-Code-Usage-Monitor
   

3. Crea y activa un entorno virtual:

   python3 -m venv venv
   # En Linux/Mac:
   source venv/bin/activate
   # En Windows:
   # venv\Scripts\activate
   

4. Instala las dependencias de Python:

   pip install pytz
   

5. Ejecuta el monitor:

   python ccusage_monitor.py
   

Para el uso diario, simplemente activa tu entorno virtual y ejecuta el script principal. Incluso puedes configurar un alias de shell para un acceso rápido.

Configuración y uso:

El monitor ofrece varias opciones de configuración a través de argumentos de línea de comandos:

• Especifica tu plan: Usa --plan pro, --plan max5, --plan max20, o --plan custom_max para que coincida con tu suscripción a Claude.
• Tiempos de reinicio personalizados: Ajusta las horas de reinicio de la sesión con --reset-hour <hora> (por ejemplo, --reset-hour 9 para las 9 AM).
• Configuración de zona horaria: Asegura predicciones precisas configurando tu zona horaria, por ejemplo, --timezone US/Eastern o --timezone Asia/Tokyo.

Este nivel de personalización hace que el Claude-Code-Usage-Monitor sea increíblemente flexible, adaptándose a diferentes horarios de trabajo, equipos internacionales y patrones de uso de IA variables.

Por qué necesitas esta herramienta:

Para cualquiera que busque optimizar su interacción con la IA Claude, evitar interrupciones inesperadas del servicio y obtener una comprensión más clara de su gasto de tokens, el Claude-Code-Usage-Monitor es un activo invaluable. Sus predicciones inteligentes y su interfaz profesional transforman la compleja gestión de tokens en un proceso simple, visual y altamente eficiente. Este proyecto de código abierto te permite ser más productivo y rentable en tus tareas impulsadas por la IA.

¡Sumérgete en el proyecto, contribuye y toma el control total de tu uso de la IA Claude hoy mismo!