Si usas Claude Code a diario, conoces la sensación: estás a la mitad de una tarea importante y, de repente, llegas al límite de uso. No había una forma cómoda de ver cuánto te quedaba… así que la construimos.

Te presentamos el Claude Usage Widget: una pequeña ventana flotante para Windows que muestra en tiempo real cuánto has consumido de Claude Code, sin abrir el navegador ni interrumpir tu trabajo. Y lo mejor: es gratis y de código abierto — al final de este artículo puedes descargarlo.

Ícono del Claude Usage Widget

Qué es

Es un widget de escritorio (una mini-ventana siempre visible) que se queda en una esquina de tu pantalla mostrando barras de progreso con tu consumo. Lo desarrollamos en Python y lo empaquetamos como un .exe para Windows que funciona con un doble clic, sin instalar nada.

Qué muestra

  • Sesión (5 horas): cuánto llevas usado en tu ventana actual de 5 horas.
  • Límite semanal (todos los modelos): tu consumo de los últimos 7 días.
  • Semanal Sonnet y Semanal Opus: el consumo de cada modelo por separado.
  • Cuenta regresiva: cuánto falta para que cada límite se reinicie.
  • Colores de alerta: naranja cuando vas tranquilo, ámbar al acercarte y rojo cuando estás por llegar al límite.

Se actualiza solo cada 60 segundos, siempre permanece encima de las demás ventanas (puedes anclarlo o mandarlo atrás) y lo arrastras a donde quieras.

Privacidad primero. El widget lee tu sesión local de Claude Code únicamente para consultar la API oficial de uso de Anthropic. No envía tus datos a ningún otro servidor ni los almacena.

Cómo funciona por dentro

El widget lee el token de tu sesión de Claude Code (el archivo que el propio Claude guarda en tu equipo) y consulta el endpoint oficial de uso de Anthropic. Con esa información dibuja las barras y las cuentas regresivas. Está hecho con Python y la librería gráfica tkinter (incluida en Python), y se compila a .exe con PyInstaller. Ligero, sin dependencias externas raras y directo al grano.

Descárgalo gratis

Elige la opción que prefieras. Si solo quieres usarlo, descarga el ejecutable. Si quieres ver o modificar el código, descarga el código fuente.

Ejecutable para Windows

Listo para usar: descomprime y doble clic. No necesita instalar Python.

Descargar .zip ZIP · ~11 MB · Windows 10/11

Código fuente

El script de Python y los .bat de utilidad. Para revisar, aprender o personalizar.

Descargar código ZIP · ~50 KB · Python 3.10+

Cómo usarlo

  1. Descarga y descomprime el archivo .zip del ejecutable.
  2. Entra a la carpeta y haz doble clic en ClaudeUsageGMS.exe.
  3. El widget aparece en la esquina superior derecha. Arrástralo a donde quieras.
  4. Opcional: ejecuta iniciar_con_windows.bat para que arranque solo cada vez que enciendes el PC (y quitar_de_inicio.bat para revertirlo).

Requisitos: Windows 10 u 11 y tener Claude Code instalado con tu sesión iniciada (plan Pro o Max). Para correrlo desde el código fuente necesitas Python 3.10 o superior.

Hecho en casa

Este widget es un ejemplo de lo que hacemos todos los días en Geomaster Solutions: detectar una necesidad real y resolverla con una herramienta a medida, práctica y bien hecha. Si tu negocio tiene un proceso que se podría automatizar o una herramienta que te gustaría tener, podemos construirla. Conversemos.