Medidor de contexto: uso de contexto de Claude Code en la barra de estado

Medidor de contexto muestra el uso de contexto de Claude Code en la barra de estado. Escribe una única línea compacta en la barra de estado: ctx 42% · 5h 23% · 7d 61.5% · $1.20. Es decir, cuánto está ocupada la ventana de contexto, qué parte de tus ventanas de plan de 5 horas y 7 días has gastado (con una suscripción) y cuánto ha costado la sesión hasta ahora. Cuando el contexto llega al 80 por ciento, un toast te avisa una vez para que puedas usar /compact o /clear antes de que Claude empiece a perder detalles anteriores.

La idea es dejar de adivinar. Ya no necesitas ejecutar /cost o /context para saber si una tarea larga va a caber, y el aviso llega con antelación suficiente para compactar cuando a ti te convenga. Requiere Claude Code 2.1.287 o posterior.

La grabación inicia una sesión con el mod cargado. La barra de estado muestra ctx – hasta la primera respuesta y, cuando termina el turno, se rellenan el porcentaje de contexto, las ventanas del plan y el coste.

Elige uno de los métodos del bloque de instalación. No hace falta configurar nada; los valores por defecto muestran todo lo que ofrece la cuenta.

Todo el mod son tres hooks y una función de actualización. Extraído de hooks/register.ts:

async function refresh($: EngineInterface, meter: Meter): Promise<void> {
  // No `breakdown`: the status-line figures alone, which cost no request.
  const usage = await $.session.usage()
  $.ui.status(formatMeter(usage, meter))
  const percent = contextPercent(usage)
  const step = warnStep(percent, meter.warnAtPercent, meter.warned)
  meter.warned = step.warned
  if (step.toast) {
    $.ui.toast(`Context is ${percent}% full. Consider /compact or /clear soon.`)
  }
}

$.session.usage() devuelve los tokens de contexto y la ventana, los límites de uso del plan y el coste. Si se llama sin desglose, lee números que Claude Code ya tiene, así que el medidor puede ejecutarse tantas veces como quiera sin coste alguno. formatMeter, en hooks/format.ts, construye el texto y omite cualquier cifra que el motor no tenga en lugar de imprimir un cero. warnStep recuerda si ya avisó, de modo que el toast aparece una vez cada vez que se cruza el umbral; si una compactación devuelve el contexto por debajo del umbral, puede volver a avisar.

refresh se llama desde session.start (que además inicia un temporizador con $.clock.every), desde turn.complete solo para los turnos del bucle principal, y desde session.compact. session.compact puede cancelar una compactación, así que su hook espera primero a next(e) y lleva un .catch que devuelve aquello en lo que se resolvió next. El medidor nunca detiene una compactación.

Ajusta estas opciones en /config. format: verbose escribe la línea completa como Context 42% (84k/200k) · 5-hour 23% · 7-day 61.5% · Cost $1.20. Las etiquetas están en la tabla LIMIT_LABELS de hooks/format.ts, así que ese es el lugar para renombrar 5h o 7d. El texto del aviso es la plantilla de cadena dentro de refresh.

La única insignia es Modifica la interfaz: el mod escribe en la barra de estado y muestra un toast. No ejecuta comandos, no lee ni escribe archivos, no usa la red, no lee tus prompts ni llama al modelo. Eso lo convierte en uno de los mods más seguros que puedes instalar, y en un buen primer mod.

Para desactivarlo, ejecuta /plugin disable cm-context-meter. Para iniciar una sesión con todos los mods desactivados, usa claude --safe-mode.

Probado con Claude Code 2.1.291 en la terminal de macOS. Si el medidor no aparece:

• Comprueba claude --version; los mods necesitan la 2.1.287 o posterior.
• Asegúrate de que el mod esté habilitado en la pestaña Installed de /plugin.
• Después de una instalación desde la shell, ejecuta /reload-plugins en las sesiones que ya estaban abiertas.
• Otro mod o un comando de barra de estado personalizado puede compartir la línea. Desactiva brevemente otros mods de estado para ver si el texto está quedando desplazado.
• Que no aparezcan cifras del plan con una clave de API es el comportamiento esperado.

La cifra de coste es la misma estimación de sesión que totaliza /cost; no es una factura.