¿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 puedo decidir cuándo usar subagentes.
・El contexto es un desastre total.
Justo ahora, una publicación de Thariq (@trq212), 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 👇
Publicación original aquí: https://x.com/trq212/status/2044548257058328723?s=20
■ Conceptos básicos 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 anteriores
・Todas las llamadas a herramientas y sus resultados
・Contenido de los archivos cargados
En otras palabras, cuanto más larga sea la sesión, más información se acumula en este contexto.
■ ¿Qué es la 𝗱𝗲𝘁𝗲𝗿𝗶𝗼𝗿𝗼 𝗱𝗲𝗹 𝗰𝗼𝗻𝘁𝗲𝘅𝘁𝗼?
Un concepto importante aquí es el "deterioro del contexto" (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 deterioro del contexto se observa a partir de unos 300,000 a 400,000 tokens en el modelo de 1 millón de tokens. Sin embargo, esto no es una regla estricta, ya que depende mucho de la tarea.
Dado que la ventana de contexto tiene un límite máximo, cuando te acercas al límite, necesitas resumir el trabajo anterior y continuar en un nuevo contexto. Este proceso se llama "compactación".
■ Cada turno es un "Punto de inflexión"
¿Qué debería hacer Claude Code después de completar una tarea? Este es en realidad el punto de decisión más importante.
Thariq enumera cinco opciones:
𝟭. 𝗖𝗼𝗻𝘁𝗶𝗻𝘂𝗮𝗿
Enviar el siguiente mensaje en la misma sesión. La opción más natural.
𝟮. /𝗿𝗲𝘄𝗶𝗻𝗱 (Doble toque de Esc Esc)
Volver a un mensaje anterior y reiniciar desde allí. Los mensajes posteriores se eliminan del contexto.
𝟯. /𝗰𝗹𝗲𝗮𝗿 (Nueva sesión)
Resumir la información importante tú mismo y comenzar una sesión nueva.
𝟰. /𝗰𝗼𝗺𝗽𝗮𝗰𝘁
Hacer que el modelo resuma la conversación hasta ahora y continuar sobre la base de ese resumen.
𝟱. 𝗦𝘂𝗯𝗮𝗴𝗲𝗻𝘁𝗲𝘀
Delegar 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, las 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 comenzando una nueva tarea, deberías iniciar una nueva sesión."
Hay excepciones. Por ejemplo, escribir documentación inmediatamente después de implementar una función. 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 subestimada
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: Retroceder justo después de que se leyeron los archivos y dar nuevas instrucciones con lo aprendido.
→ "No uses el enfoque A. El módulo foo no expone eso. Ve directamente con B."
Al hacer esto, los tokens de la prueba y error fallida desaparecen, permitiendo un reintento en un estado limpio.
Además, usar una función de "resumir desde aquí" permite que Claude resuma su propio aprendizaje y cree 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: lo importante queda a criterio de Claude.
・No tienes que escribir nada, pero Claude podría omitir algo.
・Puedes dar instrucciones para guiarlo (ej., /compact enfócate en la refactorización de auth, elimina la depuración de pruebas).
【/clear】
・Tú mismo escribes la información importante y comienzas una sesión nueva.
・Como: "El objetivo es el middleware de auth, las restricciones son X, los archivos relacionados son A y B, el enfoque Y está descartado."
・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 el 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 en el resumen centrado en la depuración.
Aún más problemático es el dilema de que, debido al deterioro del contexto, el modelo está en su "estado de inteligencia más bajo" al ejecutar compact. En otras palabras, se genera el resumen de menor calidad 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 aún 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:
👀 "¿Voy a necesitar este resultado de la herramienta más adelante? ¿O solo basta con la conclusión?"
Si solo basta con la conclusión, 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 fuente. Úsalo como referencia para implementarlo aquí."
・"Usa un subagente para escribir documentación para esta función 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 los 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 toman 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 con Claude Code 🔥
Para quienes encontraron útil este artículo:
𝗖𝗹𝗮𝘂𝗱𝗲 𝗖𝗼𝗻𝗱𝗲 𝗦𝘁𝘂𝗱𝗶𝗼 @ 𝗝𝗮𝗽𝗼́𝗻 (@ClaudeCode_love) es una cuenta gestionada por tres entusiastas de Claude Code.
Publicamos a diario sobre uso práctico de la CLI y automatización.
Actualmente co-desarrollamos un agente de IA con una empresa que cotiza en bolsa.
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 "terminarlos".
Si te interesa, ¡síguenos y échanos un vistazo! Valdrá la pena.
