hiddenrows

Guías prácticas para trabajar con agentes de IA, con un laboratorio al final de cada una

última edición=16 de octubre · 24 piezas · 14 breves
regla=solo lo verificado como hecho
llamadas a un modelo por visita=0

Camino al examen · Bloque 1, Qué es el contexto y por qué se degrada

1.1 · Qué es la ventana de contexto2026-10-12

Dónde. Esta se lee. Al final hay dos pasos de un minuto para averiguar cuál es tu tope, que es el dato que vas a necesitar en todas las sesiones de este bloque.

Qué vas a entender. Qué es exactamente el tope que llamamos ventana de contexto, qué cosas comparten ese tope, cuánto mide en tu caso y qué hace Claude Code cuando se acaba.

Un tope por petición, no una cuota del día

La ventana de contexto es el tope de texto que el modelo puede tener delante de una vez, en una sola petición. V

Conviene empezar por lo que no es, porque casi todo el mundo lo entiende al revés la primera vez. No es un saldo que se gasta a lo largo del día, ni una cuota que te dé tu plan, ni una memoria que se vaya llenando. Es lo que cabe de golpe en un envío.

La distinción no es terminológica: cambia el diagnóstico. Cuando una sesión larga se para o se resume sola, no es que hayas consumido nada. Es que lo que hay que mandar ya no entra por debajo del límite. En la sesión 0.4 viste por qué crece —cada turno reenvía el historial entero, porque el modelo no recuerda nada entre una petición y la siguiente—, y de ahí sale todo lo demás: la petición de ahora es más grande que la de antes aunque solo hayas escrito una línea.

Quién comparte el tope

Dentro de ese tope entra todo lo que el modelo tiene delante, y lo que has escrito tú es la parte pequeña: V

  • las instrucciones del sistema y las definiciones de las herramientas disponibles;
  • tu CLAUDE.md y la memoria automática;
  • las skills que se hayan cargado;
  • el contenido de los ficheros que Claude ha leído y la salida de las órdenes que ha ejecutado;
  • la conversación entera, con tus mensajes, sus respuestas y el resultado de cada herramienta.

La consecuencia práctica es que abrir un fichero no es gratis. Un fichero de 4.000 líneas ocupa el mismo sitio que necesita la conversación, y lo ocupa hasta que la sesión lo resuma o lo descarte. Lo mismo vale para la salida de una orden que escupe miles de líneas.

Hay una excepción que ahorra bastante y que conviene saber: las definiciones de las herramientas de los servidores MCP —los conectores que le añaden herramientas a Claude, como un Gmail o un Jira— vienen diferidas por defecto. Hasta que Claude usa una herramienta concreta, solo ocupan sitio los nombres y las instrucciones del servidor, no la descripción completa de cada herramienta. V

Cuánto es el tope en tu caso: 200.000 o un millón

Hay dos tamaños en circulación y la diferencia es de factor cinco, no de matiz.

200.000 tokens es el tope de base. Con la cuenta que usamos en el glosario —unas 750 palabras por cada 1.000 tokens— son del orden de 150.000 palabras: un libro grueso, contando las instrucciones y los ficheros, no solo lo que hablas.

Un millón de tokens es el tope ampliado, unas 750.000 palabras. Corren con él por defecto, sin tener que pedir ni activar nada, los modelos Fable 5.1 y Fable 5, Sonnet 5 y posteriores, Haiku 5.5, y Opus 4.7 y posteriores. V

Opus 4.6 y Sonnet 4.6 llegan al millón solo por su variante [1m], que se pide escribiendo ese sufijo detrás del nombre del modelo, y el acceso a esa variante depende del plan que tengas. V

Por eso la primera pregunta de este bloque no es «cómo ahorro contexto» sino «cuánto tengo». «Lleno» significa dos cosas distintas según el modelo con el que estés, y una sesión que en uno va sobrada en el otro lleva media hora resumiéndose.

Qué hace Claude Code cuando se acaba

No te deja tirado a mitad de la frase: administra el sitio por su cuenta y en un orden concreto. Primero descarta las salidas de herramientas más viejas; si con eso no basta, resume la conversación. Tus peticiones y los fragmentos de código que importan se conservan, y las instrucciones detalladas del principio de la conversación pueden perderse. V

Dónde cae ese momento depende del modelo, y aquí las cifras importan porque marcan cuándo te va a pasar:

  • los modelos que corren con el millón nativo resumen antes de llenarlo, hacia los 967.000 tokens; V
  • Sonnet 4.6 y Opus 4.6 sin contexto ampliado resumen justo en el límite de 200.000; V
  • si alguien ha apagado el resumen automático, la sesión no resume nada: se para en el límite con el error de petición demasiado larga. V

