Tokenmeter

TokenmeterVersión 1.1.0

Tus límites de Claude y Codex, 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á. ¿También usas Codex? Un selector en la tarjeta muestra sus límites.

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

Pequeños detalles que suman

Junto a la muesca

En un Mac con muesca, Tokenmeter se coloca a su lado: el límite de 5 horas a un lado y el tiempo hasta el reinicio al otro. Pasa el cursor y se despliega con los dos límites, el gasto de hoy y un selector Claude / Codex. En un Mac sin muesca espera en la parte superior de la pantalla.

La vista de la muesca. Cerrada: 62 % del límite de 5 horas y 2:20 hasta el reinicio. Abierta: el selector Claude / Codex, el gasto de hoy y los dos límites.

Gasto y modelos

Abre la vista de estadísticas para verlo todo: lo que costarían tus sesiones de Claude Code y Codex 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 macOS, con datos de demostración. El widget de Windows ofrece las mismas funciones.

Cada sesión, al detalle

Cada sesión de Claude Code y Codex 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 tokenmeter.
  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 icono del widget aparece en la bandeja o la barra de menús con tu primera sesión. Los límites se rellenan en segundos.

macOS 13 y posterioresTu sistema

  1. Descomprime la descarga y ejecuta esto en Terminal, desde la carpeta tokenmeter:
    bash install.sh
  2. Reinicia Claude Code. La línea de estado aparece bajo el prompt y el icono del widget aparece en la bandeja o la barra de menús con tu primera sesión. Los límites se rellenan en segundos.

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

Pulsa el icono para abrir la tarjeta y haz clic derecho para ver el menú. Si el widget no está en marcha, abre Tokenmeter desde el menú Inicio (Windows) o Aplicaciones (macOS).

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.

Se sincronizan cifras, no tu trabajo

El gasto y los tokens por día, modelo y sesión se sincronizan con tokenmeter.nextwell.top, para que tu historial sobreviva a una reinstalación y los dispositivos vinculados vean los totales de los demás. Los títulos de sesión, los nombres de proyecto y los prompts no salen de tu equipo; el país se deduce de tu dirección IP al subir los datos y la dirección no se guarda. Marca «No sincronizar con el servidor» en los ajustes para dejarlo todo en local; «Borrar historial» lo elimina aquí y en el servidor. Los límites se piden a Anthropic con tu propio inicio de sesión de Claude Code, que nunca se renueva ni se envía a ningún otro sitio.

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 de Claude, o un plan de ChatGPT para Codex: los límites vienen de tu cuenta.
  • Node.js para el historial de gasto. Sin él, los límites se muestran igualmente.

Cómo leer las cifras

  • Los límites son las cifras de tu propia cuenta, las que claude.ai muestra en Usage, leídas cada cinco minutos: también cuentan claude.ai y tus otros dispositivos.
  • 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 y Codex. 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