Cómo reanudar una sesión de Claude Code

Si cerraste la terminal, se cortó la conexión o simplemente saliste de Claude Code a mitad de una tarea, no hace falta volver a explicar todo el proyecto desde cero. Claude Code guarda cada sesión de forma local y ofrece varios comandos para retomarla exactamente donde la dejaste. Esta guía muestra cuál usar según tu situación, con ejemplos concretos y verificaciones antes de escribir el comando.

Qué es una sesión de Claude Code y por qué se interrumpe

Una sesión de Claude Code es una conversación guardada que queda asociada al directorio del proyecto en el que trabajas. Claude Code la almacena de forma local y continua a medida que avanzas, por lo que el historial no depende de mantener la terminal abierta. Las interrupciones más habituales son cerrar la terminal por error, alcanzar un límite de uso, ejecutar /clear sin querer, o simplemente cerrar el portátil entre una jornada de trabajo y la siguiente.

Esto significa que, salvo que el archivo de transcripción se elimine manualmente, la conversación sigue disponible para reanudarse más tarde, incluso después de reiniciar el equipo.

Verificaciones previas antes de reanudar una sesión

Antes de escribir cualquier comando, conviene confirmar tres cosas para evitar el error más frecuente al reanudar:

• Estás en el mismo directorio de proyecto donde se inició la sesión original, incluyendo si trabajas en un worktree de git distinto.
• Sabes si la sesión se creó en modo interactivo, en modo headless con -p, o mediante el Agent SDK, porque cambia el comando de reanudación.
• Si no recuerdas el ID ni el nombre de la sesión, es mejor abrir el selector interactivo en lugar de intentar adivinar un comando con –continue.

Cómo reanudar la sesión más reciente con –continue

Comando:

claude –continue

Cuándo usarlo: es la opción más rápida cuando solo quieres seguir exactamente donde lo dejaste en el directorio actual y no necesitas elegir entre varias conversaciones guardadas.

Límite: solo busca dentro del directorio de proyecto actual. Si la última sesión relevante se creó en otra carpeta, este comando no la encontrará.

Cómo reanudar una sesión específica con –resume

Comando:

claude –resume nombre-de-sesion

Cuándo usarlo: cuando ya identificaste la sesión por su nombre o por su ID y quieres ir directamente a ella sin pasar por un menú.

Límite: la búsqueda por ID está restringida al directorio de proyecto donde se creó la sesión. Ejecutarlo desde otra ruta de disco puede devolver el mensaje «No conversation found with session ID», incluso si el ID es correcto.

Cómo usar el selector interactivo de sesiones (/resume)

Comando:

claude –resume

También puede invocarse como /resume desde dentro de una sesión activa para cambiar a otra conversación sin cerrar Claude Code.

Cuándo usarlo: cuando tienes varias sesiones guardadas en el mismo proyecto y no recuerdas el nombre exacto de la que necesitas; el selector muestra las sesiones interactivas del directorio actual y de sus worktrees de git.

Límite: las sesiones creadas con -p o con el Agent SDK no aparecen en este selector.

Cómo nombrar y renombrar sesiones para encontrarlas más rápido

Comando (dentro de una sesión activa):

/rename nombre-descriptivo

Cuándo usarlo: en cualquier sesión que sepas que vas a retomar más adelante, especialmente si trabajas en varias tareas paralelas en el mismo proyecto. Un nombre como «refactor-autenticacion» es mucho más fácil de recordar que un ID largo.

Una vez asignado, el nombre se usa directamente con claude –resume nombre-descriptivo en lugar del ID.

Cómo reanudar sesiones creadas en modo headless (-p) o con el Agent SDK

Comando:

claude –resume id-de-sesion

Cuándo usarlo: cuando la sesión se generó mediante un flujo automatizado, un script en modo -p, o una integración con el Agent SDK. Estas sesiones no se listan en el selector interactivo, pero siguen existiendo y pueden reanudarse indicando su ID directamente.

Requisito: este comando debe ejecutarse desde el mismo directorio de proyecto en el que se generó la sesión original, por la misma restricción de búsqueda por directorio explicada antes.

Cómo reanudar la sesión vinculada a una pull request

Comando:

claude –from-pr numero-de-pr

Cuándo usarlo: cuando el trabajo se organizó alrededor de una pull request concreta y quieres retomar exactamente la conversación asociada a esa revisión, sin buscar manualmente el nombre o el ID de la sesión.

Método	Cuándo usarlo	Alcance
claude –continue	Retomar la última sesión sin pensar en nombres ni ID	Directorio de proyecto actual
claude –resume	Elegir entre varias sesiones guardadas mediante un menú	Directorio actual y sus worktrees de git
claude –resume nombre/ID	Ir directo a una sesión ya identificada	Debe ejecutarse desde el directorio original
/resume (dentro de sesión)	Cambiar de conversación sin cerrar Claude Code	Sesión activa
claude –from-pr	Retomar la sesión ligada a una pull request	Directorio del proyecto correspondiente

Comparativa de métodos para reanudar una sesión

La tabla anterior resume los cinco puntos de entrada disponibles. En la práctica, la mayoría de interrupciones diarias se resuelven con claude –continue; el selector interactivo entra en juego cuando trabajas en varias tareas a la vez dentro del mismo proyecto, y las variantes por ID o por pull request cubren flujos más específicos como automatizaciones o revisiones de código.

Problemas comunes al reanudar sesiones y cómo resolverlos

• Error «No conversation found with session ID»: ocurre porque la búsqueda por ID está limitada al directorio de proyecto donde se creó la sesión. Solución: vuelve a la carpeta original antes de ejecutar claude –resume id-de-sesion.
• claude –continue no encuentra una sesión que reanudaste antes con el selector interactivo: se ha reportado como un caso puntual en el que el registro interno usado por –continue no se actualiza tras una reanudación por selector. Solución: usa claude –resume nombre-de-sesion o el selector interactivo en lugar de –continue en ese caso.
• Una sesión creada con -p o el Agent SDK no aparece al abrir el selector: es un comportamiento esperado, no un error. Solución: reanúdala pasando su ID directamente con claude –resume id-de-sesion desde el directorio donde se generó.

Preguntas frecuentes sobre reanudar sesiones en Claude Code

¿–continue y –resume hacen lo mismo? No. –continue retoma automáticamente la última sesión del directorio actual sin preguntar nada, mientras que –resume permite elegir entre varias sesiones guardadas o apuntar a una en concreto por nombre o ID.

¿Puedo reanudar una sesión desde otra carpeta distinta a la original? No de forma directa: la búsqueda por ID está restringida al directorio de proyecto donde se creó la sesión, y hacerlo desde otra ruta puede devolver un error de «sesión no encontrada».

¿Cómo le pongo nombre a una sesión para encontrarla después? Ejecuta /rename seguido de un nombre descriptivo mientras la sesión está activa; después podrás usar ese nombre con claude –resume.

¿Qué pasa si la sesión se creó con el modo -p o el Agent SDK? No aparecerá en el selector interactivo, pero sigue siendo recuperable indicando su ID de sesión directamente con claude –resume, desde el directorio original.

¿Dónde se guardan las sesiones? Se almacenan de forma local en archivos de transcripción vinculados al directorio del proyecto, y se actualizan de forma continua mientras trabajas.

Únete a nuestra comunidad