Claude Code ahora compacta las sesiones largas mientras no estás: vuelves a un resumen, no a tu contexto completo (2026)

Claude Code ya compactaba las conversaciones a medida que se acercaban al límite de contexto, resumiendo el historial para que el trabajo pudiera continuar. Ese proceso se ejecuta mientras estás trabajando.

La compactación por inactividad añade un segundo desencadenante. La referencia de configuración de Anthropic lo describe de esta manera: "La compactación por inactividad compacta una conversación larga de la que te has alejado, poco antes de que expire su caché de prompts". Continúa: "Tu próximo mensaje enviará un resumen en lugar de toda la conversación".

Cuando regresas, la conversación muestra Compacted while idle, before the prompt cache expired.

El anuncio de Lydia Hallie explica el motivo: "Ahora compacta las sesiones inactivas largas justo antes de que expire la caché de prompts (~1h)". Si regresas más tarde, Claude solo tiene que volver a procesar el resumen en lugar de toda la conversación, lo que, según ella, "te ahorra algo de uso". En el mismo hilo, señaló los dos controles: "idleCompaction": false en settings.json lo desactiva, y la variable de entorno CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS establece un umbral personalizado.

La documentación enumera cinco condiciones. Todas ellas deben cumplirse.

• Sesión. Estás en una sesión de terminal interactiva.
• Caché de prompts. La conversación está en el TTL de caché de prompts de una hora.
• Feature flags. Claude Code puede obtener feature flags de Anthropic.
• Tamaño. El contexto de la conversación ha alcanzado el umbral de tokens, que por defecto es de 200,000.
• Tiempo de inactividad. Han pasado unos 54 minutos desde la última solicitud y tu ordenador está encendido en ese momento.

Dos de estas condiciones reducen la audiencia más de lo que parece a primera vista.

La caché de una hora depende de cómo pagues. La página de almacenamiento en caché de prompts de Anthropic dice: "A menos que elijas un TTL tú mismo, Claude Code solicita el TTL de una hora solo en una suscripción de Claude dentro del uso incluido de tu plan". Con una clave de API o un proveedor de nube, la conversación principal tiene por defecto una caché de cinco minutos. Una vez que un suscriptor supera el límite de uso del plan y recurre a créditos de uso, Claude Code también reduce la conversación principal al TTL de cinco minutos. Por lo tanto, de forma predeterminada, la compactación por inactividad afecta principalmente a los suscriptores que trabajan dentro de su plan.

El umbral predeterminado importa principalmente para sesiones de 1M de tokens. La referencia de configuración señala que "Por defecto, una conversación en una ventana de contexto de 200K se auto-compacta antes de alcanzar los 200,000 tokens". En otras palabras, una sesión en una ventana de 200K generalmente se compacta de la manera habitual antes de que se pueda aplicar la compactación por inactividad. Con el valor predeterminado, las sesiones que califican son principalmente las que se ejecutan con una ventana de un millón de tokens.

Puedes reducir el umbral si deseas la compactación por inactividad en sesiones más pequeñas. La documentación dice: "Los valores inferiores a 100000 se elevan a 100000, el umbral más bajo".

La caché de prompts evita que Claude Code vuelva a procesar el prefijo sin cambios de una conversación en cada solicitud, pero solo dura un tiempo determinado. La documentación de Anthropic explica qué sucede cuando caduca: "Después de un intervalo de tiempo suficientemente largo, la siguiente solicitud vuelve a calcular la entrada completa y restablece la caché, razón por la cual el primer turno al regresar después de alejarse puede ser notablemente más lento".

Para una sesión de varios cientos de miles de tokens de longitud, esa primera solicitud de regreso es costosa. La compactación por inactividad resume el historial mientras la caché aún está caliente, por lo que tu próximo mensaje lleva el resumen en su lugar.

