La ventana de contexto

La ventana de contexto es la cantidad de texto que un modelo puede leer de una vez. Contiene el prompt del sistema, las definiciones de herramientas, los archivos de memoria que haya, y cada mensaje, resultado de herramienta y respuesta de la conversación hasta ahora. En una conversación larga se llena, y una ventana más llena implica turns más lentos y más caros hasta que se acorta el historial; consulta Compactar una conversación.

OAR muestra cuánto ocupa la ventana en dos lugares: una línea fina a lo largo del borde superior del área de redacción, que siempre está a la vista, y el cuadro de diálogo de contexto 🧠, que desglosa la cifra.

La línea sobre el área de redacción #

La línea recorre el borde superior del área de redacción. Te dice de un vistazo cuánta parte de la ventana usa la conversación. Tiene dos modos de visualización, que se fijan en config.json con contextIndicatorMode (consulta config.json):

Cuando OAR no tiene ninguna cifra para la conversación, la línea es de un gris neutro. Es lo que pasa antes del primer turn, y con los proveedores que no informan de nada (consulta Por proveedor).

La línea se actualiza:

• cuando abres una conversación;
• poco después de que llegue un mensaje a la conversación que estás viendo;
• cuando termina un turn.

En Claude, DeepSeek, Claude Cloud, Cursor y Grok la cifra se registra cuando termina un turn, así que la línea se mueve una vez por turn.

El cuadro de diálogo de contexto 🧠 #

Haz clic en 🧠 en la cabecera de la conversación; su tooltip dice Check current context (Comprobar el contexto actual). El cuadro de diálogo se titula Context usage (Uso del contexto). Su subtítulo es del tipo Claude session 1a2b3c4d: el proveedor y los ocho primeros caracteres del id de la sesión (las conversaciones de OpenAI dicen Copilot, porque las ejecuta el agente de Copilot). Antes de que exista una sesión dice Conversation y los ocho primeros caracteres del id de la conversación. Sin una conversación abierta, el cuadro de diálogo dice Open a conversation to see its context usage. (Abre una conversación para ver su uso del contexto.)

Lo que muestra el cuadro de diálogo, de arriba abajo:

• El modelo, y un titular con el total y la ventana. En Claude y DeepSeek el titular es del tipo 60.9k used · compaction window 100.0k · model limit 1M; el límite del modelo aparece cuando se conoce. En los demás proveedores es del tipo 221.3k / 1.0M tokens (22%).
• Una barra con una parte de color por categoría.
• Una tabla con las columnas Category (Categoría), Tokens y Usage (Consumo) (la parte de la ventana).
• Notas bajo la barra: As of the last completed turn (Según el último turn completado), seguido de la hora y el modelo, te dice cuándo se tomaron las cifras. Otras notas indican cuándo una cifra es una estimación (consulta Por proveedor).
• En Claude, el control deslizante de la ventana de compactación automática, los controles de razonamiento y la fila Commit attribution (Atribución de commits). Consulta Claude. Los chats de Claude Cloud iniciados desde una carpeta también muestran la fila de atribución. Nuevo en 0.9.17 Los chats de DeepSeek muestran solo el control deslizante: DeepSeek siempre razona, y su atribución de commits se fija en su pestaña de ajustes. Consulta DeepSeek.
• Nuevo en 0.9.16 En una sesión que inició un agente, con cualquier proveedor, el interruptor Agents in this conversation may start sessions (Los agentes de esta conversación pueden iniciar sesiones). Consulta Permitir que una sesión iniciada inicie sesiones.
• Un bloque plegado Raw details (Detalles sin procesar) con el texto propio de la runtime, cuando lo hay.

Refresh (Actualizar), arriba a la derecha, vuelve a leer las cifras. En Claude, DeepSeek, Claude Cloud, Cursor y Grok solo cambian cuando termina un turn, así que importa sobre todo tras un turn que terminó con el cuadro de diálogo abierto.

Las categorías #

Las filas de la tabla dependen del proveedor. En Claude y DeepSeek, ambos ejecutados por Claude Code, son las categorías de las que informa el propio Claude Code, con los nombres que él les da, por ejemplo System prompt (Prompt del sistema), System tools (Herramientas del sistema), Skills (Habilidades) y Messages (Mensajes), y MCP tools (Herramientas MCP), Memory files (Archivos de memoria) y Custom agents (Agentes personalizados) cuando la sesión los tiene. Dos filas más describen el resto de la ventana:

Una herramienta que Claude Code lista pero no ha cargado se marca como (deferred) (diferido). Se muestra en la tabla pero no cuenta en el total, y una nota lo indica. Por eso las filas pueden sumar más que el titular.

El control deslizante de la ventana de compactación automática #

En Claude y DeepSeek, el cuadro de diálogo contiene el control deslizante Auto-compact window (Ventana de compactación automática). Fija cuántos tokens de contexto puede acumular la conversación antes de que Claude Code la compacte. El ajuste pertenece a la conversación, no al relay. Los demás proveedores no tienen un control así.

