Cómo evitar que se llene la ventana de contexto de tu agente de programación con IA

Todo agente de programación con IA funciona dentro de una ventana de contexto — la cantidad finita de texto que puede "ver" a la vez: tus mensajes, sus respuestas, los archivos que lee, la salida de los comandos que ejecuta. Cuando esa ventana se llena, la calidad cae de formas que parecen misteriosas. El agente olvida una decisión que tomaste hace veinte minutos, vuelve a leer un archivo que ya editó o se contradice sin darse cuenta. En cualquier tarea que dure más de unos pocos minutos, gestionar el contexto es la mayor palanca de la que dispones sobre la calidad del resultado. Aquí te explicamos cómo hacerlo de forma deliberada.

Por qué una ventana llena perjudica

Los modelos no se degradan de forma elegante cuando la ventana se satura. Ocurren dos cosas. Primero, los mensajes más antiguos son empujados hacia los bordes, donde el modelo les presta atención de forma menos fiable — el clásico problema de "perderse en el medio". Segundo, la mayoría de los agentes autoresumen cuando se quedan sin espacio, y un resumen automático hecho bajo presión pierde información: podría descartar la restricción exacta que te importaba. La solución es mantener el control de lo que el agente está reteniendo, en lugar de dejar que se llene e improvise.

Vigila cuán llena está la ventana

No puedes gestionar lo que no puedes ver. En Claude Code, ejecuta /context para mostrar el uso actual como porcentaje. Una buena regla general entre profesionales es actuar en torno al 60 % de utilización en una tarea compleja — bastante antes del punto de ~80 % donde entra en juego la compactación automática. Cursor y Codex muestran un indicador similar en sus interfaces. Echar un vistazo a ese número de vez en cuando convierte la gestión del contexto de una preocupación difusa en una señal concreta.

Compacta en los puntos de control — no sigas sin más

Cuando llegues a un punto de control natural (una función funciona, las pruebas pasan, un error queda corregido), comprime el historial en lugar de dejar que crezca. En Claude Code, /compact reemplaza la transcripción completa por un resumen generado por el modelo — una conversación de 70 000 tokens puede reducirse a aproximadamente 4000 tokens. Y algo crucial: puedes guiar qué es lo que sobrevive:

/compact "Keep the API contract and the DB schema we agreed on. Summarize the debugging session — I only need the root cause, not every step."

Compactar de forma proactiva, mientras aún hay margen, produce un mejor resumen que uno automático activado en el último segundo, porque el modelo todavía conserva un recuerdo claro de toda la conversación cuando escribe el resumen.

Limpia cuando cambies de tarea

/compact sirve para continuar con el mismo hilo de trabajo. /clear sirve para abandonarlo. Cuando pivotes hacia algo no relacionado — terminas una corrección en el backend y pasas a una función del frontend — empieza de cero. Arrastrar el contexto antiguo no ayuda; solo desperdicia tokens y arriesga que el agente asocie por patrones la tarea anterior. Limpiar es también el remedio cuando el contexto está "envenenado": el modelo se ha aferrado a una suposición equivocada y sigue volviendo a ella por más que lo corrijas.

Pon el conocimiento estable en un archivo, no en el chat

Si te descubres reexplicando las mismas cosas — tu comando de pruebas, tus convenciones de nombres, en qué directorio vive la API — esa información no debería estar en la conversación en absoluto. Ponla en un archivo de proyecto que el agente lea automáticamente: CLAUDE.md para Claude Code, AGENTS.md para Codex y otros, .cursorrules para Cursor. Se carga al inicio de cada sesión, de modo que el agente lo tiene desde el primer mensaje, y sobrevive a cada /clear y /compact. Eso sí, mantenlo ligero — cuesta tokens en cada solicitud, así que un CLAUDE.md inflado es su propia clase de desperdicio de contexto.

Dale al agente menos, no más

El impulso de volcar diez archivos "para que lo tenga todo" es contraproducente. Cada archivo que pegas o mencionas con @ consume presupuesto y diluye la atención del modelo. Un archivo bien elegido suele ser mejor que diez. Empieza con lo mínimo y añade contexto solo cuando el agente realmente lo necesite. Si no estás seguro de qué archivo importa, pídele al agente que lo encuentre primero en lugar de precargar todo el directorio.

Delega la exploración desordenada a un subagente

Algunas tareas son inherentemente verbosas — "busca en el código todos los lugares donde llamamos a la API de pagos". Si ejecutas eso en tu sesión principal, la salida en bruto de la búsqueda inunda tu ventana. En su lugar, delégalo a un subagente (la herramienta Task de Claude Code, o un agente de Cursor aparte). El subagente hace la exploración ruidosa en su propia ventana aislada y solo te devuelve la conclusión — los tres archivos que importan — manteniendo limpio tu contexto principal.

Un ritmo de trabajo

Puesto todo junto, una sesión larga y saludable tiene este aspecto:

1. Empieza con un CLAUDE.md conciso para que el agente conozca tu proyecto.
2. Acota cada tarea de forma estrecha; referencia solo los archivos que toca.
3. Echa un vistazo a /context cada 30–45 minutos o después de cada hito.
4. Usa /compact con una instrucción personalizada en cada punto de control.
5. Usa /clear en el momento en que cambies a un trabajo no relacionado.

Nada de esto es exótico. Es la diferencia entre un agente que se mantiene afilado a lo largo de una sesión de dos horas y otro que empieza fuerte y poco a poco pierde el hilo — y te cuesta unos segundos de atención en lugar de una misteriosa tarde depurando su confusión.