Ventana de contexto y compactación en Claude Code

Hola, bienvenido. En esta lección vamos a ver la ventana de contexto, que es lo que más influye en lo rápido que se gastan los límites de cada plan. En la lección anterior vimos cómo funcionan esos límites y cómo consultar lo que llevas gastado. Veremos qué ocupa el contexto en cada petición, qué significa que tengas 1 millón de tokens en todos los planes, cómo revisarlo con /context, cuándo y cómo compactar con /compact y /autocompact, qué sobrevive a una compactación y qué acciones rompen la caché de prompts, que es lo que decide si una petición sale barata o cara.

La documentación de Claude Code lo dice claro: casi todas las buenas prácticas salen de una sola limitación, que la ventana de contexto se llena rápido y que el rendimiento del modelo empeora a medida que se llena. Cuando el contexto va lleno, Claude puede empezar a olvidar instrucciones que le diste al principio o a cometer más errores, y la documentación considera la ventana de contexto el recurso más importante que tienes que gestionar. Gestionar bien el contexto ahorra uso y, además, hace que Claude trabaje mejor.

La ventana de contexto es todo lo que Claude tiene delante en cada petición, y el modelo no recuerda nada entre una petición y la siguiente. Cada vez que envías un mensaje, Claude Code vuelve a enviar el contexto completo, con las instrucciones del sistema, el contexto del proyecto, todos los mensajes y resultados de herramientas anteriores y tu mensaje nuevo al final. Por eso una pregunta de una línea en una sesión que lleva abierta todo el día consume uso por toda la conversación que arrastra.

Antes de que escribas nada, en el contexto ya hay bastantes cosas:

• Las instrucciones del sistema y las definiciones de las herramientas.
• Tu CLAUDE.md y la auto memory, que veremos en la sección de memoria, y el AGENTS.md si tu proyecto lo tiene.
• Los nombres de las herramientas de los servidores MCP y sus instrucciones, porque las definiciones completas se cargan bajo demanda.
• Las descripciones de las skills disponibles.

Y a medida que Claude trabaja, se va sumando todo lo demás: cada archivo que lee, cada salida de un comando, las rules que se cargan al tocar ciertas carpetas, lo que añaden los hooks, tus mensajes y sus respuestas. Una sesión de depuración o una exploración del código puede generar decenas de miles de tokens. La excepción son los subagentes, que trabajan en su propia ventana de contexto: las lecturas grandes se quedan en la suya y a la tuya solo vuelve un resumen, que es una de las razones por las que tienen su propia sección en el curso.