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 qué se carga y cuándo. 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 escriba algo: CLAUDE.md, memoria automática, nombres de herramientas MCP y descripciones de skills se cargan en el contexto. Su propia configuración puede agregar más aquí, como un estilo de salida o texto de
--append-system-prompt, que ambos van al prompt del sistema de la misma manera. - 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:
/compactreemplaza 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. Lo que sucede con sus instrucciones depende de cómo se cargaron:
| Mecanismo | Después de la compactación |
|---|---|
| Prompt del sistema y estilo de salida | Sin cambios; no es parte del historial de mensajes |
| CLAUDE.md de raíz del proyecto y reglas sin alcance | Re-inyectadas desde el disco |
| Memoria automática | Re-inyectada desde el disco |
Reglas con frontmatter paths: |
Perdidas hasta que se lea un archivo coincidente nuevamente |
| CLAUDE.md anidado en subdirectorios | Perdido hasta que se lea un archivo en ese subdirectorio nuevamente |
| Cuerpos de skills invocados | Re-inyectados, limitados a 5,000 tokens por skill y 25,000 tokens en total; los más antiguos se descartan primero |
| Hooks | No aplicable; los hooks se ejecutan como código, no como contexto |
Las reglas con alcance de ruta y los archivos CLAUDE.md anidados se cargan en el historial de mensajes cuando se lee su archivo de activación, por lo que la compactación los resume junto con todo lo demás. Se recargan la próxima vez que Claude lee un archivo coincidente. Si una regla debe persistir a través de la compactación, elimine el frontmatter paths: o muévalo 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 coloque las instrucciones más importantes cerca de la parte superior de SKILL.md.
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. Ejecute /memory para verificar qué archivos CLAUDE.md y memoria automática se cargaron al inicio.
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