Claude Code Mods: controla el contexto y repasa ediciones sin confundir señales con pruebas

En una sesión larga de Claude Code suelen aparecer dos preguntas distintas: cuánto creció el contexto tras el último turno y qué operaciones de edición de archivos llegó a invocar Claude. El playground de Anthropic ofrece un ejemplo para cada necesidad. Token Weather muestra el uso del contexto de la sesión principal; Replay Theater permite recorrer las llamadas de edición del último turno que modificó archivos.

La frontera importante es esta: ambos dan observabilidad, pero ninguno hace la aceptación del trabajo. Un porcentaje de contexto no representa saldo, coste ni finalización. Que una edición aparezca en el replay no demuestra que se autorizó, se ejecutó con éxito o siga presente en el archivo final.

Elige el Mod según la pregunta que necesitas responder

Pregunta	Carga primero	Qué muestra	Qué no demuestra
¿Cuánto ocupa el contexto principal y creció de forma brusca en los últimos turnos?	Token Weather	Context tokens, tamaño de ventana, porcentaje y tendencia de 12 turnos	Saldo de suscripción, cargo, solicitudes restantes o tarea terminada
¿Qué llamadas Edit, Write o MultiEdit ocurrieron en el último turno con ediciones?	Replay Theater	Archivo, herramienta, texto local antes/después y un diff breve	Aprobación, éxito de la herramienta, estado final del disco o tests aprobados

Para diagnosticar, carga uno cada vez. Ambos ejemplos pueden dibujar en AbovePrompt. Sus README explican que esta banda se comparte; si otro Mod la usa, solo uno puede quedar visible.

Comprueba versión y confianza antes de ejecutar código

Los README actuales de los ejemplos requieren Claude Code 2.1.287 o posterior y están pensados para el terminal. Comprueba primero el cliente:

claude --version

Estos Mods pertenecen al playground de Anthropic DevRel. El repositorio los presenta “tal cual”, sin soporte ni garantía de que sigan funcionando cuando cambien Claude Code, la API o los modelos. Antes de ejecutarlos, revisa README.md, .claude-plugin/plugin.json, hooks/hooks.json y el módulo de hooks del directorio elegido.

Un Mod se ejecuta con tus permisos de usuario; “solo dibuja interfaz” no es una barrera de seguridad. Para la primera prueba, usa --plugin-dir durante una sola sesión. Al cerrar ese proceso de Claude Code termina el experimento y evitas convertir una prueba diagnóstica en una instalación permanente.

Clona los ejemplos oficiales y valida el elegido

git clone https://github.com/anthropics/claude-code-playground.git
cd claude-code-playground/claude-code/mods

Descargar el repositorio no garantiza que la estructura del Mod sea válida. Valida el directorio exacto antes de iniciar la sesión.

Para Token Weather:

claude plugin validate ./token-weather
claude --plugin-dir ./token-weather

Para Replay Theater:

claude plugin validate ./replay-theater
claude --plugin-dir ./replay-theater

Si validate informa de un error, detente y restaura el manifest, la configuración de hooks o el módulo indicado. No continúes suponiendo que Claude Code ignorará de forma segura un paquete dañado. En la sesión nueva, /plugin ayuda a comprobar qué se cargó. La señal funcional llega después: Token Weather debe actualizarse al terminar un turno del bucle principal; Replay Theater necesita un turno finalizado que realmente invoque ediciones de archivos.

Lee Token Weather como telemetría de contexto, no como factura

Después de cada turno principal, Token Weather llama a $.session.usage() y lee tokens, window y percent dentro de context. Dibuja una línea sobre el prompt, conserva las últimas 12 lecturas e indica cuánto añadió el turno más reciente.

Los campos significan:

• tokens: contexto de entrada sobre el que se respondió la última vez, sumando input sin caché, escrito en caché y leído de caché;
• window: ventana de contexto del modelo de la sesión;
• percent: relación tokens / window.

Un 0% antes de la primera respuesta es normal: todavía no existe usage informado. La banda se actualiza una vez al acabar el turno, no de forma continua durante su ejecución. Los turnos de subagentes no producen una lectura independiente del bucle principal.

Por qué el porcentaje puede diferir del aviso de compactación

Token Weather divide por la ventana completa de contexto. El aviso auto-compact de Claude Code se calcula respecto a un punto de compactación inferior, de modo que ambos porcentajes pueden diferir. En una captura oficial del ejemplo, Token Weather mostraba 81% y el aviso del cliente 90%. Es una demostración de dos escalas bajo esas condiciones, no dos números que deban coincidir en tu sesión.

Las barras del historial son relativas a la lectura más alta visible. Por eso puede haber variaciones gráficas grandes aunque el porcentaje absoluto sea pequeño. Para una lectura absoluta usa el porcentaje y el número de tokens. El historial se reinicia al empezar una sesión o recargar el plugin.

