Claude Usage

Claude UsageVersión 1.0.0

Tus límites de Claude, siempre a la vista

Una línea de estado bajo el prompt y un widget de cristal en el escritorio muestran los límites de 5 horas y semanal, cuándo se reinician y cuánto ha costado cada sesión.

Windows 10/11 · macOS 13 o posterior · un zip con los dos instaladores

El widget contraído: uso de 5 horas al 62 % en naranja con un aviso de que se agotará, uso semanal al 38 % en verde.

Dos formas de tenerlo controlado

En la línea de estado

Bajo el prompt de Claude Code: cuánto contexto llevas, lo que ha usado y costado la sesión y los dos límites con el tiempo que falta para el reinicio. Funciona dondequiera que se ejecute Claude Code.

En tu escritorio

Una pequeña tarjeta flotante muestra ambos límites en verde, naranja o rojo, con una marca que indica cuánto ha transcurrido de la ventana. Si vas a agotar el límite antes del reinicio, te avisa de cuándo ocurrirá.

  • Margen de sobra
  • Cerca del límite
  • Casi agotado

Pequeños detalles que suman

Gasto y modelos

Abre la vista de estadísticas para verlo todo: lo que costarían tus sesiones a precios de API por día, semana y mes, y cómo se reparte entre modelos.

DíasLas dos últimas semanas, barra a barra.
La vista de estadísticas en la pestaña Días: gasto diario de las dos últimas semanas en barras, con el reparto por modelo debajo.
SemanasDetecta las semanas intensas y las tranquilas.
La vista de estadísticas en la pestaña Semanas: gasto semanal en barras.
MesesLa vista de largo plazo, mes a mes.
La vista de estadísticas en la pestaña Meses: gasto mensual en barras.

Capturas: el widget de Windows, con datos de demostración. El widget de macOS ofrece las mismas funciones. Se compila en tu Mac durante la instalación, por eso aquí no hay capturas suyas.

Cada sesión, al detalle

Cada sesión de Claude Code en su propia línea: título, proyecto, hora, tokens y coste, las más recientes primero. Las más caras destacan de un vistazo.

La vista de estadísticas en la pestaña Sesiones: lista de sesiones recientes con proyecto, hora, tokens y coste.

Instálalo en un minuto

Un solo zip incluye los dos instaladores. Ejecuta el de tu sistema.

Windows 10 y 11Tu sistema

  1. Descarga el zip, descomprímelo y abre la carpeta claude-usage.
  2. Haz doble clic en install.cmd, o ejecuta esto en PowerShell:
    powershell -ExecutionPolicy Bypass -File install.ps1
  3. Reinicia Claude Code. La línea de estado aparece bajo el prompt y el widget se abre con tu primera sesión. Los límites se rellenan tras la primera respuesta.

macOS 13 y posterioresTu sistema

  1. Una sola vez: instala las Xcode Command Line Tools. El widget se compila en tu Mac durante la instalación.
    xcode-select --install
  2. Descomprime la descarga y ejecuta esto en Terminal, desde la carpeta claude-usage:
    bash install.sh
  3. Reinicia Claude Code. La línea de estado aparece bajo el prompt y el widget se abre con tu primera sesión. Los límites se rellenan tras la primera respuesta.

Solo lo que necesitas

¿Solo quieres la línea de estado? Instálala sin el widget. ¿Ya lo tienes instalado? Desactiva la línea de estado desde el menú del widget, o evita que el widget arranque con Claude Code: la otra parte sigue funcionando.

Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -NoWidget
macOS
bash install.sh --no-widget

Para abrir el widget a mano, busca Claude Usage en el menú Inicio (Windows) o en Aplicaciones (macOS). Si está oculto, pulsa su icono de la bandeja o de la barra de menús.

Actualizar o desinstalar

Actualizar

Una vez al día el widget pregunta a este sitio si hay una versión nueva. Si la hay, aparece un punto en su botón de actualizar y el menú ofrece la actualización. La petición lleva solo la versión y el sistema, y puedes desactivarla en el menú.

  1. Descarga el zip nuevo desde esta página.
  2. Vuelve a ejecutar el instalador. Tu historial y tus ajustes se conservan.

Desinstalar

Elimina el mod, el widget y sus accesos directos.

Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -Uninstall
macOS
bash install.sh --uninstall

Añade -KeepHistory (Windows) o --keep-history (macOS) para conservar tu historial.

Todo es local

Los límites salen de un archivo que la línea de estado escribe en tu equipo, y el historial de gasto se lee de los registros de sesión del propio Claude Code. No se sube nada y no hay cuenta ni inicio de sesión. La comprobación de actualizaciones es lo único que envía el widget.

Qué necesitas

  • Windows 10 u 11, o macOS 13 o posterior
  • Claude Code con compatibilidad con mods (probado en la 2.1.296). La API de mods está en acceso anticipado y puede cambiar entre versiones.
  • Una suscripción Pro o Max: los límites vienen de tu cuenta.
  • Node.js para el historial de gasto. Sin él, los límites se muestran igualmente.
  • En macOS, las Xcode Command Line Tools: el widget se compila en tu Mac durante la instalación.

Cómo leer las cifras

  • Los límites son los porcentajes que Claude informa con cada respuesta, así que se actualizan cuando usas Claude Code, en cualquier sesión.
  • El coste es lo que costarían esos mismos tokens a precios de API. Una suscripción no se factura así: indica cuánto le sacas.
  • El historial se lee de los registros de sesión locales de Claude Code. El widget lleva su propio libro desde el primer arranque; los periodos anteriores son estimaciones y se dibujan más pálidos.

Entérate antes de quedarte sin límite.

Gratis, de código abierto y discreto: se queda en un rincón hasta que lo miras.

Windows 10/11 · macOS 13 o posterior · un zip con los dos instaladores