English

Tu historial se borra en 30 días

Intenta retomar una sesión de hace dos meses. No está. No archivada, no comprimida: borrada, por un temporizador que nunca configuraste y sin nada que te avisara que iba a pasar.

Un barrido de retención que no elegiste

Las transcripciones de sesión se guardan localmente, en texto plano, bajo ~/.claude/projects/, para poder retomar sesiones. También se barren según un calendario: el periodo de retención es cleanupPeriodDays y su valor por defecto es de 30 días.

La limpieza corre al arrancar y elimina los archivos más viejos que el periodo. No hay aviso ni confirmación, y por eso casi todos descubren el comportamiento notando una ausencia: una lista de sesiones sospechosamente corta, o una conversación específica que fueron a buscar y no encontraron.

Treinta días es un valor razonable para lo que está diseñado a hacer, que es evitar que un caché de transcripciones en texto plano crezca sin límite en tu disco. Es un mal calce con cómo la gente realmente usa esas sesiones, que es como registro de cómo se resolvió un problema difícil.

Cámbialo en una línea

Define el periodo en tu archivo de configuración:

{
  "cleanupPeriodDays": 365
}

Eso guarda un año. El ajuste puede vivir en cualquier capa de configuración, sea de usuario, de proyecto, local o de política administrada, así que puedes subirlo globalmente en ~/.claude/settings.json o por proyecto donde el historial valga más.

Hazlo antes de necesitarlo. La retención no es retroactiva: subir el número hoy no hace nada por las sesiones que se barrieron el mes pasado. Ya no están en el disco local, y este es el único ajuste donde leer sobre él y no actuar trae una fecha límite adjunta.

Qué sobrevive al barrido y qué no

El barrido no es indiscriminado, y la distinción es útil.

Exento: el directorio de memoria automática. Las notas que el agente guardó sobre tus preferencias, tus correcciones y el contexto del proyecto quedan excluidas del barrido. MEMORY.md y sus archivos temáticos permanecen hasta que tú o el agente los editen o borren.

No exento: las conversaciones mismas. También se barren con el mismo calendario los informes HTML de /insights y las listas de tareas de equipos de agentes.

Así que la capa duradera es la que el agente cura, no la que tú viviste. Todo lo que querrías releer, el razonamiento, los callejones sin salida, la depuración real, está en la transcripción, y la transcripción es lo que vence.

No dependas de la transcripción como registro

Subir el número es el arreglo inmediato, pero el hábito de fondo es no tratar una sesión retomable como documentación. Incluso con un año de retención, una transcripción es mal lugar para guardar una conclusión: es larga, sin estructura, local a tu máquina e invisible para el resto del equipo.

Cuando una sesión produce algo que vale la pena conservar, muévelo a un lugar duradero mientras lo tienes enfrente:

• Una trampa que la próxima persona va a pisar va en el archivo de reglas.
• Una decisión con alternativas consideradas va en un ADR.
• Un procedimiento repetible va en una skill, donde de verdad se puede volver a ejecutar.
• Un hecho sobre cómo trabajas va en la memoria automática, que además está exenta del barrido.

Hay también una dependencia práctica que conviene saber: /insights analiza tus sesiones recientes para reportar cómo trabajas y dónde se traba todo. Solo puede analizar sesiones que todavía existen. Una retención agresiva limita en silencio esa herramienta a lo que haya sobrevivido.

Para llevar

Tu mejor sesión de depuración tiene fecha de vencimiento, son 30 días por defecto, y nada te avisa. Ajusta cleanupPeriodDays hoy a algo con lo que estés cómodo, ya que el ajuste no recupera lo que ya se barrió. Después deja de usar transcripciones como memoria: las notas que el agente guarda están exentas del barrido, y las conclusiones que escribes están exentas del problema completo.