Claude Code: cuándo usar /compact y cuándo iniciar una sesión nueva

En Claude Code, /compact resume las partes más antiguas de la conversación en una representación más corta y estructurada. Así libera espacio en la ventana de contexto activa, intentando conservar el objetivo, las decisiones importantes y el estado actual del proyecto. Resulta útil cuando la tarea sigue siendo la misma y el enfoque es razonable, pero los logs, las salidas de herramientas, los diff y las discusiones intermedias han llenado la sesión de ruido.

Sin embargo, /compact no arregla por sí solo una sesión que ya está confundida. Después de compactar, el contexto activo deja de contener cada detalle anterior palabra por palabra. Un mensaje de error exacto, una solución ya descartada, una restricción temporal o una instrucción mencionada únicamente en el chat pueden perder protagonismo. Si Claude mezcla tareas, repite una solución fallida o parte de una hipótesis arquitectónica incorrecta, suele ser más seguro preparar un traspaso breve e iniciar una sesión limpia.

¿Qué hace /compact en Claude Code y en Claude Web?

En Claude Code, /compact resume los turnos anteriores y libera espacio de contexto sin modificar por sí mismo los archivos del proyecto. Claude Code también puede compactar automáticamente cuando el contexto se acerca a su límite, y puedes ejecutar el comando manualmente antes de que la sesión se vuelva lenta o demasiado ruidosa.

En los chats normales de Claude Web no existe un comando /compact para el usuario. Cuando la ejecución de código está activada y una conversación larga se aproxima al límite de contexto, Claude puede resumir automáticamente los mensajes antiguos y continuar. En ocasiones, la interfaz indica que Claude está “organizando sus ideas”. El historial completo se conserva, pero el contexto de trabajo activo utiliza un resumen en lugar de reenviar toda la transcripción literalmente.

Pregunta	Claude Code	Claude Web
Cómo se activa	Manualmente con /compact o de forma automática	Gestión automática cerca del límite
El usuario puede ejecutar el mismo comando	Sí	No hay un comando equivalente en el chat
Continúa la misma conversación	Sí, en la misma sesión	Sí, en el mismo chat
Objetivo principal	Liberar contexto para continuar la misma tarea de desarrollo	Prolongar conversaciones largas con menos interrupciones
Riesgo principal	Los errores exactos y las restricciones solo expresadas en el chat pueden quedar debilitados en el resumen	Los detalles antiguos pueden ser menos visibles en el contexto activo

/compact, /clear, /rewind o una sesión nueva: ¿cuál elegir?

Opción	Qué cambia	Cuándo conviene	Cuándo no conviene
Continuar	No se reinicia ni se resume nada	Claude recuerda el síntoma, las restricciones y la última evidencia	La sesión está en bucle, mezcla tareas o recupera ideas descartadas
/compact	Resume los turnos antiguos, libera contexto y mantiene la sesión	La tarea no ha cambiado, el rumbo es correcto y sobran logs o salidas de herramientas	La comprensión central es errónea o necesitas detalles históricos exactos
/clear	Inicia una conversación vacía en el proceso actual; la anterior puede recuperarse con /resume	Quieres un chat limpio sin cambiar de directorio de trabajo ni de archivos	Necesitas deshacer cambios de código; /clear no restaura archivos
/rewind	Abre checkpoints para restaurar código, conversación o resumir un tramo elegido	Los últimos turnos desviaron el trabajo y puedes identificar un punto bueno	Los cambios proceden de Bash, herramientas externas, ediciones manuales o la mayoría de subagentes
Sesión independiente	Empieza con contexto limpio en otro terminal, ventana o espacio aislado	Cambias de tarea, replanteas la arquitectura o trabajas en paralelo	El único problema es el exceso de logs en una sesión que aún entiende bien la tarea

/clear ya inicia una conversación nueva y vacía. En esta guía, “sesión independiente” significa crear un límite más deliberado: otro terminal o ventana, quizá una rama o worktree aparte, y un traspaso explícito que contenga únicamente hechos verificados.

Primero decide si el problema es el contexto o el diagnóstico

Supongamos que debes corregir una importación CSV. Si amount está vacío, el sistema debe devolver un error de validación y no escribir datos. Claude ya ha modificado dos veces el controlador, ha vuelto a abrir los mismos archivos y ahora propone recuperar la primera implementación.

No compactes ni reinicies todavía. Ejecuta primero la prueba más específica:

npm test -- tests/import/empty-amount.test.ts

Interpreta el resultado:

