Clase 4 · 16 min
Volver a una sesión grande parada hace dos horas puede costar cientos de miles de tokens en un solo mensaje. No es un error: es la caché que venció. Con los números medidos en octubre de 2026, entiendes la línea de tiempo de una sesión parada y decides, con cuentas, entre reenviar y empezar limpio.
Comenzar la clase
Objetivo: leer la línea de tiempo de una sesión parada (45, 54, 60 min) y elegir entre reenviar y /clear + /prime con los números medidos.
Claude Code, caché de 1 h, contexto por encima de ~200 mil tokens, hook-longrun 1.9.6 activado.
Desplaza la página: cada etapa de abajo enciende su parte del diagrama.
En el evento Stop, con contexto ≥ 200 mil y la carpeta handoffs/ en el proyecto, el hook programa un timer (systemd-run --user, uno por sesión, rehecho en cada respuesta). Si envías otro mensaje, el reloj vuelve a empezar.
Si cambias de foco, Claude Code graba un away_summary en la conversación. Desde la 1.8.6 eso (y comandos locales como /exit) ya no cuenta como "la sesión avanzó": antes, 7 sesiones del 16/10 quedaron sin handoff por eso.
Si la sesión sigue detenida, sin un handoff de esta sesión grabado hasta 5 min antes de la última respuesta, y la caché aún sirve (< 55 min), el hook graba el handoff en una COPIA de la sesión, mismo modelo, caché caliente, que solo puede ejecutar handoff-grava.py y leer archivos. La sesión abierta no se toca.
Claude Code compacta solo tras unos 55 min sin respuesta, únicamente por encima de ~200 mil tokens, antes de que la caché venza. En los registros del 07 al 15/10/2026, las 93 compactaciones llegaron entre 53–58 min después de la última respuesta. Pero no siempre ocurre: el 18/10, una sesión de 480 mil no compactó.
El siguiente mensaje vuelve a leer toda la conversación sin caché. Con más de 150 mil en el contexto, el hook retiene ese primer mensaje una vez y explica: reenviar continúa; /clear + /prime reinicia limpio desde el handoff de esta sesión.
La compactación es un bonus cuando llega. El handoff a los 45 min, grabado con la caché caliente, es lo que garantiza que la vuelta tenga un camino barato.
Por qué 45 y no 50: la compactación por inactividad llega entre 53 y 58 min y la copia tarda 30–60 s más el arranque. A los 45 queda margen; el costo es el mismo a cualquier hora antes de 1 h.
Todos del kit execucao-longa, con la fecha y el tamaño de la muestra.
Con la caché caliente (hasta ~1 h desde la última respuesta), releer la conversación sale por ~10% del precio de entrada. Vencida, reprocesa todo y vuelve a grabar la caché, ~2×: cerca de 20× un mensaje con la caché caliente.
En la suscripción esto no se convierte en dinero, pero sale de la cuota de 5 h y de la semanal. Y se paga una vez: los mensajes siguientes vuelven a ser baratos.
Reenviar con la caché vencida: mediana de 284 mil tokens equivalentes en la primera llamada (190 casos, de 17 mil a 1,25 millones) y ~23 mil por turno después.
/clear + /prime: mediana de 187 mil (solo 11 casos) y ~10 mil por turno después. El piso viene de volver a grabar el paquete inicial (instrucciones, memoria, skills).
Parte de las 190 retomas puede haber pasado por una compactación antes; el /prime tiene solo 11 casos.
Entre 93% y 99% de caché en todas las sesiones largas medidas, sin empeorar con el número de compactaciones. No es motivo para cortar la sesión.
Lo que crece es el costo por turno: sin compactar, el último décimo de una sesión de 1M leyó ~5× más por turno que el primero (810 mil contra 157 mil).
Si las decisiones están en archivos (commits, state.md, handoff), /clear + /prime sale más barato desde ahí en adelante.
Solo vale la pena reenviar y pagar la relectura completa cuando hay una decisión que quedó solo en la conversación y no pasó al handoff.
El mismo ensaio-hook.sh de la clase 3: transcripción falsa con 220 mil tokens y la última respuesta hace 120 min.
rm -rf /tmp/ensaio-hook bash ensaio-hook.sh 220000 120 UserPromptSubmit # 1er mensaje después de la pausa bash ensaio-hook.sh - - UserPromptSubmit # reenviar el mismo bash ensaio-hook.sh 250000 0 Stop # fin de respuesta: agenda el handoff por inactividad cat /tmp/ensaio-hook/agenda.jsonl
LONGRUN_PAUSA_MIN=60 # minutos detenido antes de retener el mensaje LONGRUN_PAUSA_TOKENS=150000 # contexto mínimo para retener; 0 desactiva el bloqueo LONGRUN_OCIOSO_MIN=45 # minutos detenido antes de grabar el handoff (no pases de ~45) LONGRUN_OCIOSO_TOKENS=200000 # contexto mínimo para grabar; 0 desactiva LONGRUN_CACHE_MIN=55 # pasado ese tiempo la copia no corre (la caché ya estaría fría)
$ bash ensaio-hook.sh 220000 120 UserPromptSubmit
{"decision": "block", "reason": "Sessão parada há 2h00: o cache venceu e esta mensagem
vai reprocessar ~220 mil tokens do seu limite. Para continuar aqui, reenvie a mensagem.
Para começar limpo: NENHUM handoff desta sessão foi gravado: antes do /clear, peça para
gravar (skill session-handoff), senão o /prime não terá o caminho deste trabalho."}
$ bash ensaio-hook.sh - - UserPromptSubmit
$ bash ensaio-hook.sh 250000 0 Stop
$ cat /tmp/ensaio-hook/agenda.jsonl
{"unidade": "longrun-ocioso-ensaio", "minutos": 45, "cmd": ["/usr/bin/python3",
".../execucao-longa/tools/hook-longrun.py", "--ocioso", "ensaio", ...]}Con LONGRUN_AGENDAR_ARQ el hook solo registra la programación en un archivo, en vez de crear el timer de verdad. Es la misma variable que usan las pruebas del kit.
Ejemplo del README del kit (sesión detenida hace 5h33 con 220 mil tokens):
● UserPromptSubmit operation blocked by hook: Sessão parada há 5h33: o cache venceu e esta mensagem vai reprocessar ~220 mil tokens do seu limite. Para continuar aqui, reenvie a mensagem. Para começar limpo: /clear e depois /prime (o último handoff do projeto é indicado na abertura).
Desde la 1.7.1, cuando esta sesión grabó un handoff, el aviso trae su ruta en líneas separadas: /clear y /prime handoffs/history/[archivo].md. Otra sesión pudo haber grabado uno más nuevo en el mismo proyecto.
Ensayo sin costo y un ajuste que protege tus transcripciones.
Ejecuta el bloque de la pausa de 2 h. Después ejecútalo con 90000 tokens en lugar de 220000, en una carpeta limpia, para ver el límite de 150 mil.
Listo cuando: la 1.ª llamada imprime "decision": "block" con cache venceu; el reenvío (-) no imprime nada; con 90 mil no hay bloqueo; agenda.jsonl muestra "minutos": 45.
Claude Code borra las transcripciones después de cleanupPeriodDays (por defecto 30). Sin ellas, no hay medición ni recall (clase 7). Pon 365 en settings.json.
Listo cuando: python3 -c "import json,os;print(json.load(open(os.path.expanduser('~/.claude/settings.json'))).get('cleanupPeriodDays'))" → 365.
Pregunta 1 de 4
¿Por qué el hook graba el handoff por inactividad a los 45 min, y no a los 58?competencia
Pregunta 2 de 4
En las mediciones de octubre, la caché de las sesiones largas...competencia
Pregunta 3 de 4
Sesión detenida hace 3 h, 300 mil tokens, todas las decisiones ya en el handoff de esta sesión. ¿Qué hacer al volver?
Pregunta 4 de 4
La traba de la pausa bloqueó tu mensaje. Quieres continuar en esta sesión. ¿Qué hacer?
Elige una alternativa. La explicación aparece después de tu intento.