lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración avanzado claude-codejevtypesafecontextohooks

Fast Jev Compaction: recorta historial de herramientas en Claude Code

Continúa tareas largas en Claude Code con menos historial de herramientas. Jev selecciona qué conservar al compactar, mantiene los mensajes de usuario y asistente y recurre al resumen integrado si falla.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.


Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: comprueba la interfaz de hooks

Lee el README del hook. La referencia del proyecto es Claude Code 2.1.274 con function hooks de acceso anticipado. No asumas compatibilidad con cualquier versión que admita plugins.

Paso 2: habilita la función y prepara la clave

El hook documenta estas variables:

export CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1
export TYPESAFE_API_KEY="<your TypeSafe key>"

El segundo valor es un marcador que debes sustituir en tu entorno privado. No lo copies al chat ni a archivos versionados. Antes de una prueba en vivo, ten en cuenta que el estado de conversación se envía a TypeSafe y genera consumo.

Paso 3: instala el plugin

Desde el mismo entorno:

claude plugin marketplace add tamaratran/fast-jev-compaction
claude plugin install fast-jev-compaction@fast-jev-compaction

Conserva inicialmente las opciones predeterminadas. Reinicia Claude Code o ejecuta /reload-plugins, como indica el README principal.

Paso 4: prueba la compactación

En una sesión de prueba con varias lecturas de herramientas, utiliza /compact. El plugin también participa en la compactación automática. No construyas la primera prueba con datos confidenciales.

Comprobación

Observa el aviso: kept N/M messages, no summary indica que se aplicó la poda; fallback to built-in summary indica el retorno al resumen integrado. Una sesión demasiado corta puede producir ese retorno sin que exista un error de instalación.

Comprueba que las instrucciones textuales siguen presentes y revisa el registro de decisiones de las herramientas. No interpretes una salida eliminada como memoria conservada.

Si algo falla

Comprueba que Claude Code heredó las variables, que la versión admite la interfaz y que la clave tiene acceso al servicio. El hook documenta errores de API, respuesta inválida, falta de espacio y reducción insuficiente como motivos de retorno al resumen. Revisa el registro antes de modificar umbrales o límites.

ver en .md ¿Prefieres el recurso entero?

Qué es

Fast Jev Compaction es una biblioteca y un plugin de Claude Code que reducen historial eliminando o recortando llamadas y resultados de herramientas. Cuando la poda se aplica, los mensajes de texto del usuario y del asistente conservan su contenido y orden.

Para qué te sirve

  • Mantener instrucciones textuales literales durante sesiones largas.
  • Retirar lecturas y resultados que ya no aportan a la tarea.
  • Observar qué decidió conservar el modelo y cuándo el plugin vuelve a la compactación integrada.

Cómo funciona

La biblioteca empareja cada llamada con su resultado. Protege el primer mensaje y un conjunto de mensajes recientes; para el resto, pregunta a Jev si debe conservar la llamada y si todavía necesita su resultado íntegro. Según las probabilidades y el umbral, conserva ambos, recorta la salida o elimina la pareja.

El estado enviado a Jev incluye textos e inputs de herramientas, pero sustituye los resultados por notas breves. Para caber en el límite del estado puede abreviar textos o inputs en esa petición. Esto es distinto de la salida podada, donde los textos conservan su forma original. Una conversación grande puede dividir las preguntas entre varias peticiones.

Antes de empezar

Necesitas una clave de TypeSafe y una versión de Claude Code con function hooks. El proyecto usa como referencia la 2.1.274 y exige activar la función de acceso anticipado. Una actualización del arnés puede cambiar esta interfaz; comprueba la versión antes de instalar.

Las llamadas a TypeSafe consumen servicio externo y reciben parte del contenido de tu conversación. El plugin permite configurar umbral, mensajes protegidos y reducción mínima. GitHub registra MIT, repositorio no archivado y último commit del 17 sep 2026.

Límites y alternativas

La decisión de descartar una salida es probabilística. Que el texto del usuario siga literal no conserva el contenido de un resultado eliminado. Además, los tamaños de tokens son estimaciones, y repetir el estado entre peticiones tiene coste.

Si falta la clave, falla Jev, la respuesta es inválida, no cabe el estado o la reducción es insuficiente, el hook recurre al resumen integrado de Claude Code. En esa ruta ya no se aplica la promesa de conservar mensajes literalmente. Empieza con una sesión desechable y comprueba el aviso de resultado.

La compactación integrada sigue siendo la alternativa sin este plugin. No necesitas añadir un servicio si el resumen habitual basta para tu trabajo.

Recursos