• La prueba no existe o comprueba otro comportamiento: el primer problema es una especificación ambigua o una reproducción insuficiente. Una sesión nueva no creará evidencias.
• La prueba reproduce de forma estable el síntoma correcto y Claude usa bien ese resultado: continúa en la sesión actual.
• La prueba falla de forma estable, pero Claude olvida causas ya descartadas, amplía el alcance o repite ideas anteriores: la degradación del contexto es una causa plausible.

No existe un número oficial de tokens o mensajes que determine cuándo compactar. Puedes usar un 60%–80% de contexto ocupado como recordatorio para revisar la sesión, no como regla rígida. La señal más fiable es el comportamiento: ¿Claude puede describir con precisión el objetivo, las restricciones, los hechos verificados y el siguiente comando de validación?

¿Cuándo conviene ejecutar /compact?

Da prioridad a /compact si se cumplen todas estas condiciones:

1. Sigues trabajando en la misma tarea y el mismo repositorio.
2. Claude entiende correctamente el objetivo y los archivos permitidos.
3. El enfoque actual está respaldado por pruebas o logs, no solo por una suposición.
4. La mayor parte del contexto la ocupan logs largos, salidas de compilación, diff repetidos o discusión intermedia.
5. Puedes escribir en pocas frases los hechos que no deben perderse.

Antes de compactar, revisa el árbol de trabajo:

git status --short
git diff

Después ejecuta /context para saber si la ventana está ocupada por mensajes, herramientas, definiciones MCP o CLAUDE.md. Si el problema real es un primer prompt gigantesco, adjuntos grandes, definiciones de herramientas o un archivo de memoria excesivo, quizá no haya suficientes turnos anteriores que /compact pueda resumir.

El CLAUDE.md de la raíz del proyecto vuelve a cargarse después de /compact. Las instrucciones que solo existían en la conversación son menos duraderas. Guarda las reglas estables en un CLAUDE.md conciso y vuelve a expresar los hechos específicos de la tarea alrededor del punto de compactación.

Verifica el contexto justo después de compactar

No permitas que Claude edite archivos inmediatamente después de /compact. Envía primero este prompt de comprobación:

Acabamos de compactar el contexto. Antes de cambiar cualquier archivo, responde a cuatro preguntas:
1. ¿Qué síntoma exacto estamos corrigiendo y cuál es el resultado esperado?
2. ¿Qué enfoque ya se probó y se descartó, y por qué?
3. ¿Qué archivos se pueden modificar y qué no debe cambiar?
4. ¿Qué único comando ejecutaremos a continuación para comprobar la hipótesis?

Si alguna respuesta no puede deducirse del contexto actual, indica qué información falta en lugar de inventarla.

Para el ejemplo, Claude debería recordar al menos lo siguiente:

• Un amount vacío debe producir un error de validación y no escribir datos.
• Number(value || 0) se descartó porque convierte un valor vacío en un cero válido.
• El alcance se limita al parser y a su prueba específica.
• El siguiente paso es una prueba o comando de seguimiento estrecho, no una refactorización de todo el sistema de importación.

Si las respuestas son correctas, continúa en la misma sesión. Si son vagas, recuperan la solución descartada o incluyen README y el formato CSV público dentro del alcance, no confíes en el resumen. Prepara un traspaso y usa /clear o inicia una sesión independiente.

Cuándo /compact no es la herramienta adecuada

1. La tarea ha cambiado

Comenzaste con un error de validación y luego añadiste una actualización del README, un cambio de despliegue y otro problema de API. La compactación resumirá todo junto; no creará límites claros. Lleva la segunda tarea a otra sesión.

2. La hipótesis principal de Claude ya es incorrecta

Si Claude insiste en tratar un valor vacío como cero o interpreta mal la ruta de escritura, el problema no es solo una conversación larga. Una sesión limpia basada en hechos verificados suele ser más rápida.

3. Los detalles exactos deben conservarse literalmente

Algunas líneas de error, consultas SQL, posiciones del stack, campos de protocolo o restricciones de seguridad no deben depender únicamente de un resumen. Guarda el fragmento mínimo necesario en una nota de traspaso o en un archivo local.

4. Una sola entrada ya es demasiado grande

Si el primer prompt contiene un log enorme, adjuntos o muchas definiciones de herramientas, no hay una conversación previa de varios turnos que compactar. Reduce la entrada, referencia los archivos por ruta o desactiva los servidores MCP que no necesites.

5. Ya no queda espacio para generar el resumen

/compact puede fallar si la ventana está tan llena que no cabe el propio resumen. Pulsa Esc dos veces, retrocede varios turnos y prueba de nuevo. Si sigue fallando, usa /clear; la sesión anterior seguirá disponible mediante /resume.

