La ventana de contexto de Claude Code es la memoria de trabajo para tu sesión actual. Contiene tu conversación, cada archivo leído, definiciones de herramientas MCP, configuraciones de agentes personalizados, archivos de memoria e historial completo de llamadas a herramientas, como describe la documentación de ventana de contexto de Claude Code. Cuando se llena, tienes tres palancas: /compact, /clear, o comenzar una nueva sesión con una entrega estructurada. Cuál uses cambia la calidad de todo lo que viene después.
Elige Compactar, Limpiar o una Nueva Sesión
Tres comandos, tres resultados diferentes. Entender la diferencia es el juego completo.
`/compact` reemplaza el historial de conversación con un resumen condensado y mantiene la sesión en funcionamiento. El contexto se reduce, la sesión continúa y Claude retiene cierta conciencia histórica. Puedes guiar qué mantiene: /compact focus on the auth bug fix le dice al modelo qué importa en lugar de dejarlo adivinar. La referencia oficial de ventana de contexto confirma que puedes pasar instrucciones directamente al paso compacto.
`/clear` es un reinicio total. Toda la conversación se borra. Sin historial, sin contexto de archivo en memoria, sin transferencia. Como lo describe el análisis de ventana de contexto de Damian Galarza, usar /clear sin antes persistir tu plan significa que comienzas desde cero. Está bien, a veces es intencional.
Comenzar una nueva sesión con un documento de entrega te da una pizarra limpia más continuidad. Más abajo sobre cómo estructurar esa entrega.
El árbol de decisiones aproximado:
- Misma tarea, más espacio necesario: usa
/compactcon una instrucción de enfoque. - Cambio a trabajo no relacionado: usa
/clear. - Tarea demasiado grande para una sesión o calidad ya degradándose: crea una entrega e inicia de nuevo.
Una cosa a notar: /autocompact se ejecuta automáticamente cuando te acercas al límite. Puedes establecer qué tan llena está la ventana antes de que se active, por ejemplo /autocompact 500k, pero el paso automático toma sus propias decisiones sobre qué mantener. Está bien para sesiones cortas. Para cualquier cosa arquitectónica, quieres ejecutar /compact manualmente antes de que el paso automático tome el control.
Ve Qué Consume Contexto
Antes de gestionar el contexto, necesitas verlo. Ejecuta /context y obtienes un desglose: tamaño total del contexto, las categorías que consumen más tokens y una barra visual que muestra la división. Claude Code 101 de la academia oficial te guía a través de esta salida. Las categorías principales son historial de conversación, contenidos de archivo cargados en la sesión, historial de llamadas a herramientas y cualquier archivo de memoria o configuración de agente.
La mayoría de los desarrolladores se sorprenden por el historial de llamadas a herramientas. Las sesiones de depuración largas con muchas idas y venidas se acumulan rápido. Una docena de lecturas de archivos, cada una con salida completa, se suma rápidamente. Eso suele ser lo primero en lo que enfocarse.
Lo que se preserva a través de un pase compacto
De acuerdo con la documentación oficial, el contenido de inicio se recarga automáticamente después de un compacto. Lo que necesitas observar es la sutileza en la conversación misma: decisiones arquitectónicas específicas, razones detrás de una refactorización, por qué rechazaste un enfoque particular. Esas sobreviven un compacto enfocado. A menudo no sobreviven el pase automático, que no sabe qué te importa.
Limita las Lecturas del Repositorio y la Salida de Herramientas
Cómo lees archivos en la sesión importa tanto como cuándo haces un compacto. Leer directorios completos o archivos grandes cuando solo necesitas una o dos funciones es una de las formas más rápidas de quemar contexto.
Algunos hábitos que ayudan:
- Pídele a Claude que lea solo el archivo específico y el rango de líneas que necesitas, no el módulo completo.
- Cuando necesites investigar una área grande de la base de código, delégalo a un sumagente. El contenido del archivo permanece en el contexto del sumagente, no en el tuyo. Solo obtienes el resultado. La documentación oficial de la ventana de contexto lo señala explícitamente: "Delega lecturas grandes: envía la investigación a un sumagente para que el contenido del archivo permanezca en su ventana de contexto, no en la tuya".
- Evita releer archivos que ya hayas discutido a menos que algo haya cambiado. Claude ya tiene ese contenido en la conversación.
- Sé específico con las llamadas de herramientas grep y búsqueda. Las búsquedas amplias devuelven resultados amplios.
Para cualquiera que esté construyendo flujos de trabajo multi-agente en Claude Code, la guía de sumagentes de Claude Code cubre cómo estructurar esas delegaciones. Y si trabajas a nivel de SDK, la guía del SDK de Agentes Claude profundiza en los límites de contexto entre agentes.
Si estás gastando más tiempo luchando contra el contexto que escribiendo código, podría valer la pena hablar con alguien que hace esto a tiempo completo. El equipo de desarrollo Claude Code de Seahawk puede ayudarte a configurar la estructura de proyecto correcta desde el inicio.
Preserva Decisiones Al Hacer Compacto
Este es el paso que la mayoría de los desarrolladores omiten. Justo antes de que hagas un compacto o limpies, pídele a Claude un resumen:
"Antes de hacer compacto, dame una lista con viñetas de las decisiones clave que tomamos, cualquier cosa que explícitamente rechazamos y por qué, y el estado actual del trabajo".
Cópialo en tu CLAUDE.md o una nota rápida. Cuando reanudes, pégalo como contexto inicial. La guía de MindStudio sobre el comando `/compact` describe esto como la diferencia entre compresión controlada y compresión caótica: cuando ejecutas /compact manualmente, tú eliges qué se preserva; cuando se dispara el pase automático, el modelo decide, y a menudo mantiene la salida mundana sobre el razonamiento arquitectónico.
La otra palanca es tu propio CLAUDE.md. Decisiones arquitectónicas, relaciones de componentes no obvias, cosas que Claude nunca debería hacer en esta base de código: estas pertenecen allí permanentemente, no solo en la conversación. Cada nueva sesión carga CLAUDE.md automáticamente, así que es el único lugar donde el contexto realmente persiste entre sesiones.
Cuándo no hacer compacto
- En medio de la depuración, cuando los mensajes de error específicos y las trazas de pila siguen siendo relevantes.
- Durante una refactorización donde el detalle a nivel de archivo se está utilizando activamente.
- Justo antes del trabajo de integración que depende del contexto del componente que acabas de construir.
La guía de gestión de contexto de Claudefast resume esto bien: compactar en puntos de ruptura naturales entre fases de trabajo, no en el medio de una fase.
Divide tareas grandes sin perder la entrega
Algunas tareas son genuinamente demasiado grandes para una sesión. Eso no es un fracaso, es solo cómo funcionan los repositorios grandes. La respuesta es un documento de entrega estructurado creado antes de que termine la sesión, no después de que la calidad ya haya bajado.
Un documento de entrega útil cubre:
- Qué se completó (con referencias de commit o rutas de archivos).
- Qué está en progreso y en qué estado se encuentra.
- Decisiones tomadas y por qué (especialmente cualquier cosa no obvia).
- Qué viene después, con suficiente detalle para que una sesión nueva pueda retomarlo sin releer todo.
- Cualquier pregunta abierta u obstáculo.
Un profesional en LinkedIn describió esto como el núcleo de un sistema de entrega de sesión: en un nivel de uso de contexto establecido, la sesión crea un documento de entrega con lo que se hizo, referencias de commit y estado actual. La nueva sesión se abre con ese documento como primer mensaje. El post de LinkedIn de JD Fiscus sobre compacto vs claro describe un bucle TASK > COMMIT > CLEAR > RECAP > RESCAN para mantener las tareas enfocadas, que funciona bien para trabajo de características iterativas.
El flujo de trabajo, concretamente:
- Completa una unidad lógica de trabajo y confirma.
- Pídele a Claude que produzca un resumen de entrega cubriendo los cinco puntos anteriores.
- Copia el resumen a un archivo en tu repositorio o a
CLAUDE.md. - Ejecuta
/clearo inicia una nueva sesión. - Abre la nueva sesión con el documento de entrega como contexto.
De esta manera nunca estás comenzando desde cero y nunca arrastras un historial de sesión desordenado hacia trabajo que necesita una cabeza clara.
Límites específicos del modelo y solución de problemas
Los tamaños de ventana de contexto varían según el modelo. El post de Damian Galarza señala que Claude Sonnet 4.5 tiene una ventana de contexto de aproximadamente 200.000 tokens como punto de referencia. Otros modelos de Claude tienen sus propios límites; consulta la documentación oficial del modelo para cifras actuales en lugar de confiar en números de la comunidad que pueden estar desactualizados.
Qué observar:
- Repetición. Claude comienza a hacer preguntas que ya has respondido, o contradice una decisión anterior. Esa es una señal de que el contexto relevante se ha perdido o se ha resumido mal.
- Instrucciones ignoradas. Si Claude deja de seguir las convenciones del proyecto que manejaba correctamente antes, el contenido de
CLAUDE.mdpuede haber sido desplazado. Ejecuta/contextpara verificar. - Respuestas lentas y costosas. Un contexto grande consume tokens en cada mensaje. Si los costos están aumentando,
/contextte mostrará por qué.
Algo vale la pena destacar: las afirmaciones sobre umbrales de compactación universales (un porcentaje específico de ocupación en el que la calidad siempre disminuye) no están respaldadas por la documentación oficial. El momento correcto para compactar depende de la tarea. La heurística aproximada de varios practicantes es actuar en un límite de fase natural, antes de ver degradación, no después. Pero tus resultados variarán según el tipo de tarea, el modelo y cuánto de tu contexto sea código denso en lugar de conversación.
FAQ
¿`/compact` consume tokens?
Sí. El pase de compactación en sí es una llamada al modelo y usa tokens. Ejecutarla manualmente en un límite de fase suele costar menos que dejar que el pase automático se active en un nivel de utilización alto, porque el resumen que produce es más limpio y gastas menos tokens en los mensajes que siguen.
¿`/clear` afectará mi `CLAUDE.md`?
No. CLAUDE.md es un archivo en disco. /clear elimina solo la conversación en sesión y la memoria. Tu CLAUDE.md se recarga automáticamente la próxima vez que Claude Code lea tu directorio de proyecto.
¿Puedo compactar solo parte de la conversación?
Sí. Ejecuta /rewind, selecciona un mensaje y elige "Summarize from here" o "Summarize up to here". La documentación oficial de la ventana de contexto describe qué mantiene cada opción. Esto es útil cuando un hilo de depuración específico está saturando el contexto pero la conversación anterior sigue siendo importante.
¿Los worktrees del mismo repositorio comparten contexto?
Comparten memoria automática a nivel local de máquina, según la documentación oficial de memoria. No comparten contexto de sesión. Cada sesión de worktree tiene su propia ventana de contexto.
¿Qué sucede con las definiciones de herramientas MCP después de una compactación?
La documentación oficial indica que el contenido de inicio, incluidas las definiciones de herramientas MCP, se recarga automáticamente después de un pase de compactación. No deberías necesitar re-registrar herramientas manualmente, pero es útil ejecutar /context después de una compactación en una sesión compleja para confirmar que el desglose se ve correcto.
La advertencia más importante de todo esto: para cuando notes que la calidad está degradándose, tu resumen de compactación probablemente incluya salidas confusas junto con las buenas. Compacta al final de una fase limpia, no al inicio de una desordenada.