¿Tienes estos problemas al usar Claude Code?
・Cuando la sesión de Claude Code se alarga, la calidad de las respuestas baja por alguna razón.
・¿Cuáles son los comandos? No entiendo bien las diferencias.
・No sé cuándo usar subagentes.
・El contexto es un desastre total.
Ahora mismo, un post de Thariq (@trq212), un empleado de Anthropic, sobre "gestión de sesiones de Claude Code y el contexto de 1 millón de tokens" se está volviendo viral con 540,000 vistas 😳
Así que, para todos los que tienen estos problemas, voy a desglosar y explicar el contenido de forma fácil de entender 👇
Post original aquí: https://x.com/trq212/status/2044548257058328723?s=20
■ Fundamentos de la 𝗰𝗼𝗻𝘁𝗲𝘅𝘁 𝘄𝗶𝗻𝗱𝗼𝘄
Primero, como requisito previo, la ventana de contexto de Claude Code es de 1 millón de tokens.
El contexto incluye todo lo siguiente:
・Prompt del sistema
・Historial de conversaciones pasadas
・Todas las llamadas a herramientas y sus resultados
・Contenido de los archivos cargados
En otras palabras, cuanto más larga es la sesión, más información se acumula en este contexto.
■ ¿Qué es el 𝗰𝗼𝗻𝘁𝗲𝘅𝘁 𝗿𝗼𝘁?
Un concepto importante aquí es el "context rot".
A medida que el contexto crece, la atención del modelo se dispersa entre muchos tokens, y la información antigua o irrelevante se convierte en ruido que comienza a interferir con la tarea actual.
Según Thariq, el context rot se observa a partir de unos 300,000 a 400,000 tokens en el modelo de 1 millón de tokens. Sin embargo, no es una regla estricta ya que depende mucho de la tarea.
Dado que la ventana de contexto tiene un límite estricto, cuando te acercas al límite, necesitas resumir el trabajo anterior y continuar en un nuevo contexto. Este proceso se llama "compaction".
■ Cada turno es un "Punto de Inflexión"
¿Qué debería hacer Claude Code después de terminar una tarea? Este es en realidad el punto de decisión más importante.
Thariq enumera cinco opciones:
𝟭. 𝗖𝗼𝗻𝘁𝗶𝗻𝘂𝗲
Envía el siguiente mensaje en la misma sesión. La opción más natural.
𝟮. /𝗿𝗲𝘄𝗶𝗻𝗱 (Doble toque Esc Esc)
Vuelve a un mensaje anterior y reinicia desde allí. Los mensajes posteriores se eliminan del contexto.
𝟯. /𝗰𝗹𝗲𝗮𝗿 (Nueva sesión)
Resume tú mismo la información importante y comienza una sesión nueva.
𝟰. /𝗰𝗼𝗺𝗽𝗮𝗰𝘁
Haz que el modelo resuma la conversación hasta ahora y continúa sobre ese resumen.
𝟱. 𝗦𝘂𝗯𝗮𝗴𝗲𝗻𝘁𝘀
Delega el siguiente bloque de trabajo a un agente con su propio contexto limpio, devolviendo solo el resultado a la sesión principal.
■ Cuándo iniciar una nueva sesión
Gracias a la ventana de contexto de 1 millón de tokens, tareas largas como construir una aplicación full-stack desde cero ahora se pueden ejecutar de manera más estable.
Sin embargo, el hecho de que quede espacio en el contexto no significa que debas continuar la misma sesión.
La regla general de Thariq es simple:
🔥 "Si estás empezando una nueva tarea, deberías iniciar una nueva sesión."
Hay excepciones. Por ejemplo, escribir documentación inmediatamente después de implementar una funcionalidad. Si inicias una nueva sesión, Claude Code tiene que volver a leer los archivos que acaba de implementar, lo cual es lento y costoso. Para tareas como documentación que no requieren "alta inteligencia", es más eficiente aceptar algo de contaminación del contexto y simplemente continuar.
■ 𝗿𝗲𝘄𝗶𝗻𝗱 es la función más infravalorada
Thariq cita "rewind" como el mejor hábito para una buena gestión del contexto.
En Claude Code, puedes volver a cualquier mensaje anterior y reiniciar presionando dos veces la tecla Esc (o usando el comando /rewind). Los mensajes posteriores a ese punto se eliminan por completo del contexto.
Considera un escenario específico:
Claude leyó cinco archivos y probó un enfoque que falló.
❌ Reacción normal: "Eso no funcionó. Prueba X en su lugar."
→ Todo el registro del enfoque fallido permanece en el contexto.
✅ Mejor manera: Retrocede (rewind) justo después de que se leyeron los archivos y vuelve a instruir con lo que aprendiste.
→ "No uses el enfoque A. El módulo foo no expone eso. Ve directamente con B."
Al hacer esto, los tokens del ensayo y error fallido desaparecen, permitiendo un reintento en un estado limpio.
Además, usar una función de "resumir desde aquí" permite a Claude resumir su propio aprendizaje y crear un "memo del yo pasado al yo futuro".
■ La diferencia crítica entre /𝗰𝗼𝗺𝗽𝗮𝗰𝘁 y /𝗰𝗹𝗲𝗮𝗿
Cuando una sesión se alarga, hay dos formas de reducir el peso. Parecen similares pero son completamente diferentes.
【/compact】
・El modelo resume la conversación y reemplaza el historial con ese resumen.
・Con pérdida (lossy) — lo importante queda a criterio de Claude.
・No tienes que escribir nada, pero Claude podría pasar algo por alto.
・Puedes proporcionar instrucciones para guiarlo (ej., /compact focus on auth refactor, remove test debugging).
【/clear】
・Escribes tú mismo la información importante y comienzas una sesión nueva.
・Como: "El objetivo es el middleware de autenticación, las restricciones son X, los archivos relacionados son A y B, el enfoque Y está excluido."
・Requiere esfuerzo, pero el contexto resultante consiste solo en la información que elegiste.
Elegir entre ellos es un equilibrio entre control y conveniencia.
■ Por qué falla 𝗰𝗼𝗺𝗽𝗮𝗰𝘁
Al usar sesiones largas, la calidad de compact puede volverse extremadamente pobre.
Según Thariq, la mayor causa de un mal compact es "cuando el modelo no puede predecir la dirección del trabajo".
Ejemplo:
Después de una larga sesión de depuración, se activa autocompact y resume la investigación.
→ Si luego dices "Arregla también esa advertencia en bar.ts", la información sobre esa advertencia podría haberse omitido del resumen centrado en la depuración.
Aún más problemático es el dilema de que, debido al context rot, el modelo está en su "estado de inteligencia más bajo" al ejecutar compact. En otras palabras, el resumen de menor calidad se genera en el momento en que se necesita el resumen más preciso.
Ahora que tenemos un contexto de 1 millón de tokens, la mejor estrategia es ejecutar /compact tú mismo mientras todavía tengas espacio, añadiendo una explicación de qué hacer a continuación.
■ Cuándo usar 𝗦𝘂𝗯𝗮𝗴𝗲𝗻𝘁𝘀
Los subagentes también son una forma de gestión del contexto.
Cuando Claude Code crea un subagente con la herramienta Agent, ese subagente tiene su propia ventana de contexto limpia. Hace todo el trabajo necesario, resume el resultado y lo devuelve a la sesión principal.
El criterio es simple:
👀 "¿Necesitaré esta salida de la herramienta más adelante? ¿O es suficiente solo la conclusión?"
Si solo la conclusión es suficiente, deberías dejarlo en manos de un subagente.
Claude Code llama a subagentes automáticamente, pero dar instrucciones explícitas también es efectivo:
・"Inicia un subagente y verifica los resultados del trabajo basándote en este archivo de especificaciones."
・"Usa un subagente para leer y resumir cómo se implementa el flujo de autenticación en otro código base. Úsalo como referencia para implementarlo aquí."
・"Usa un subagente para escribir documentación para esta funcionalidad a partir del git diff."
Al no traer resultados intermedios al contexto principal, mantienes el contexto limpio.
■ Resumen: 5 Técnicas de Gestión del Contexto
Cosas que siempre deberías decidir antes de enviar el siguiente mensaje después de que Claude termine un turno:
- ¿Cambió la tarea? → /clear para una nueva sesión
- ¿Falló el enfoque? → /rewind para volver justo después de cargar archivos
- ¿Se está alargando la sesión? → /compact mientras tengas espacio (con dirección)
- ¿Es una tarea con muchos resultados intermedios? → Delegar a un subagente
- ¿Se puede usar el contexto para tareas relacionadas? → Continuar tal cual
En el futuro, el propio Claude ayudará con estas decisiones, pero por ahora, los usuarios que tomen estos juicios pueden mejorar significativamente la calidad de salida de Claude Code.
La gestión de sesiones es sutil, pero es una habilidad que cambia fundamentalmente la experiencia de Claude Code 🔥
Para aquellos que encontraron útil este artículo:
𝗖𝗹𝗮𝘂𝗱𝗲 𝗖𝗼𝗻𝗱𝗲 𝗦𝘁𝘂𝗱𝗶𝗼 @ 𝗝𝗮𝗽𝗮𝗻 (@ClaudeCode_love) es una cuenta gestionada por tres entusiastas de Claude Code.
Publicamos diariamente sobre uso práctico de CLI y automatización.
Actualmente estamos co-desarrollando un agente de IA con una empresa cotizada.
Nuestro contenido habitual 👇
・Casos reales de desarrollo de productos usando Claude Code y Claude
・Uso de Claude Code / Vibe Coding / organización de tendencias de desarrollo
・Información más reciente sobre Claude Code desde el extranjero
Desde la filosofía de desarrollo hasta el diseño, implementación y mejora, resumimos información del extranjero y de fuentes primarias para ayudarte a lanzar productos funcionales, no solo "terminar de hacerlos".
Si estás interesado, ¡síguenos y échanos un vistazo! ¡Valdrá la pena!