Claude Code ya tenía una versión de esta opción para sesiones reanudadas. En un plan Pro o Max, al reanudar una sesión que ha estado inactiva durante más de una hora aproximadamente y supera los 100,000 tokens, Claude Code abre un cuadro de diálogo que ofrece reanudar desde un resumen o reanudar la sesión completa tal como estaba. La documentación es clara sobre la contrapartida: "Reanudar tal cual mantiene todos los detalles de la conversación disponibles, a un costo por solicitud que escala con el tamaño de la conversación". Reanudar desde el resumen cuesta menos en las solicitudes posteriores, "pero lo que sea que el resumen deje fuera ya no estará en el contexto de Claude".

La compactación por inactividad toma la decisión más económica con anticipación para una sesión de terminal que dejaste abierta. La documentación describe el aviso que ves al regresar y los ajustes que cambian el comportamiento. No describe un aviso previo antes de que se ejecute la compactación. Si deseas la otra opción, debes configurarla con anticipación.

Una sesión compactada no está vacía. Claude Code reconstruye parte del contexto desde el disco, y la documentación de la ventana de contexto de Anthropic detalla qué sucede con cada tipo de contenido.

Reinyectado desde el disco: el archivo CLAUDE.md de la raíz del proyecto y las reglas sin alcance (unscoped), la memoria automática (auto memory) y el plan que Claude escribió en modo plan.

Recargado bajo demanda: reglas con frontmatter paths: y archivos CLAUDE.md anidados en subdirectorios. Estos regresan cuando Claude interactúa con un archivo coincidente, no de inmediato.

Vuelto a leer: hasta cinco de los archivos que Claude leyó o editó, primero los modificados más recientemente. "Un archivo de más de 5,000 tokens regresa como una referencia de ruta sin su contenido", por lo que un archivo grande debe leerse nuevamente antes de que Claude pueda usar su contenido.

Reinyectado con límites: cuerpos de habilidades (skills) invocadas, hasta 5,000 tokens por habilidad y 25,000 tokens en total, descartando primero las más antiguas.

Resumido: todo lo demás en la conversación, incluido el contexto que los hooks agregaron anteriormente.

Esa última categoría es donde radica el riesgo. Una restricción que mencionaste en el chat, la razón por la que rechazaste un enfoque, el resultado exacto del error en el que estabas trabajando y la decisión que tomaste hace cuarenta minutos solo existen en la conversación. Después de la compactación, solo existen en la medida en que el resumen los haya capturado. La descripción general de Anthropic sobre cómo funciona Claude Code dice lo mismo sobre la compactación en general: se conservan tus solicitudes y fragmentos de código clave, mientras que "las instrucciones detalladas del principio de la conversación pueden perderse".

Las reglas con alcance de ruta (path-scoped) merecen una nota aparte. La documentación explica que "Las reglas con alcance de ruta y los archivos CLAUDE.md anidados se cargan en el historial de mensajes cuando Claude lee, escribe o edita su archivo desencadenante, por lo que la compactación los resume junto con todo lo demás". Regresan la próxima vez que Claude interactúe con un archivo coincidente, pero hasta entonces forman parte del resumen en lugar de las reglas.

Asumir que la compactación por inactividad es un error. Es un comportamiento predeterminado documentado. La referencia de configuración lo enumera, la nota de lanzamiento lo anuncia y la documentación de hooks lo incluye en el desencadenante auto para los hooks PreCompact y PostCompact.

Asumir que el resumen conservará lo que dijiste hace una hora. El resumen conserva lo que el proceso de resumen juzga importante. El archivo CLAUDE.md de la raíz del proyecto, las reglas sin alcance y la memoria automática regresan desde el disco. Las declaraciones hechas solo en el chat pueden conservarse o no.

Asumir que desactivar la auto-compactación deja activa la compactación por inactividad. La variable de entorno DISABLE_AUTO_COMPACT desactiva ambas, y la documentación añade que "El comando manual /compact sigue estando disponible".

Paso 1: Decide si la compactación por inactividad debe ejecutarse para este trabajo

La compactación por inactividad es una buena opción predeterminada para el trabajo exploratorio, donde el costo de una sesión larga importa más que la redacción exacta de lo que se dijo. Es una opción menos adecuada para una sesión de depuración donde los detalles son lo fundamental.

