Compactación del contexto en Claude Code

La compactación del contexto es el mecanismo de Claude Code que sustituye el historial completo de una sesión por un resumen condensado cuando la conversación se acerca al límite de la ventana de contexto. Puede dispararse automáticamente o a mano con el comando /compact. El objetivo es seguir trabajando en la misma tarea sin arrastrar miles de tokens de lecturas de archivos, salidas de terminal e intentos fallidos que ya no aportan.

Cómo funciona

Cada mensaje, cada archivo leído y cada resultado de herramienta ocupa tokens en el contexto. En una sesión agéntica larga, eso crece rápido: un par de git diff grandes o una suite de tests verbosa pueden consumir buena parte del espacio disponible.

Cuando se compacta, Claude genera un resumen de la conversación hasta ese punto: objetivo de la tarea, archivos modificados, decisiones tomadas, errores encontrados y próximos pasos. Ese resumen reemplaza al historial y la sesión continúa a partir de él. Hay dos modos:

• Autocompactación: Claude Code la lanza solo cuando el uso del contexto se acerca al umbral configurado. El porcentaje exacto depende de la versión, y puede activarse o desactivarse desde /config.
• Compactación manual: ejecutas /compact cuando te conviene, opcionalmente con instrucciones, por ejemplo /compact céntrate en los cambios del módulo de pagos y los tests pendientes.

El archivo CLAUDE.md no depende del resumen: se vuelve a cargar como memoria del proyecto, así que las convenciones persistentes deben vivir ahí y no solo en la conversación. Además, existe un hook PreCompact que permite ejecutar lógica propia justo antes de compactar, por ejemplo guardar una copia del transcript.

Por qué importa

La compactación es lo que hace viable trabajar horas en una misma tarea, pero tiene un coste: resumir es perder información. Un detalle que parecía menor (un flag concreto, el motivo por el que descartaste una solución) puede no sobrevivir al resumen, y Claude podría volver a proponer algo que ya probaste.

En la práctica cambia cómo organizas el trabajo:

• Compactar manualmente en un punto de corte natural (tests en verde, fase terminada) da mejores resúmenes que dejar que la autocompactación salte a mitad de un cambio.
• Las instrucciones a /compact te permiten decidir qué se conserva con prioridad.
• Un contexto más limpio suele mejorar la calidad de las respuestas y reduce el consumo de tokens en cada turno siguiente.

Compactar, limpiar o delegar

Claude Code ofrece varias formas de gestionar el contexto, y conviene elegir bien:

• /compact: sigues en la misma tarea y necesitas conservar su estado.
• /clear: empiezas algo distinto. Borra el historial por completo; arrastrar contexto irrelevante solo distrae al modelo.
• Subagentes: para exploraciones que generan mucho ruido (buscar en todo el repositorio, leer documentación extensa), delegar evita que esa basura entre en tu contexto principal.

Comandos como /context, en versiones recientes, muestran qué está ocupando espacio y ayudan a decidir cuándo actuar. Si quieres profundizar en estos hábitos y en cómo dominar el flujo de trabajo con Claude Code en proyectos reales, la gestión del contexto es una de las habilidades que más rendimiento devuelve.

Errores comunes

• Confundirla con ampliar la ventana de contexto: compactar no da más capacidad al modelo, solo libera espacio dentro del mismo límite.
• Pensar que no se pierde nada: es un resumen, no una copia. Lo crítico debe estar en CLAUDE.md, en el código o en notas del repositorio.
• Confundirla con el prompt caching: el caching reutiliza prefijos idénticos para ahorrar coste y latencia; la compactación reescribe el historial.
• Compactar cuando tocaba /clear: si cambias de tarea, un resumen de la anterior es ruido.