TL;DR Cuando la sesión se acerca al límite, Claude Code compacta solo, sin que escribas nada, y resume la conversación. Pero no todo vuelve igual: el system prompt, el CLAUDE.md raíz y la auto memory se re-inyectan del disco; en cambio tus reglas con
paths:, el CLAUDE.md de subcarpeta y el cuerpo de las skills se pierden o se recortan. Por eso a veces Claude "se olvida" de una regla a media tarea. Regla de oro: lo que tiene que sobrevivir va al CLAUDE.md raíz o al principio delSKILL.md.
Lo inquietante no es el /compact que lanzas tú. Es el automático: cuando el contexto se acerca al límite, Claude Code compacta por su cuenta, a mitad de tarea, sin que toques nada. Y una regla que estaba gobernando tus edits puede dejar de aplicarse justo ahí, en silencio.
Ese límite tampoco es fijo, y no siempre lo decides tú: cuatro sitios pueden fijar la ventana de auto-compact y uno de ellos gana a los demás sin avisar.
Cómo funciona la compactación
Compactar reemplaza el historial de la conversación por un resumen estructurado. Lo que vuelve después depende de cómo se cargó cada instrucción:
- Lo que vive fuera del historial (system prompt, output style) queda intacto.
- Lo que se relee del disco al arrancar (CLAUDE.md raíz, reglas sin scope, auto memory) se re-inyecta.
- Lo que entró como mensaje en el historial (reglas con
paths:, CLAUDE.md anidado, cuerpos de skill) se resume con el resto y solo vuelve cuando se dispara de nuevo.
El /compact manual y el automático funcionan igual. La diferencia es que el automático no lo eliges tú.
Cómo se ve
# Antes: la regla paths: gobierna tus edits
[Loaded .claude/rules/api-conventions.md] ← aplica a src/api/**
# Claude compacta solo al acercarse al límite
⏺ Conversation compacted
# Después: la misma edición, sin esa regla
# (vuelve sola en cuanto Claude relee un archivo de src/api/)
Qué sobrevive y qué no
| Mecanismo | Tras la compactación |
|---|---|
| System prompt y output style | Intactos (no son historial) |
| CLAUDE.md raíz y reglas sin scope | Se re-inyectan del disco |
| Auto memory (MEMORY.md) | Se re-inyecta del disco |
Lista de tareas (Ctrl+T) |
Sobrevive, cuando tu modelo la guarda |
Reglas con paths: |
Se pierden hasta que vuelvas a leer un archivo que las dispare |
| CLAUDE.md anidado en subcarpetas | Se pierde hasta releer un archivo de esa carpeta |
| Cuerpos de skills invocadas | Se re-inyectan, pero topados a 5.000 tokens por skill y 25.000 en total; la más vieja cae primero |
| Hooks | No aplica (corren como código, no como contexto) |
"Se pierden" no es "se borran para siempre": las reglas paths: y el CLAUDE.md anidado vuelven solos en cuanto Claude lee otra vez un archivo que los active. También los devuelve un @ a un fichero de esa carpeta, porque cada mención readjunta el fichero y el CLAUDE.md de su árbol, aunque eso se paga entero otra vez. El problema es la ventana entre medias, en la que Claude trabaja sin ellos sin avisarte.
Cómo hacer que sobrevivan
1. Reglas que no pueden faltar nunca
Si una regla tiene que aplicarse pase lo que pase, no la dejes dependiendo de un paths:. Quítale el frontmatter de scope o muévela al CLAUDE.md raíz: ese se re-inyecta siempre.
2. Instrucciones críticas, al principio del SKILL.md
Cuando una skill se re-inyecta, el truncado conserva el principio del archivo y descarta el final. Pon lo que de verdad importa (las reglas duras, los gotchas) en las primeras líneas del SKILL.md, no al final.
3. Compacta tú, con foco, antes de una tarea larga
En vez de esperar al auto-compact a mitad de tarea, lánzalo tú en una pausa natural y dile qué conservar. La pausa que más se nota es la de levantarte de la mesa: compactar antes de irte cuesta una décima parte que compactar al volver, porque el resumen se paga leyendo la conversación entera y esa lectura sale de la caché solo si la caché sigue viva. El hábito 3 de cómo ahorrar tokens cubre el /compact con instrucciones. Y si lo que quieres es comprimir solo el arranque exploratorio y dejar intacto lo reciente, Summarize up to here lo hace dirigido desde el menú de Rewind, sin resumir toda la sesión.
Esto es la otra cara de prompt caching: allí /compact apenas penaliza en consumo; aquí el coste es de fidelidad, lo que se lleva por delante de tus instrucciones. Y para entender qué se carga al arrancar (antes de cualquier compactación), está cuándo carga Claude Code cada feature. Y si lo que notas es que Claude rinde peor cuanto más larga es la sesión, esa es la higiene de contexto para que no se te llene la ventana.
Documentación oficial: Explore the context window