Para desactivarla, establece "idleCompaction": false en un archivo de configuración. La clave puede ir en cualquier archivo de configuración, por lo que puedes desactivarla para un proyecto en la configuración de ese proyecto y dejarla activada en todos los demás lugares. La clave requiere Claude Code v2.1.290 o posterior. "En una versión anterior, que ignora esta clave, desactiva autoCompactEnabled para detener la compactación por inactividad".

Para mantenerla pero cambiar cuándo se aplica, establece CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS en el bloque env de tu configuración. Un número más alto la limita a tus sesiones más grandes. Un número más bajo, hasta 100,000, la extiende a sesiones en una ventana de 200K.

Para una sola sesión, DISABLE_AUTO_COMPACT desactiva la compactación por inactividad junto con la auto-compactación.

Si usas hooks, un hook PreCompact con el comparador auto también se activa para la compactación por inactividad, y para la compactación activada antes del límite de contexto, bloquearlo significa que "Claude Code lo omite y la conversación continúa sin compactar". El mismo comparador cubre la auto-compactación regular, así que realiza pruebas antes de confiar en él.

Paso 2: Antes de alejarte, coloca lo que debe sobrevivir donde la compactación lo vuelva a leer

La forma más segura de conservar algo a través de una compactación es mantenerlo fuera de la conversación. El consejo de Anthropic es directo: "Coloca reglas persistentes en CLAUDE.md en lugar de confiar en el historial de la conversación".

Antes de un descanso en una sesión larga, dedica dos minutos a esto:

• Mueve las reglas permanentes al archivo CLAUDE.md de la raíz del proyecto. Las restricciones que se aplican a toda la tarea pertenecen allí. Mantén el archivo corto; la guía de memoria de Anthropic recomienda apuntar a menos de 200 líneas por archivo.
• Escribe las decisiones de la sesión en un archivo de notas. Una línea por decisión, con el motivo. Apunta a él desde CLAUDE.md para que Claude sepa que existe.
• Compacta bajo tus propios términos. Si prefieres elegir el resumen tú mismo, ejecuta /compact con un enfoque antes de irte, como /compact focus on the auth bug fix. La descripción de esta opción en la documentación es exactamente el punto clave: "El resumen conserva lo que tú elijas en lugar de lo que el proceso automático adivine que es importante".

Anthropic también documenta una sección de Instrucciones de Compactación (Compact Instructions) en CLAUDE.md para dirigir lo que la compactación preserva, y la guía de auto-compactación enlazada al principio de este artículo cubre cómo escribir una.

Paso 3: Cuando veas el aviso de inactividad, revisa el resumen antes de continuar

Cuando regreses y veas Compacted while idle, before the prompt cache expired, no retomes el trabajo a mitad de un pensamiento. Revisa primero.

• Pídele a Claude que vuelva a leer tu archivo de notas y vuelva a exponer el estado del trabajo. Cuál es el objetivo, qué se ha decidido, qué se ha descartado, qué sigue. Compara la respuesta con tus notas del Paso 2.
• Restaura cualquier elemento que falte en el archivo, no solo en el chat. Si una restricción no sobrevivió, agrégala a CLAUDE.md o a tu archivo de notas además de volver a exponerla, para que la próxima compactación no la vuelva a descartar. Nuestra guía sobre cómo Claude Code olvida tus correcciones cubre este patrón con más detalle.
• Haz que Claude vuelva a leer archivos grandes. Los archivos de más de 5,000 tokens regresan como referencias, no como contenidos.
• Conserva una copia del resumen. Un hook PostCompact recibe el resumen generado en su campo compact_summary. Escribir eso en un archivo te permite ver exactamente a partir de qué está trabajando Claude.

Para confirmar qué sucedió con la caché, el bloque Session en /usage incluye una línea Prompt cache (main) en versiones recientes. Informa si la caché está caliente y cuenta las compactaciones como reconstrucciones esperadas.

Las notas del Paso 2 son la parte de una sesión larga que vale la pena conservar más allá de cualquier compactación o sesión individual. MemoryLake es una capa de memoria para mantener ese tipo de registro en una lista que tú administras, disponible para Claude Code y los demás asistentes que utilices.

