≡En resumen
- Compactar es resumir lo antiguo de la conversación para que la sesión pueda continuar.
- Claude Code limpia primero salidas antiguas de herramientas y, si no basta, resume la conversación.
- Con /compact y un foco decides qué debe sobrevivir al resumen.
- Las instrucciones del principio pueden perder detalle: las reglas permanentes van en CLAUDE.md.
- En la API de Claude hay compactación del lado del servidor en beta, bajo demanda o al superar un umbral de tokens.
01 ¿Qué es la compactación de contexto?
Cada mensaje, archivo leído y resultado de herramienta se acumula en la ventana de contexto del modelo. En una sesión larga de programación o en un agente que trabaja durante horas, esa ventana acaba llenándose. La compactación resuelve el problema sustituyendo los turnos antiguos por un resumen escrito por el propio modelo: la conversación sigue, pero ocupando mucho menos.
No es solo una cuestión de espacio. Anthropic recuerda que la calidad de las respuestas se degrada cuando el contexto crece mucho, así que compactar a tiempo también ayuda a que el modelo se concentre en lo relevante.
02 Cómo funciona la compactación en Claude Code
Según la documentación oficial, Claude Code gestiona el contexto de forma automática cuando te acercas al límite: primero elimina salidas antiguas de herramientas y, si no es suficiente, resume la conversación. Conserva tus peticiones y los fragmentos de código clave, pero las instrucciones detalladas del principio pueden perderse.
-
1
Comprueba cuánto ocupas
Ejecuta /context para ver qué parte de la ventana usan la conversación, las herramientas, la memoria y las skills.
-
2
Compacta tú antes que el sistema
Al terminar una fase del trabajo, ejecuta /compact para resumir con calma, en lugar de esperar a que salte la compactación automática a mitad de tarea.
-
3
Indica el foco
Añade qué debe conservarse, por ejemplo «/compact céntrate en los cambios de la API y los tests pendientes».
-
4
Fija reglas para todas las compactaciones
Añade a CLAUDE.md una sección de instrucciones de compactación con lo que siempre debe sobrevivir al resumen.
-
5
Revisa el resultado
Tras compactar, pide a Claude que te diga en qué punto está la tarea para confirmar que no se ha perdido nada importante.
03 /compact, /clear, /rewind y subagentes: cuándo usar cada uno
Compactar no es la única forma de liberar contexto. Elegir bien evita resúmenes innecesarios.
| Opción | Qué hace | Úsala cuando |
|---|---|---|
| /compact | Resume la conversación y sigue en la misma sesión | Vas a continuar la misma tarea y necesitas espacio |
| /clear | Empieza una conversación limpia | Cambias a una tarea sin relación con la anterior |
| /rewind (o Esc dos veces) | Vuelve a un punto anterior de la conversación o de los archivos | Un camino no funcionó y quieres descartarlo entero |
| Subagentes | Hacen el trabajo en su propia ventana y devuelven un resumen | Vas a explorar mucho código o documentación |
| CLAUDE.md | Carga reglas en cada sesión, fuera del historial | Hay instrucciones que deben valer siempre |
04 Compactación en la API de Claude
Si desarrollas tu propio agente o chatbot sobre la API de Claude, no tienes que programar el resumen tú mismo. La documentación describe la compactación del lado del servidor, en beta en octubre de 2026 para los modelos 4.6 y posteriores: Claude escribe el resumen en el servidor y la conversación puede continuar más allá del límite de la ventana.
| Modalidad | Quién decide cuándo | Detalles |
|---|---|---|
| Bajo demanda | Tu aplicación, enviando una petición de resumen | Parámetro compaction con su cabecera beta; permite conservar los últimos turnos literales y compactar en segundo plano |
| Por umbral de tokens | La API, al alcanzar el umbral de entrada que fijes | Edición compact_20260112 en context_management; umbral por defecto de 150.000 tokens y mínimo de 50.000 |
| Tu propio resumidor | Tú | Tu código genera el resumen y reescribe el historial |
En la modalidad por umbral puedes pasar instructions con tu propio prompt de resumen (sustituye al predeterminado, no lo complementa) y activar pause_after_compaction para que la respuesta se detenga tras generar el resumen y puedas reinsertar los últimos mensajes. Para necesidades más finas existe además la edición de contexto, que borra resultados antiguos de herramientas o bloques de razonamiento por reglas en lugar de resumirlos.
05 Señales de que conviene compactar
No hace falta esperar a que la ventana esté llena. En sesiones largas, la calidad suele resentirse antes de llegar al límite, y estas señales indican que es buen momento para compactar o, directamente, para empezar de cero.
Repite errores ya corregidos
Vuelve a proponer un enfoque que descartasteis hace una hora o reintroduce un fallo que ya estaba arreglado.
Ignora reglas del principio
Deja de seguir una convención que pediste al inicio de la sesión y que no está en CLAUDE.md.
Respuestas más lentas
Cada turno procesa todo el historial; cuando este crece mucho, el tiempo de respuesta y el consumo aumentan.
Has cerrado una fase
Terminaste una funcionalidad y empiezas otra relacionada: buen momento para resumir lo hecho y seguir con un contexto ligero.
06 Qué se pierde al compactar y cómo evitarlo
Un resumen es, por definición, una versión con menos detalle. Lo que suele perderse son matices: una restricción que diste de pasada, el nombre exacto de una variable, un enfoque que ya descartaste y por qué. Si el modelo deja de respetar algo tras compactar, casi siempre es porque esa información solo vivía en un mensaje antiguo.
- ✓Pon las reglas permanentes en CLAUDE.md, no en mensajes de la conversación.
- ✓Pide al agente que mantenga un archivo de progreso con decisiones y tareas pendientes.
- ✓Compacta al terminar una fase, no en mitad de un cambio delicado.
- ✓Indica en /compact qué debe conservarse literalmente.
- ✓Evita cargar archivos o logs enormes completos; filtra antes.
- ✓Tras compactar, verifica el estado de la tarea antes de seguir.
07 Compactación en agentes y chatbots de empresa
Cualquier asistente que mantenga conversaciones largas necesita una política de compactación: cuándo resumir, qué conservar literal y dónde guardar los datos que no pueden perderse. Es parte del diseño de la ingeniería de contexto y lo planteamos desde el principio en proyectos de automatización con inteligencia artificial y en cualquier desarrollo de aplicaciones web a medida que integre un modelo de lenguaje.
Un asistente ayuda a preparar expedientes durante toda la jornada. Sin compactación, a media mañana la conversación es enorme y las respuestas empeoran. Con una política clara, cada vez que se cierra un expediente el asistente guarda los datos clave en el sistema de gestión y compacta el historial, conservando literal solo el expediente en curso. La conversación sigue siendo útil todo el día.
Si buscas utilidades que ayudan a medir el contexto o guardar memoria entre sesiones, revisa nuestra selección de herramientas para Claude Code.
Preguntas frecuentes sobre Compactación de contexto (/compact)
Es sustituir la parte antigua de una conversación con un modelo de IA por un resumen, para liberar espacio en la ventana de contexto y poder seguir trabajando en la misma sesión.
Resume la conversación actual y continúa en la misma sesión con ese resumen. Puedes añadir un foco, por ejemplo «/compact céntrate en los tests pendientes», para indicar qué debe conservarse.
Cuando la conversación se acerca al límite de la ventana de contexto. Primero elimina salidas antiguas de herramientas y, si no basta, resume la conversación.
/compact resume y mantiene el hilo de la tarea actual. /clear empieza una conversación limpia, útil cuando pasas a una tarea que no tiene relación con la anterior.
Porque el resumen pierde detalle y las instrucciones que solo estaban en mensajes antiguos pueden quedar fuera. Pon las reglas permanentes en CLAUDE.md o en una sección de instrucciones de compactación.
Sí. En octubre de 2026 la API ofrece compactación del lado del servidor en beta, bajo demanda o al superar un umbral de tokens de entrada, para los modelos 4.6 y posteriores. Revisa la documentación oficial porque los parámetros pueden cambiar.
Fuentes consultadas
Sobre el autor
Germán Gutiérrez
Development Manager en appyweb
Dirige el equipo de desarrollo de appyweb: aplicaciones web y móviles, SaaS, integraciones y arquitectura de software.
Ver perfil en LinkedIn ↗