¿Qué es una ventana de contexto?
Una ventana de contexto es la cantidad máxima de texto que un modelo de lenguaje puede tener en cuenta en una sola petición, medida en tokens. Las instrucciones del sistema, las definiciones de herramientas, el historial de la conversación, los archivos que leyó el agente y la salida de comandos tienen que caber en ella.
Qué llena el contexto de un agente de código
Cada petición de un agente es una base fija más un historial que no deja de crecer.
- El system prompt y las definiciones de herramientas, incluidas las de los servidores MCP.
- Los archivos de instrucciones del proyecto, como CLAUDE.md o AGENTS.md.
- El historial de la conversación: tus mensajes y las respuestas del agente.
- Los archivos leídos y la salida de comandos, a menudo lo que más ocupa.
Qué pasa cuando se llena
El modelo vuelve a leer todo el contexto en cada turno. Cuando la ventana se acerca a su límite, los agentes resumen la conversación y descartan detalles antiguos. Claude Code lo llama compactación, y puedes lanzarla tú mismo con /compact. El resumen ayuda, pero se pierden algunos detalles. /clear borra la conversación por completo.
Una ventana más grande no es la solución
Los modelos actuales tienen ventanas de cientos de miles de tokens. Aun así, un contexto más largo hace cada turno más lento y más caro, y el modelo puede pasar por alto detalles enterrados en un contexto extenso. Mantener el contexto pequeño y relevante suele ser mejor que confiar en una ventana grande.
Usar bien el contexto
Unos pocos hábitos mantienen limpio el contexto durante más tiempo.
- Empieza una conversación nueva cuando termines una tarea.
- Desactiva los servidores MCP que no uses.
- Haz que el agente lea la parte relevante de un archivo, no el archivo entero.
- Delega las investigaciones largas a subagentes para que solo vuelva un resumen.
El contexto en AgentVera
AgentVera hace visible el contexto y te da varias formas de reducirlo.
- El panel del agente muestra el tamaño del contexto en vivo; ejecuta /compact a mano o de forma automática al alcanzar un umbral que tú fijas.
- Perfiles de contexto: “Lean” reduce la primera petición de Claude Code de unos 34,4k a 13,3k tokens.
- “Smart tools” bloquean volver a leer un archivo que ya está en el contexto y no ha cambiado, y dan primero el esquema de los archivos grandes.
- El mapa del proyecto permite a los agentes encontrar el código relevante sin leer archivo tras archivo.
- Ahorro de tokensPerfiles de contexto, salida de comandos más corta con RTK, tamaño del contexto en vivo y compactación automática, activado por defecto en todos los agentes.
- Mapa del proyectoLos agentes encuentran los archivos relevantes, quién los usa y sus tests sin leer archivo tras archivo.
- Herramientas inteligentesRecorta lecturas repetidas, ejecuciones completas de tests y comandos repetidos antes de que lleguen al modelo.
Preguntas frecuentes
¿Qué pasa cuando la ventana de contexto está llena?
El agente resume la conversación y sigue, o no puede avanzar más. Claude Code compacta automáticamente, y en el resumen puede perderse algún detalle antiguo.
¿La ventana de contexto es lo mismo que un límite de uso?
No. La ventana de contexto es cuánto texto cabe en una petición. Los límites de uso fijan cuánto puedes usar durante un periodo de tiempo.
¿Qué diferencia hay entre /compact y /clear?
/compact resume la conversación y continúa desde el resumen. /clear borra la conversación y el agente empieza de cero.
¿Una ventana de contexto más grande da mejores resultados?
No siempre. Cabe más texto, pero el contexto innecesario cuesta más y puede distraer al modelo.