El control deslizante tiene siete posiciones: Auto, 100k, 150k, 200k, 300k, 500k y 1M. Auto es el valor predeterminado y deja la elección a Claude Code, que elige una ventana adecuada al modelo. 100k es el mínimo: Claude Code ignora cualquier valor menor. Nuevo en 0.9.17 En un chat de DeepSeek, Auto significa 400k tokens: el relay le da a Claude Code esa ventana salvo que elijas otra posición, así que un chat largo de DeepSeek se compacta mucho antes de que se llene su ventana de 1M. La compactación en sí, y lo que significa cada posición, están en Compactar una conversación.

Lo que te dice el cuadro de diálogo alrededor del control deslizante:

• La línea de debajo empieza por Effective: (Efectivo:) y da el umbral vigente, por ejemplo compacts at 967.0k of 1.0M tokens · auto (model-tuned). La última parte dice de dónde viene: auto (model-tuned) (auto, ajustado al modelo), model default (predeterminado del modelo), from settings (de los ajustes) (tu control deslizante), from CLAUDE_CODE_AUTO_COMPACT_WINDOW (de CLAUDE_CODE_AUTO_COMPACT_WINDOW), o from client data (de los datos del cliente). Antes del primer turn dice — (known after the first turn) (se conoce tras el primer turn). La variable de entorno se describe en Variables de entorno.
• Auto-compact is disabled for this session. (La compactación automática está desactivada en esta sesión.) aparece cuando Claude Code informa de que la compactación automática está desactivada.
• Una nota dice cuándo entra en vigor un ajuste nuevo: Applies after the current turn. (Se aplica tras el turn actual.), Applies when background work has finished. (Se aplica cuando termina el trabajo en segundo plano.) o Applies on the next message (the session restarts once). (Se aplica en el próximo mensaje; la sesión se reinicia una vez.)
• The conversation will be compacted on the next message. (La conversación se compactará en el próximo mensaje.) te avisa cuando eliges una ventana menor que lo que la conversación ya usa.

Mover el control deslizante solo cambia la etiqueta y las notas. El ajuste se guarda cuando cierras el cuadro de diálogo (con ×, Escape o un clic fuera de él), y un aviso breve lo confirma, por ejemplo Auto-compact window set to 200k tokens. (Ventana de compactación automática fijada en 200k tokens.) Si eliges Auto, el aviso es Auto-compact window back to the model default. (Ventana de compactación automática de vuelta al valor predeterminado del modelo.) Claude Code solo lee la ventana al arrancar, así que la sesión se reinicia una vez antes de tu próximo mensaje para aplicarla; consulta Compactar una conversación.

El tamaño de la ventana #

El tamaño de la ventana depende del modelo. Algunos modelos ofrecen una segunda ventana, más grande, por ejemplo 1M; la eliges con el selector Context window (Ventana de contexto) del área de redacción antes de enviar. Consulta Tamaño del contexto.

En Claude y DeepSeek el titular muestra dos cifras: la compaction window (ventana de compactación), que es donde se compactará la conversación, y el model limit (límite del modelo), que es lo máximo que puede contener el modelo. La ventana de compactación no puede ser mayor que el límite del modelo. En los demás proveedores el titular muestra la ventana del modelo. Cuando un proveedor no le indica a OAR la ventana, OAR usa una tabla integrada de modelos conocidos, que incluye los modelos de DeepSeek con 1M; un modelo que no está en ninguna de las dos no tiene cifra de ventana. Para Cursor y Grok el cuadro de diálogo muestra entonces solo un bloque de texto simple con los recuentos de tokens, sin barra, tabla ni porcentaje.

Por proveedor #

Algunos detalles:

• Copilot. Si la runtime ya no informa del desglose completo, OAR muestra solo un límite inferior a partir de los tokens que el modelo ha escrito hasta ahora, etiquetado Estimated lower bound — this runtime does not report a full breakdown. (Límite inferior estimado: esta runtime no informa de un desglose completo.) Le faltan las partes del prompt, el sistema, las herramientas y la caché.
• Cursor. Cada llamada al modelo de un turn vuelve a enviar el contexto, y Cursor informa de la suma. OAR divide la parte del prompt entre el número de llamadas y suma la salida. Cuando un turn hizo más de una llamada, el cuadro de diálogo indica que la cifra se estima a partir del consumo agregado de tokens del turn.
• Grok. El total es la entrada, los tokens en caché y la salida del último turn, y no se marca como estimación. El porcentaje solo aparece cuando se conoce la ventana del modelo.
• Claude Cloud. Las cifras se leen de la sesión cuando termina el turn. Si la sesión no informa de ningún consumo, el cuadro de diálogo no tiene nada que mostrar.

Antes del primer turn de una conversación de Claude, DeepSeek, Claude Cloud, Cursor o Grok el cuadro de diálogo no tiene cifras. Muestra un bloque de texto simple con el modelo como unavailable (no disponible) y una línea Note (Nota): No context data captured yet for this session; it is recorded when a turn completes. (Aún no se han capturado datos de contexto para esta sesión; se registran cuando termina un turn.)

Cuando la ventana está casi llena #

En cualquier proveedor puedes iniciar una conversación nueva que lleve un resumen con /compact. Todo esto se describe en Compactar una conversación.