Gestión de sesiones

Cómo se almacenan las sesiones

Cada vez que se inicia Claude Code con el comando claude, se crea una nueva sesión que recibe un identificador único (UUID). Las sesiones se almacenan localmente en el directorio ~/.claude/ del sistema y contienen el historial completo de la conversación: los mensajes del usuario, las respuestas del agente, las herramientas utilizadas y sus resultados.

Las sesiones están vinculadas al directorio de trabajo desde el que se iniciaron. Cuando se usa el flag -c para continuar la sesión más reciente, Claude Code busca la última sesión asociada al directorio actual. Las sesiones iniciadas desde directorios diferentes se gestionan de forma independiente.

Las sesiones se almacenan localmente en ~/.claude/ y están asociadas al directorio de trabajo. El historial de la conversación persiste entre ejecuciones, permitiendo retomar el trabajo donde se dejó.

Este modelo de almacenamiento local significa que las sesiones no se sincronizan entre máquinas. Si trabajas en varios equipos, cada uno tendrá su propio historial de sesiones.

Continuar la sesión más reciente

El flag -c (o --continue) es la forma más rápida de retomar el trabajo. Carga la última conversación asociada al directorio actual y la continúa exactamente donde se dejó:

claude -c

Al ejecutar este comando, Claude Code restaura el historial completo de la sesión anterior. El agente tiene acceso a todo lo que se discutió, los archivos que leyó y los cambios que realizó. Esto permite hacer preguntas de seguimiento o pedir ajustes sobre el trabajo previo sin necesidad de repetir el contexto.

También se puede combinar con un mensaje inicial para continuar la sesión con una instrucción directa:

claude -c "ahora añade tests para los cambios que hicimos"

O con el flag -p para hacer una consulta puntual sobre la conversación anterior sin abrir una sesión interactiva:

claude -c -p "resume lo que hicimos en la sesión anterior"

La continuación con -c es especialmente útil en el flujo de trabajo diario. Al cerrar la terminal al final del día y volver al día siguiente, un simple claude -c recupera el contexto completo de la última sesión de ese proyecto.

Reanudar sesiones por nombre o ID

El flag -r (o --resume) permite reanudar una sesión específica, independientemente de si es la más reciente o no. Acepta tanto el nombre de la sesión como su ID:

claude -r "refactorizacion-auth"

claude -r abc123-def456

Si se ejecuta -r sin argumento, Claude Code abre un selector interactivo que muestra las sesiones disponibles. El selector presenta las sesiones con su nombre, fecha de creación y un fragmento del último mensaje, facilitando la identificación de la sesión deseada:

claude -r

Al igual que -c, se puede combinar con un mensaje adicional que se añade a la conversación al reanudarla:

claude -r "migración-base-datos" "continúa con la tabla de pedidos"

flowchart TB
    A["claude -c"] --> B["Carga la sesión más reciente del directorio actual"]
    C["claude -r nombre"] --> D["Carga la sesión con ese nombre o ID"]
    E["claude -r"] --> F["Abre selector interactivo de sesiones"]
    B --> G["Sesión restaurada"]
    D --> G
    F --> G

La diferencia entre -c y -r radica en el alcance. -c siempre toma la sesión más reciente del directorio de trabajo, mientras que -r permite acceder a cualquier sesión almacenada en el sistema, independientemente del directorio o del momento en que se creó.

Renombrar sesiones

Por defecto, las sesiones se identifican por un UUID que no aporta contexto sobre su contenido. El comando /rename permite asignar un nombre descriptivo que facilite su identificación posterior:

/rename migración-base-datos

Si se ejecuta /rename sin argumento, Claude Code genera automáticamente un nombre basado en el historial de la conversación:

/rename

Los nombres asignados son los que se utilizan después con el flag -r para reanudar sesiones específicas. Nombrar las sesiones de forma consistente se convierte en una práctica valiosa cuando se trabaja en múltiples tareas simultáneamente o cuando se necesita volver a una sesión creada hace días.

Renombrar sesiones con /rename facilita la organización del trabajo. Un nombre como "refactor-auth-v2" es mucho más localizable que un UUID aleatorio al usar claude -r.

Bifurcar conversaciones

El comando /fork crea una copia de la conversación actual en un punto determinado, generando una nueva sesión independiente. La sesión original permanece intacta y la bifurcación parte con todo el historial acumulado hasta ese momento.

/fork exploración-alternativa