Tú mismo escribes las entradas, con tus propias palabras. No se lee, escribe ni elimina nada de tus sesiones de Claude Code, transcripciones, resúmenes, memoria automática ni de la tienda de ningún proveedor. Verifica la política de tu organización antes de almacenar detalles del proyecto fuera de tu repositorio.

Paso 1: Crea una clave de API

Inicia sesión y genera una clave desde el panel de control. La clave pertenece a tu espacio de trabajo de MemoryLake y es independiente de tu cuenta de Anthropic.

Paso 2: Sube tus primeras memorias

Comienza con las decisiones que menos te gustaría explicar dos veces: la restricción que se sigue perdiendo, el enfoque que descartaste y por qué, la convención de la que depende el proyecto. Una decisión por entrada, con fecha.

Paso 3: Conecta tu IA y agentes

Conecta Claude Code y cualquier otro asistente que utilices. Las mismas decisiones estarán disponibles en cada nueva sesión, ya sea que la última haya terminado normalmente, se haya compactado mientras no estabas o se haya ejecutado en una herramienta diferente.

La primera diferencia es el costo. Una sesión larga a la que regresas después del almuerzo ya no necesita un procesamiento completo en el primer mensaje, que es la razón por la que Anthropic creó la función.

La segunda es que dejar una sesión grande abierta ya no es neutral. Si cumple con las condiciones, regresas a un resumen. Eso está bien para muchas tareas. Para algunas, es la diferencia entre que Claude recuerde por qué se rechazó una solución y que la vuelva a proponer.

La tercera es que los archivos importan más. Lo que la compactación vuelve a leer desde el disco regresa intacto, y un archivo de notas está a una sola solicitud de distancia; lo que vive solo en el chat regresa tan bien como lo haya capturado el resumen. Esa regla ya se aplicaba a la compactación regular y a las nuevas sesiones, como cubre nuestra guía sobre cómo Claude Code olvida el contexto del proyecto. La compactación por inactividad también la aplica a los descansos.

La cuarta es un hábito. Escribir las decisiones antes de un descanso protege contra la compactación por inactividad, la compactación regular y el cierre de la terminal por igual, la misma idea detrás de nuestra guía para compartir contexto entre sesiones de Claude Code.

Saber si estás en la caché de una hora. Con una clave de API y la configuración predeterminada, la conversación principal utiliza la caché de cinco minutos, por lo que no se cumplen las condiciones de la compactación por inactividad.

Desactívalo por proyecto, no en todas partes. Utiliza la configuración del proyecto para repositorios con mucha depuración y deja el valor predeterminado en los demás lugares.

Escribe las decisiones antes de los descansos. Un archivo de notas con fecha cuesta minutos y permanece en el disco a través de cualquier tipo de compactación.

Revisa después del aviso de inactividad. Pide una reformulación antes de continuar.

Lleva el archivo de notas con el trabajo. Si continúas en otra máquina, el archivo va con él, como cubre nuestra guía para exportar una sesión de Claude Code.

La compactación por inactividad es un intercambio razonable, y Anthropic ha sido transparente al respecto. Una sesión larga que se deja inactiva durante unos 54 minutos en la caché de una hora se resume antes de que expire la caché, por lo que el primer mensaje de regreso es más económico. El costo es que Claude continúa desde un resumen en lugar de tu contexto completo.

Puedes desactivarla, cambiar su umbral o mantenerla. Si la mantienes, la respuesta es la que ya se aplicaba a la compactación regular: reglas permanentes en CLAUDE.md, decisiones en un archivo antes de alejarte y una revisión de lo que Claude recuerda antes de continuar.

Otras herramientas están tomando medidas similares sobre los límites de contexto, como la ventana predeterminada más grande de Codex para GPT-6.1 Sol. Ventanas más grandes y una compactación más inteligente reducen la frecuencia con la que te encuentras con el problema. No cambian el lugar donde debe residir el contexto duradero.