Cómo busca Claude Code un ID de sesión
Las sesiones se almacenan por proyecto. La documentación de sesiones de Anthropic indica que Claude Code guarda las transcripciones "como JSONL en ~/.claude/projects/<proyecto>/<session-id>.jsonl, donde <proyecto> es la ruta de tu directorio de trabajo con los caracteres no alfanuméricos reemplazados por -."
Cuando reanudas por ID, Claude Code busca en un orden fijo:
- El directorio del proyecto actual y sus git worktrees.
- Todos los demás proyectos en esta máquina.
Anthropic añade una condición al segundo paso: "La búsqueda entre proyectos resuelve el ID solo cuando exactamente otro proyecto contiene una transcripción con mensajes para él, de modo que un duplicado copiado manualmente hace que Claude Code informe que no se encontró en lugar de reanudar una copia arbitraria".
La versión importa aquí. La referencia de errores señala: "Antes de la v2.1.223, la búsqueda se detenía en el directorio del proyecto actual y sus git worktrees, así que reanuda desde el directorio en el que trabajó la sesión por última vez". En una versión antigua, ejecutar el comando desde una carpeta diferente es suficiente para producir el error.
Causa 1: El ID es incorrecto
La causa más simple es un ID mal escrito o equivocado. Para las sesiones que iniciaste de forma interactiva, el ID se muestra en Claude Code. Para ejecuciones no interactivas, Anthropic dice que "el ID es el campo session_id de la salida de --output-format json".
Dos detalles hacen que sea fácil equivocarse con los IDs:
- Los nombres para mostrar no son IDs. Las sesiones a las que no asignas nombre reciben un nombre para mostrar predeterminado, como el nombre de una carpeta con un sufijo corto. Anthropic dice: "El valor predeterminado no es un identificador de reanudación. Si lo pasas a
claude --resumeo/resume, Claude Code no encuentra la sesión". - Los títulos generados funcionan, pero solo como nombres. "Solo el título generado funciona como identificador de reanudación". Reanudar por nombre resuelve en el repositorio actual y sus worktrees, no en todos los proyectos de la máquina.
Causa 2: La transcripción se eliminó después de 30 días
Esta causa es fácil de pasar por alto porque la limpieza es silenciosa. La referencia de errores lo enumera claramente: "Claude Code elimina las transcripciones después del período de retención, 30 días por defecto, siguiendo las reglas de barrido de retención".
El ajuste que lo controla es cleanupPeriodDays. La referencia de configuración de Anthropic describe lo que hace: Claude Code conserva "transcripciones de sesiones y otros datos de la aplicación" durante esa cantidad de días, y "El barrido elimina las transcripciones sin mostrar un mensaje". Su valor predeterminado es 30 y el mínimo es 1.
Por lo tanto, una sesión que tocaste por última vez hace más de un mes puede simplemente haber desaparecido. No hay ningún mensaje cuando sucede, por lo que este error puede ser la primera señal.
Dos puntos relacionados:
- Las sesiones de Desktop y Cowork se manejan de manera diferente. Por defecto, Claude Code conserva las transcripciones de las sesiones que iniciaste o continuaste más recientemente en Claude Desktop o Cowork más allá de este período, y un ajuste separado,
desktopSessionCleanupPeriodDays, puede asignarles un límite de antigüedad. - Puedes conservar las transcripciones por más tiempo. Establecer
0falla la validación, por lo que Anthropic sugiere "un valor grande como3650para una retención prolongada".
Aumentar el valor solo protege las transcripciones que aún existen. Una vez que el barrido ha eliminado una, el cambio no la recupera.
Causa 3: La sesión se ejecutó en otra máquina
Las transcripciones no se sincronizan. La referencia de errores dice: "Claude Code almacena las transcripciones localmente, así que reanuda la sesión en la máquina donde se ejecutó".
Si iniciaste una sesión en una laptop de trabajo e intentas reanudarla en una de escritorio, no habrá nada que encontrar. La solución es reanudarla donde se ejecutó. Si mueves el trabajo regularmente entre máquinas, nuestra guía sobre cómo encontrar, reanudar y eliminar el historial de sesiones de Claude Code cubre dónde vive el historial en cada una.
Causa 4: Dos copias tienen el mismo ID
Si copiaste una carpeta de proyecto bajo ~/.claude/projects, dos transcripciones pueden terminar con el mismo ID. Anthropic dice que en este caso "Claude Code informa este mensaje en lugar de reanudar una copia arbitrariamente".
La solución es eliminar o renombrar la copia duplicada para que solo una transcripción tenga ese ID, y luego reanudar de nuevo.
Sesiones que nunca aparecen en el selector
Algunas sesiones se omiten del selector de sesiones por diseño, lo que puede hacer que parezca que faltan:
- Sesiones de
-py del Agent SDK. "Claude Code deja las sesiones creadas conclaude -po el Agent SDK fuera del selector de sesiones y fuera declaude --continue". Aún puedes reanudar una pasando su ID de sesión. - Sesiones de
/loop. Las sesiones cuyo primer prompt fue un comando/loopno aparecen en el selector, yclaude --continuetambién las omite. - Sesiones en segundo plano en ejecución.
claude --continueabre una sesión en segundo plano finalizada, pero no una que aún se esté ejecutando. En ese caso, Claude Code sale y te indica que la sesión se está ejecutando en segundo plano, junto con su ID.
Para las ejecuciones de -p y SDK, el consejo de la referencia de errores es "volver a verificar el ID con el session_id que imprimió tu ejecución original".
Cómo buscar en cada proyecto de esta máquina
Para una sesión interactiva, el selector de sesiones puede buscar más allá de la carpeta actual. La documentación de sesiones de Anthropic explica lo que muestra por defecto: sesiones del worktree actual, incluidas las sesiones en segundo plano, y sesiones que agregaron el directorio actual con /add-dir.
Para ampliarlo:
- "Usa
Ctrl+Wpara ampliar a todos los worktrees del repositorio oCtrl+Apara ampliar a cada proyecto en esta máquina".
Por lo tanto, la solución documentada para el error, para una sesión interactiva, es "abrir el selector de sesiones con claude --resume y presionar Ctrl+A para ampliarlo a cada proyecto en esta máquina, luego seleccionar la sesión".
Cuando eliges una sesión de un proyecto no relacionado, Claude Code no la mueve. En su lugar, "copia un comando cd y de reanudación en tu portapapeles". Si el directorio de ese proyecto ya no existe, reanuda la sesión en tu directorio actual.
Mensajes similares que significan otra cosa
Algunos errores cercanos parecen similares pero tienen causas diferentes.
Error al reanudar la conversación. Esto significa que Claude Code encontró la sesión pero "no pudo leer o procesar la transcripción guardada". Sale en lugar de continuar en un estado parcialmente cargado, y el mensaje incluye un comando de reintento. Pasos de Anthropic: reintentar con el ID de sesión; en una versión anterior a la v2.1.285, actualizar y reanudar de nuevo, ya que "Esas versiones fallan la reanudación cuando la transcripción guardada contiene una entrada que no pueden leer"; y si sigue fallando, iniciar una nueva sesión.
La conversación guardada ya no está en el disco. Este es para sesiones en segundo plano. Aparece cuando una sesión "terminó mientras el servicio en segundo plano estaba apagado, y la limpieza de transcripciones ha eliminado desde entonces su conversación guardada, por ejemplo, después de que la máquina estuvo apagada durante semanas". Claude Code se niega en lugar de volver a ejecutar el prompt original de la sesión. Puedes eliminar la fila con claude rm, o ejecutar el prompt original de nuevo como una conversación fresca con claude respawn.
La sesión no tiene transcripción guardada. Esto aparece cuando te conectas a una sesión que moviste al segundo plano y que "se detuvo antes de ejecutar un turno propio". Si se pasó al segundo plano desde otra conversación, Anthropic señala que esa conversación sigue intacta.
Qué contiene una transcripción y qué no
Cuando la reanudación funciona, recuperas la conversación. Una transcripción incluye "mensajes, llamadas a herramientas y resultados de herramientas", según la referencia de directorios de Anthropic. Por eso perder una duele: es el registro de trabajo completo de una sesión. Para ver más de cerca qué contiene, consulta nuestra guía sobre qué muestra la vista de transcripción en Claude Code.
Pero una transcripción es un archivo en una máquina, con una vida útil predeterminada de 30 días. Las partes de una sesión que importan más allá de esa sesión, como la decisión a la que llegaste, el enfoque que rechazaste o la causa de un error que rastreaste, solo están seguras si también se escriben en otro lugar.
Lo que la gente intenta primero
Pegar el nombre para mostrar. El nombre para mostrar predeterminado no es un identificador de reanudación.
Ejecutar el comando desde una carpeta diferente en una versión antigua. Antes de la v2.1.223, la búsqueda no exploraba otros proyectos.
Buscar una sesión de hace un mes. Las transcripciones se eliminan después de 30 días por defecto, sin previo aviso.
Reanudar en una máquina diferente. Las transcripciones se almacenan localmente.
Copiar la carpeta del proyecto como respaldo. Los IDs duplicados hacen que Claude Code informe que no se encontró.
La solución: Encontrar la sesión o recuperar lo que importaba
Paso 1: Verificar el ID
Usa el ID que mostró Claude Code, o el session_id de la salida JSON de una ejecución con -p, no el nombre para mostrar.
Paso 2: Ampliar el selector
Ejecuta claude --resume y presiona Ctrl+A para buscar en cada proyecto de esta máquina.
Paso 3: Verificar la máquina y la antigüedad
Reanuda en la máquina donde se ejecutó la sesión. Si es más antigua que tu cleanupPeriodDays, asume que la transcripción ha desaparecido.
Paso 4: Aumentar la retención si necesitas sesiones más antiguas
Establece cleanupPeriodDays en un número mayor en tu configuración para conservar las futuras transcripciones por más tiempo.
Paso 5: Escribe lo que no puedes permitirte perder
Después de una sesión importante, registra las decisiones y hallazgos fuera de la transcripción.
Configurando esto en MemoryLake
Una transcripción es el registro completo de una sesión, guardado en una máquina durante 30 días por defecto. Las pocas cosas de ella que necesitarás el próximo mes, como una decisión, una causa raíz o una convención acordada, valen la pena escribirse en algún lugar que no caduque.
MemoryLake es una capa de memoria para ese tipo de contexto de proyecto, como decisiones, hallazgos y convenciones, mantenida en un solo lugar y disponible para los asistentes que conectes, como ChatGPT, Claude Code y Codex.
Tú mismo escribes las entradas, con tus propias palabras. No se lee nada, ni se escribe ni se borra de tus transcripciones de sesión, tu carpeta ~/.claude, tu selector de sesiones, tus archivos CLAUDE.md, tu memoria automática o el almacenamiento de cualquier proveedor. La reanudación, retención y limpieza funcionan de la manera que Anthropic describe.
Paso 1: Crear una clave API
Inicia sesión y genera una clave desde el panel de control. Guárdala fuera de tus repositorios, como cualquier otra credencial.