¿Cuándo es mejor /rewind que /compact?

Usa /rewind, o pulsa Esc dos veces con el cuadro de entrada vacío, cuando el problema se concentra en los turnos recientes. El menú de checkpoints permite:

• restaurar código y conversación;
• restaurar la conversación manteniendo los archivos actuales;
• restaurar el código manteniendo la conversación;
• resumir desde un punto seleccionado hacia adelante;
• resumir todo lo anterior a un punto seleccionado.

Esto resulta útil si los tres últimos turnos desviaron la tarea, pero el contexto anterior sigue siendo correcto.

Los checkpoints rastrean principalmente los cambios realizados mediante las herramientas de edición de archivos de Claude. Los cambios hechos con Bash, programas externos, edición manual o la mayoría de subagentes pueden no restaurarse. Tampoco sustituyen a Git: usa ramas, commits o al menos revisa git diff en los puntos importantes.

Cómo transferir la tarea de forma segura a una sesión nueva

La sesión nueva no necesita toda la transcripción. Necesita hechos verificados, el estado actual de los archivos y un único siguiente paso.

Primero revisa:

git status --short
git diff

Después envía un traspaso breve:

Objetivo: un amount vacío devuelve un error de validación y no escribe datos.
Árbol de trabajo: revisa primero git status y git diff; no supongas que está limpio.
Archivos objetivo: parser/amount.ts, tests/import/empty-amount.test.ts
Reproducción: npm test -- tests/import/empty-amount.test.ts
Resultado actual: la prueba falla.
Enfoque descartado: Number(value || 0), porque convierte un valor vacío en cero.
Restricciones: no cambiar el formato CSV público ni refactorizar módulos ajenos.
Pregunta abierta: ¿en qué capa debe distinguirse un valor vacío de un 0 legítimo?
Siguiente paso: seguir value desde el CSV parser hasta la validation branch y proponer una sola hipótesis comprobable.

Antes de editar, repite el objetivo, las restricciones, el enfoque descartado y el siguiente comando de validación.

No incluyas API Key, cookies, contenido de .env, datos personales ni logs completos sin filtrar. Si una línea de error es necesaria, conserva solo el fragmento mínimo y la ruta al log local.

Flujo de decisión en un minuto

1. Reproduce primero. Ejecuta la prueba o el comando más pequeño que demuestre el síntoma.
2. ¿La sesión aún puede avanzar con precisión? Si Claude recuerda el objetivo, las restricciones y el último resultado, continúa.
3. ¿El problema es principalmente ruido? Misma tarea, rumbo correcto y demasiados logs: usa /compact.
4. ¿Solo están mal los turnos recientes? Usa /rewind para restaurar o resumir un tramo concreto.
5. ¿Cambió la tarea o se degradó la comprensión? Usa /clear o una sesión independiente con traspaso.
6. Verifica antes de editar. Haz que Claude repita los hechos antes de permitir más cambios.

Preguntas frecuentes

¿Qué hace exactamente /compact en Claude Code?

Resume la parte antigua de una conversación de varios turnos en una representación más corta, liberando espacio para que continúe la misma sesión. El comando no modifica por sí mismo los archivos del proyecto.

¿/compact elimina el chat original o el código?

Su objetivo es compactar el contexto activo, no borrar código. La transcripción de la sesión se conserva, pero los turnos posteriores dependen principalmente del resumen y del contenido activo, por lo que conviene verificar los detalles críticos.

¿Cuándo usar /compact y cuándo abrir una sesión nueva?

Usa /compact si la tarea y el enfoque siguen siendo correctos y el problema principal son logs o salidas intermedias acumuladas. Empieza de nuevo si se mezclan tareas, reaparecen soluciones descartadas, se pierden restricciones o la arquitectura se entiende mal.

¿Qué significa Compact en Claude Web?

Claude Web puede resumir automáticamente los mensajes antiguos cuando un chat largo se acerca al límite de contexto. No es el comando /compact de Claude Code y normalmente no requiere activación manual. La gestión automática del contexto depende de que la ejecución de código esté habilitada.

¿Qué diferencia hay entre /clear y abrir otro terminal?

/clear inicia una conversación vacía dentro del proceso actual de Claude Code y la sesión anterior puede recuperarse con /resume. Otro terminal o ventana es mejor para aislar tareas, trabajar en paralelo o usar una rama o worktree independiente.

Referencias oficiales

• Modo interactivo de Claude Code y /clear
• Checkpoints y /rewind en Claude Code
• Errores de límite de contexto y /compact
• Comportamiento de CLAUDE.md después de compactar
• Claude Web: límites de uso, longitud y gestión automática del contexto