Qué conclusión sí permite Token Weather

Puedes afirmar: “El contexto de entrada de la sesión principal creció mucho en los últimos turnos”. No puedes afirmar: “A mi cuenta le queda 19%”, “este turno costó una cantidad concreta” o “la tarea terminó”. La caché cambia el tratamiento de facturación, pero el input en caché sigue ocupando contexto. Saldo, cargo y estado deben comprobarse en el registro del proveedor.

Usa Replay Theater para revisar intentos de edición

Tras cargarlo, pide a Claude una tarea que realmente modifique archivos y espera a que termine el turno. Cuando aparezca la pista, abre el replay:

/replay

También puedes enfocar la banda con ctrl+x, Tab y pulsar r. Dentro del panel:

Tecla	Acción
n	Paso siguiente
p	Paso anterior
c o Escape	Cerrar

Cada paso muestra archivo, herramienta, líneas añadidas/eliminadas y un diff corto. El ejemplo limita cada paso a 12 líneas. Para Edit, compara old_string con new_string, no el archivo completo, y no muestra números de línea. Para Write, lee el contenido anterior del disco justo antes de la llamada; en archivos de más de 400 líneas no realiza una correspondencia completa.

Por qué una edición del replay puede no existir al final

Replay Theater registra la llamada antes de pasarla. Una edición que rechaces o una llamada que falle puede seguir apareciendo. Una llamada posterior también puede sobrescribir o revertir una anterior.

El replay vive en memoria durante la sesión actual. Reiniciar Claude Code o recargar el plugin lo elimina. Un turno posterior sin ediciones conserva el replay previo. Úsalo para saber “qué intentó Claude”, no como instantánea del repositorio final.

Acepta el trabajo leyendo el repositorio real

Termina siempre con los archivos reales:

git status --short
git diff --stat
git diff -- path/to/file
git diff --check

git status --short muestra altas, cambios y borrados reales. git diff --stat descubre un alcance inesperadamente amplio. Lee el diff completo de los archivos importantes en vez de depender del recorte de 12 líneas. Ejecuta git diff --check para detectar errores de espacios y luego el test, type check o build más pequeño directamente relacionado con los archivos cambiados.

Define criterios observables: “la función objetivo cambió de nombre, todas las referencias se actualizaron, el test relevante pasa y no hay archivos ajenos”. “El replay mostró cinco pasos verdes” no es un criterio de aceptación.

Comprueba el uso real en el registro del proveedor

Token Weather muestra lo lleno que está el contexto; no calcula una factura de API. Con cualquier proveedor, localiza la solicitud por hora y modelo y revisa status, input/output tokens, cache tokens aplicables y cargo registrado.

Si BetterToken es la ruta API de Claude Code, su página actual indica que model, time, token counts, cache usage, final cost y status se conservan juntos en un registro de solicitud. Usa ese registro para verificar el uso real. Esto no significa que BetterToken proporcione los Mods, guarde el prompt/respuesta completos o acepte automáticamente el cambio. La conexión se explica en la guía de BetterToken para Claude Code.

Resuelve fallos en el orden más corto

Falla claude plugin validate

Lee el archivo y campo exactos del error. Confirma que estás en claude-code-playground/claude-code/mods, que el descargador no cambió nombres de archivos ocultos y que el checkout está intacto. No lances el Mod hasta revalidar.

Token Weather no aparece o sigue en 0%

Usa el terminal, no solo el panel de chat de VS Code; confirma 2.1.287 o posterior y que la sesión cargó el Mod correcto. Envía una solicitud normal y espera a que termine el turno principal. Cero antes de la primera respuesta es normal.

Replay Theater no muestra la pista

Confirma que el turno invocó Edit, Write o MultiEdit y que ya terminó. Leer archivos, responder una pregunta o ejecutar solo comandos Bash no genera un paso de edición para Replay Theater.

El replay no coincide con git diff

Confía en los archivos. La edición pudo rechazarse o fallar, una llamada posterior pudo sustituirla, el panel puede mostrar solo un fragmento o un restart/reload puede haber cambiado el estado en memoria. Revisa el diff completo y los tests específicos.

Dos Mods no aparecen juntos

Desactiva uno y abre una sesión nueva con el otro. Como comparten AbovePrompt, la ausencia de una segunda banda no demuestra que el paquete esté roto.

El ciclo mínimo fiable

Elige Token Weather para estudiar crecimiento de contexto y Replay Theater para saber qué llamadas de edición ocurrieron. Cargar el Mod es solo el primer paso; ver el indicador o replay es el segundo. El tercero siempre es inspeccionar los archivos reales, ejecutar la validación mínima pertinente y, cuando importe el consumo, comprobar el registro del proveedor. Así la visibilidad del proceso se convierte en resultado verificado.