Qué se pierde exactamente al resumir, y qué vuelve a leerse del disco después, es la sesión 1.5. Aquí basta con quedarse con la forma del problema: para hacer sitio hay que tirar algo, y quien decide qué se tira, si tú no intervienes antes, es el programa.

Que quepa no quiere decir que convenga

Queda la idea que justifica este bloque entero, y va a contrapelo de lo que parece lógico: tener más sitio no se traduce en mejores resultados. El modelo acierta menos cuanto más largo es lo que le has dado a leer, aunque le quepa de sobra. Eso lo medimos, con sus fuentes, en la guía de las sesiones largas.

Un millón de tokens, entonces, no es permiso para llenarlo. Es margen para no tener que resumir en mitad de una tarea.

Por dónde empezar. Esto es propuesta nuestra, no de la documentación: administra el contexto como un presupuesto tuyo, con tres decisiones que no cuestan nada y que ya puedes tomar hoy.

  • Las normas que tienen que sobrevivir van escritas en el CLAUDE.md, no dichas en la conversación. El CLAUDE.md se vuelve a leer del disco después de un resumen; la conversación solo queda resumida, y lo que no entre en el resumen se ha ido. V
  • Entre dos tareas que no tienen nada que ver, /clear. Lo anterior ya no te sirve, pero sigue ocupando sitio y se sigue pagando en cada mensaje. V
  • Las lecturas grandes, a un subagente. Trabaja en su propia ventana y te devuelve el resumen en vez del fichero, así que el contenido no pasa nunca por la tuya. V

Haz esto

  1. Averigua con qué modelo estás trabajando ahora mismo. No lo des por sabido: cambia al cambiar de plan, de carpeta o de ajuste.

    Dentro de una sesión

    /status

    Tienes que ver: La pestaña de estado, con la versión, el modelo, la cuenta y la conectividad. El nombre del modelo es el dato que buscas.

  2. Busca ese nombre en la lista de la sección tercera y apunta tu tope, 200.000 o 1.000.000, en algún sitio donde lo vuelvas a encontrar.

    Aquí mismo, en papel o en una nota

    Tienes que ver: Un número tuyo. Es el denominador de todo lo que midas en las seis sesiones siguientes: sin él, un «40.000 tokens ocupados» no dice si vas holgado o al borde.

Si no sale

El nombre del modelo que enseña /status no se parece a los de la lista: lleva un prefijo del proveedor, una arroba con una fecha o un alias de tu empresa.
Estás detrás de una pasarela o de un proveedor en la nube. Claude Code deduce la ventana del propio identificador, y si no consigue reconocerlo asume 200.000 salvo que el nombre lleve [1m]. Si tu ventana real es otra, se corrige con la variable CLAUDE_CODE_MAX_CONTEXT_TOKENS puesta al valor que debe suponer.
Tu modelo debería ir con el millón y, sin embargo, la sesión se resume o se para en 200.000.
Dos causas, y las dos son de configuración, no una avería. O es Opus 4.6 o Sonnet 4.6 sin su variante [1m], que son los dos que no llegan al millón por defecto; o alguien ha puesto CLAUDE_CODE_DISABLE_1M_CONTEXT=1 en el entorno o en un fichero de ajustes, y entonces incluso los modelos con millón nativo se tratan como de 200.000.

Comprobación

Llevas dos horas en una sesión con un modelo que corre con el millón de tokens. Le pides que lea un fichero de 40.000 líneas y, en el turno siguiente, la sesión se resume sola. ¿Qué ha pasado?

Ver la respuesta
  1. Has agotado la cuota de contexto que tu plan da por sesión.
  2. El modelo ha cambiado solo a otro más pequeño al tocar el límite.
  3. El fichero entero pasó a formar parte de la petición y, con el historial de dos horas delante, la siguiente ya no entraba por debajo del límite: Claude Code resumió para poder seguir.
  4. El fichero era demasiado grande para la herramienta de lectura y hay que partirlo en trozos.

La ventana es un tope por petición y lo comparte todo: las instrucciones, los ficheros leídos, la salida de las órdenes y la conversación entera, que se reenvía en cada turno. Un fichero de 40.000 líneas ocupa el mismo sitio que necesita el historial, así que el envío siguiente se va por encima del tope. Con el millón nativo, además, el resumen llega antes de llenarlo, hacia los 967.000 tokens, que es justo para que no te estrelles contra el error. No hay ninguna cuota por sesión: lo que el plan gobierna es el acceso a la variante de un millón en Opus 4.6 y Sonnet 4.6, no cuánto contexto puedes usar en una sesión.

Esta pregunta la hemos escrito nosotros a partir del temario público. No reproducimos contenido del examen.

De dónde sale todo esto

Siguiente: Míralas con /context — aún sin escribir

hiddenrows · proyecto personal de divulgación de Miguel Yepes Contenido divulgativo, puede contener errores · sin garantías · Aviso legal · Privacidad · llms.txt