Explorar la ventana de contexto

Una simulación interactiva de cómo se llena la ventana de contexto de Claude Code durante una sesión. Vea qué se carga automáticamente, cuánto cuesta cada lectura de archivo y cuándo se activan las reglas y hooks.

La ventana de contexto de Claude Code contiene todo lo que Claude sabe sobre su sesión: sus instrucciones, los archivos que lee, sus propias respuestas y contenido que nunca aparece en su terminal. La línea de tiempo a continuación muestra una sesión completa desde el inicio hasta la compactación: qué se carga antes de que escriba, qué agrega cada lectura de archivo, regla y hook mientras Claude trabaja, y cómo un subagent mantiene las lecturas grandes fuera de su contexto. Vea el desglose escrito para el mismo contenido como una lista.

Qué muestra la línea de tiempo

La sesión recorre un flujo realista con conteos de tokens representativos:

• Antes de que escribas algo: CLAUDE.md, memoria automática, nombres de herramientas MCP y descripciones de skills se cargan en el contexto. Los archivos AGENTS.md pueden cargarse en lugar de CLAUDE.md. Tu propia configuración puede agregar más aquí, como un estilo de salida o texto de --append-system-prompt.
• Mientras Claude trabaja: cada lectura de archivo se suma al contexto, reglas con alcance de ruta se cargan automáticamente junto con archivos coincidentes, y un hook PostToolUse se activa después de cada edición.
• El prompt de seguimiento: un subagent maneja la investigación en su propia ventana de contexto separada, por lo que las lecturas de archivos grandes se mantienen fuera de la suya. Solo el resumen y un pequeño remolque de metadatos regresan.
• Al final del recorrido: ejecuta /compact, que reemplaza la conversación con un resumen estructurado. La mayoría del contenido de inicio se recarga automáticamente; la tabla a continuación muestra qué sucede con cada mecanismo.

Qué sobrevive a la compactación

Cuando una sesión larga se compacta, Claude Code resume el historial de conversación para que quepa en la ventana de contexto. A partir de v2.1.198, la solicitud de resumen hereda la configuración de pensamiento extendido de tu sesión, por lo que razona con el pensamiento habilitado cuando tu sesión lo tiene habilitado y se mantiene desactivado en caso contrario. El pensamiento afecta solo cómo se produce el resumen; la configuración de tu sesión permanece sin cambios después. Lo que sucede con cada tipo de contenido depende de cómo se cargó:

Justo después de la compactación, Claude Code re-lee hasta cinco de los archivos que Claude ha leído o editado en la sesión, eligiendo los modificados más recientemente. Un archivo de más de 5,000 tokens regresa como una referencia de ruta sin su contenido, mostrado como Referenced file en lugar de Read.

Las reglas con alcance de ruta y los archivos CLAUDE.md anidados se cargan en el historial de mensajes cuando Claude lee, escribe o edita su archivo de activación, por lo que la compactación los resume junto con todo lo demás. Si una regla debe persistir a través de la compactación, elimina el frontmatter paths: o muévela a CLAUDE.md de raíz del proyecto.

Los cuerpos de skills se re-inyectan después de la compactación, pero los skills grandes se truncan para ajustarse al límite por skill, y los skills invocados más antiguos se descartan una vez que se excede el presupuesto total. El truncamiento mantiene el inicio del archivo, por lo que coloca las instrucciones más importantes cerca de la parte superior de SKILL.md.

Cuando su contexto se llena

Claude Code se compacta automáticamente a medida que te acercas al límite, por lo que una ventana de contexto llena no termina tu sesión. El paso automático funciona de la misma manera que el paso /compact en la línea de tiempo. Consulta Cuando el contexto se llena para saber qué preserva. Para saber cuándo Claude Code también compacta una conversación que dejas inactiva, consulta compactación por inactividad.

También puede actuar antes de que se ejecute el paso automático:

• Compactar con un enfoque: ejecute /compact con instrucciones, como /compact focus on the auth bug fix, antes de comenzar una tarea nueva larga. El resumen mantiene lo que usted elige en lugar de lo que el paso automático adivina que es importante.
• Compactar parte de la conversación: ejecute /rewind, seleccione un mensaje y elija Summarize from here o Summarize up to here. Vea Rewind and summarize para saber qué opción mantiene cada una y cómo guiar el resumen.
• Compactar antes: ejecute /autocompact con un recuento de tokens, como /autocompact 500k, para establecer qué tan llena está la ventana de contexto antes de que se ejecute el paso automático. Vea Set the auto-compact window para valores aceptados e invalidaciones.
• Limpiar entre tareas: ejecute /clear cuando cambie a trabajo no relacionado. La conversación antigua desplaza los archivos que necesita a continuación y cuesta tokens en cada mensaje.
• Delegar lecturas grandes: envíe investigación a un subagent para que el contenido del archivo permanezca en su ventana de contexto, no en la suya.

Si necesitas una ventana más grande en lugar de una conversación más pequeña, los modelos Fable, Sonnet 5 y posteriores, Haiku 5.5, Opus 4.6 y posteriores, y Sonnet 4.6 admiten una ventana de contexto de 1 millón de tokens. Consulta Contexto extendido para conocer la disponibilidad por plan y cómo seleccionar una variante de modelo [1m]. La compactación funciona de la misma manera en el límite más grande.

El punto donde se ejecuta la compactación automática depende de su modelo y configuración. Vea Default auto-compact thresholds para los límites por modelo, y Correct the window for a gateway or custom model ID si Claude Code asume la ventana incorrecta para su ID de modelo, como un alias de LLM gateway.

Verifique su propia sesión

La visualización utiliza números representativos. Para ver su uso real de contexto en cualquier momento, ejecute /context para un desglose en vivo por categoría con sugerencias de optimización, incluidos qué archivos CLAUDE.md y memoria automática se cargaron. Ejecute /memory para abrir y editar esos archivos.

Recursos relacionados

Para una cobertura más profunda de las características mostradas en la línea de tiempo, vea estas páginas:

• Extender Claude Code: cuándo usar CLAUDE.md vs skills vs reglas vs hooks vs MCP
• Almacenar instrucciones y memorias: jerarquía de CLAUDE.md y memoria automática
• Subagents: delegar investigación a una ventana de contexto separada
• Mejores prácticas: gestionar el contexto como su restricción principal
• Almacenamiento en caché de prompts: qué acciones invalidan el prefijo en caché
• Reducir el uso de tokens: estrategias para mantener el uso de contexto bajo