Este mecanismo es útil para explorar enfoques alternativos sin comprometer el progreso de la sesión principal. Por ejemplo, si Claude ha implementado una funcionalidad y se quiere probar una arquitectura diferente:

• 1. Se ejecuta /fork alternativa-con-eventos en la sesión actual.
• 2. Se experimenta con el enfoque alternativo en la sesión bifurcada.
• 3. Se vuelve a la sesión original con claude -r "nombre-sesion-original" si el enfoque alternativo no funciona.

También se puede bifurcar al reanudar una sesión desde la terminal con el flag --fork-session:

claude -r "auth-refactor" --fork-session

Esto crea una nueva sesión con el historial de auth-refactor pero con un ID diferente, preservando la sesión original sin modificaciones.

Rebobinar con checkpoints

Claude Code crea automáticamente checkpoints antes de cada edición de archivo. Estos checkpoints permiten volver a un estado anterior tanto del código como de la conversación.

El atajo Esc + Esc (pulsar Escape dos veces) o el comando /rewind abre un selector de puntos de la conversación. Para cada punto se puede elegir entre varias acciones:

• Restaurar código: deshace los cambios del agente en los archivos, volviendo al estado previo a ese punto.
• Restaurar conversación: retrocede la conversación hasta ese mensaje, eliminando los turnos posteriores del historial.
• Resumir: comprime los turnos seleccionados en un resumen, liberando espacio en la ventana de contexto sin perder la información clave.

flowchart TB
    A["Sesión en curso"] --> B["Esc + Esc o /rewind"]
    B --> C["Selector de checkpoints"]
    C --> D["Restaurar código"]
    C --> E["Restaurar conversación"]
    C --> F["Resumir desde este punto"]

Los checkpoints persisten entre sesiones reanudadas. Si se reanuda una sesión con -r o -c, los checkpoints de la sesión original siguen disponibles para rebobinar.

Los checkpoints son una red de seguridad automática. Si Claude aplica un cambio que no funciona, Esc + Esc permite rebobinar al estado anterior sin necesidad de deshacer manualmente las ediciones.

Exportar conversaciones

El comando /export guarda el contenido de la conversación actual como un archivo de texto plano. Se puede especificar un nombre de archivo directamente o usar el diálogo interactivo:

/export sesion-auth-refactor.txt

Sin argumento, Claude Code ofrece la opción de copiar al portapapeles o guardar en un archivo:

/export

La exportación incluye los mensajes del usuario, las respuestas de Claude y las acciones realizadas, formateadas como texto legible. Es útil para:

• Documentar decisiones técnicas tomadas durante una sesión.
• Compartir con compañeros de equipo el razonamiento detrás de un cambio.
• Archivar sesiones relevantes fuera del almacenamiento local de Claude Code.

Limpiar y organizar

El comando /clear limpia el historial de la conversación actual y libera espacio en la ventana de contexto. La sesión previa se preserva y puede reanudarse. Al usar /clear, se inicia efectivamente una nueva conversación dentro de la misma sesión de terminal.

/clear

Los alias /reset y /new realizan la misma acción.

Sesiones vinculadas a pull requests

El flag --from-pr permite reanudar sesiones asociadas a un pull request específico de GitHub. Las sesiones se vinculan automáticamente al PR cuando se crean durante un flujo de gh pr create:

claude --from-pr 142

claude --from-pr https://github.com/org/repo/pull/142

Esta funcionalidad permite que varios desarrolladores del equipo retomen el trabajo sobre un PR específico accediendo a la sesión de Claude que lo creó o que trabajó sobre él.

Flujo de trabajo con sesiones

Un flujo de trabajo típico que aprovecha la gestión de sesiones combina varios de los mecanismos vistos:

• 1. Iniciar una sesión para una tarea concreta: claude "implementa el endpoint de login".
• 2. Renombrar la sesión: /rename login-endpoint.
• 3. Trabajar en la tarea a lo largo de varios turnos de conversación.
• 4. Cerrar la sesión al final del día con Ctrl+D o exit.
• 5. Al día siguiente, retomar exactamente donde se dejó: claude -r "login-endpoint".
• 6. Si se quiere probar un enfoque alternativo: /fork login-endpoint-jwt.
• 7. Si el enfoque alternativo no funciona, volver a la sesión original: claude -r "login-endpoint".
• 8. Exportar la sesión terminada como documentación: /export login-endpoint-sesion.txt.

Este flujo transforma las sesiones de Claude Code en un registro de trabajo que refleja el razonamiento, las decisiones y los cambios aplicados durante el desarrollo de cada funcionalidad.