Cómo retomar una sesión anterior en Claude Code

Antes de nada, asegúrate de tener una versión reciente de Claude Code: las opciones para retomar sesiones han ido mejorando y las versiones viejas pueden comportarse distinto. Abre la terminal y ejecuta claude --version. Si te devuelve un número de versión, estás listo; si te dice que el comando no existe, instálalo con el instalador nativo. Ojo: ya no se recomienda instalarlo con npm, el instalador nativo se actualiza solo y evita problemas de permisos. En macOS, Linux o WSL usa el comando curl del bloque de código. En Windows con PowerShell usa el comando irm que verás debajo. Cuando termine, cierra y vuelve a abrir la terminal para que el PATH se refresque, y repite claude --version. La primera vez que ejecutes claude te pedirá iniciar sesión en el navegador con tu cuenta de Claude; hazlo antes de seguir para no interrumpir el tutorial a mitad.

# Comprobar si ya lo tienes
claude --version

# macOS / Linux / WSL: instalador nativo
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell):
# irm https://claude.ai/install.ps1 | iex

# Forzar actualización si ya estaba instalado
claude update

Este es el concepto clave que casi nadie explica: Claude Code guarda el historial de conversaciones asociado a la carpeta desde la que lo abriste. Si ayer trabajaste en ~/proyectos/tienda-online y hoy abres la terminal en tu carpeta de usuario y escribes claude --continue, no vas a encontrar esa conversación, porque estás en otro directorio. Por eso el primer paso para retomar cualquier sesión es navegar con cd a la raíz del proyecto, exactamente la misma carpeta donde arrancaste la sesión original. Si no recuerdas cuál era, piensa dónde estaba tu repositorio (normalmente la carpeta que contiene .git). Si todavía no tienes ninguna sesión previa, crea una de prueba ahora: entra en una carpeta, ejecuta claude, pídele algo sencillo como que te resuma qué archivos hay en el proyecto y sal escribiendo /exit o pulsando Ctrl+C dos veces. Así tendrás algo que retomar en los siguientes pasos.

# Ve a la raíz del proyecto donde trabajaste
cd ~/proyectos/tienda-online

# Comprueba que estás donde crees
pwd

# (Opcional) crea una sesión de prueba
claude
# ...escribe una petición, y luego sal con /exit

El caso más común: cerraste la terminal (o se reinició el ordenador) y quieres seguir justo donde lo dejaste. Para eso existe claude --continue, o su forma corta claude -c. Ejecútalo dentro de la carpeta del proyecto y Claude Code cargará automáticamente la conversación más reciente de ese directorio, con todo el historial de mensajes, los archivos que leyó y los cambios que propuso. Verás los mensajes anteriores en pantalla y podrás escribir directamente tu siguiente petición, por ejemplo: 'Sigamos con el test que estaba fallando'. No necesitas volver a explicar el contexto. También puedes combinarlo con el modo no interactivo -p para lanzar una pregunta rápida sobre la última sesión sin entrar en el chat completo, útil para scripts o para consultar algo puntual.

# Retomar la conversación más reciente de esta carpeta
claude --continue

# Forma corta equivalente
claude -c

# Hacer una consulta rápida sobre la última sesión sin abrir el chat
claude -c -p "Resume en 3 puntos lo que hicimos y qué falta"

Cuando tienes varias conversaciones en el mismo proyecto y quieres una concreta (la del martes sobre la pasarela de pago, no la de hoy sobre CSS), usa claude --resume o claude -r. Sin argumentos, abre un selector interactivo con la lista de sesiones anteriores de esa carpeta, normalmente mostrando cuándo fue, un resumen o el primer mensaje y cuántos mensajes tiene. Muévete con las flechas arriba y abajo del teclado y pulsa Enter para cargar la que quieras. Si ya conoces el identificador de la sesión, puedes pasarlo directamente como argumento y saltarte el selector. Esto es útil si lo apuntaste en un ticket o en las notas de tu equipo. Una vez cargada, la sesión funciona igual que con --continue: todo el historial está disponible y sigues escribiendo con normalidad.

# Abrir el selector de sesiones anteriores
claude --resume

# Forma corta
claude -r

# Retomar directamente una sesión concreta por su ID
claude --resume ID_DE_TU_SESION

Si ya estás dentro de Claude Code y te das cuenta de que querías continuar otra conversación, no hace falta salir y volver a lanzar el comando. Escribe /resume en el prompt y pulsa Enter: se abrirá el mismo selector de sesiones que en el paso anterior, y al elegir una se cargará en lugar de la actual. Tu sesión actual no se borra; queda guardada en el historial y podrás volver a ella más tarde con el mismo método. Aprovecha también para conocer dos comandos relacionados que ayudan a gestionar el contexto: /clear empieza una conversación nueva desde cero (útil cuando cambias de tarea), y /compact resume la conversación actual para liberar espacio de contexto cuando una sesión se ha hecho muy larga. Escribiendo solo / verás la lista de comandos disponibles en tu versión, por si quieres explorar más.

# Dentro de Claude Code, escribe en el prompt:
/resume

# Otros comandos útiles para gestionar el contexto:
/clear     # empieza una conversación nueva
/compact   # resume la conversación actual para ahorrar contexto

Retomar sesiones está genial, pero las conversaciones largas acumulan ruido y no viajan entre ordenadores ni compañeros. Para el contexto que debe sobrevivir siempre (cómo se ejecutan los tests, convenciones del equipo, decisiones de arquitectura), usa un archivo CLAUDE.md en la raíz del proyecto. Claude Code lo lee automáticamente al iniciar cualquier sesión, nueva o retomada. Puedes crearlo a mano o ejecutar /init dentro de Claude Code para que genere una primera versión analizando tu repositorio. La combinación ideal es: CLAUDE.md para lo permanente, --continue y --resume para el hilo de trabajo de los últimos días, y /clear cuando empiezas una tarea distinta. Si trabajas en equipo, sube CLAUDE.md al repositorio con git y todos tendréis el mismo punto de partida aunque cada uno tenga sus propias sesiones.

# Crea un CLAUDE.md básico en la raíz del proyecto
cat > CLAUDE.md << 'EOF'
# Contexto del proyecto
- Stack: Node 20 + React
- Tests: npm test
- Idioma de commits: español

# Estado actual
- Integrando pasarela de pago en /src/checkout
- Pendiente: tests del webhook de confirmación
EOF

# Ahora retoma tu sesión: Claude leerá también CLAUDE.md
claude -c