Paso 2: Sube tus primeras memorias
Comienza con lo que escribiste en el Paso 5 de la solución: las decisiones, causas raíces y convenciones de las sesiones que importaron. Un elemento por entrada.

Paso 3: Conecta tu IA y agentes
Conecta Claude Code y cualquier otro asistente que uses. Una nueva sesión, en cualquier máquina, puede recurrir a las mismas entradas.

Qué cambia esto en la práctica
La primera diferencia es que depende menos de una reanudación. Si una transcripción desaparece, las conclusiones no.
La segunda es el mismo contexto en cada máquina. Las entradas no están ligadas a la carpeta donde se ejecutó una sesión.
La tercera es que no hay carrera contra la retención. Lo que escribiste no depende de cleanupPeriodDays.
Mejores prácticas para reanudar sesiones de Claude Code
Nombra las sesiones importantes. Usa claude -n o /rename, y reanuda por nombre.
Guarda el ID de sesión real. Los nombres para mostrar no funcionan como identificadores de reanudación.
Usa Ctrl+A en el selector. Busca en cada proyecto de la máquina.
Conoce tu retención. Las transcripciones se eliminan después de 30 días por defecto.
No dupliques carpetas de proyectos. Dos copias con un mismo ID hacen que la reanudación informe que no se encontró.
Actualiza antes de reintentar una reanudación fallida. Las versiones antiguas fallan con entradas que no pueden leer.
Escribe el resultado. La transcripción no es el único registro que deberías tener.
Conclusión
Claude Code muestra el error de no se encontró ninguna conversación cuando pasas un ID de sesión a claude --resume y ninguna transcripción guardada coincide con él. Busca primero en el proyecto actual, luego en todos los demás proyectos de la máquina, en la v2.1.223 y posteriores. Las causas documentadas son un ID mal escrito, una transcripción eliminada tras la retención predeterminada de 30 días, una sesión que se ejecutó en otra máquina y copias duplicadas con el mismo ID.
Para recuperar, verifica el ID, abre el selector con claude --resume y presiona Ctrl+A, y reanuda en la máquina donde se ejecutó la sesión. Si la transcripción caducó, ha desaparecido, así que aumenta cleanupPeriodDays para el futuro y mantén las decisiones de las sesiones importantes escritas fuera de la transcripción.