Saltar al contenido principal
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 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: /compact 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. Lo que sucede con sus instrucciones depende de cómo se cargaron:
MecanismoDespués de la compactación
Prompt del sistema y estilo de salidaSin cambios; no es parte del historial de mensajes
CLAUDE.md de raíz del proyecto y reglas sin alcanceRe-inyectadas desde el disco
Memoria automáticaRe-inyectada desde el disco
Reglas con frontmatter paths:Perdidas hasta que se lea un archivo coincidente nuevamente
CLAUDE.md anidado en subdirectoriosPerdido hasta que se lea un archivo en ese subdirectorio nuevamente
Cuerpos de skills invocadosRe-inyectados, limitados a 5,000 tokens por skill y 25,000 tokens en total; los más antiguos se descartan primero
HooksNo 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.

Cuando su contexto se llena

Claude Code se compacta automáticamente a medida que se acerca al límite, por lo que una ventana de contexto llena no termina su sesión. El paso automático funciona de la misma manera que el paso /compact en la línea de tiempo. Vea Cuando el contexto se llena para saber qué preserva. 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.
  • 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 necesita una ventana más grande en lugar de una conversación más pequeña, Fable 5, Sonnet 5, Opus 4.6 y posteriores, y Sonnet 4.6 admiten una ventana de contexto de 1 millón de tokens. Vea Contexto extendido para disponibilidad por plan y cómo seleccionar una variante de modelo [1m]. Sonnet 5 se ejecuta a 1M sin variante [1m] para seleccionar; vea Ventana de contexto de Sonnet 5 para sus umbrales de compactación automática y la excepción de la puerta de enlace LLM. La compactación funciona de la misma manera en el límite más grande.

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. Para una cobertura más profunda de las características mostradas en la línea de tiempo, vea estas páginas: