Gestionar sesiones

Nombre, reanude, ramifique y cambie entre conversaciones de Claude Code. Cubre --continue, --resume, --from-pr, el selector /resume, nombres de sesión y dónde se almacenan las transcripciones.

Una sesión es una conversación guardada vinculada a un directorio de proyecto. Claude Code la almacena localmente mientras trabaja, para que pueda reanudar donde lo dejó, ramificarse para probar un enfoque diferente o cambiar entre tareas.

La aplicación de escritorio, Claude Code en la web y la extensión de VS Code mantienen cada una su propio historial de sesiones. Esta página cubre la CLI:

• Reanude una conversación anterior por bandera, nombre o PR
• Nombre sesiones para que pueda encontrarlas más tarde
• Explore sesiones con el selector /resume
• Ramifique una conversación para probar un enfoque diferente
• Exporte transcripciones y encuéntrelas en el disco

Reanude una sesión

Las sesiones se guardan continuamente en archivos de transcripción locales mientras trabaja, para que pueda volver a una después de salir o ejecutar /clear. Use estos puntos de entrada:

Las sesiones creadas con claude -p o el Agent SDK no aparecen en el selector de sesiones, pero aún puede reanudar una pasando su ID de sesión a claude --resume <session-id>. Ejecute esto desde el directorio en el que se inició la sesión: la búsqueda de ID de sesión se limita al directorio del proyecto actual y sus git worktrees, por lo que una sesión creada en otro lugar reporta No conversation found with session ID: <session-id>.

Dónde busca el selector de sesiones

Las sesiones se almacenan por directorio de proyecto. De forma predeterminada, el selector de sesiones muestra sesiones interactivas del worktree actual, más sesiones iniciadas en otro lugar que agregaron el directorio actual con /add-dir. {/* min-version: 2.1.169 */}A partir de v2.1.169, mover una sesión con /cd la traslada al almacenamiento del proyecto del nuevo directorio, por lo que aparece en el selector de ese directorio después. Use Ctrl+W para ampliar a todos los worktrees del repositorio o Ctrl+A para ampliar a cada proyecto en esta máquina.

Seleccionar una sesión de otro worktree del mismo repositorio la reanuda en su lugar. Seleccionar una sesión de un proyecto no relacionado copia un comando cd y reanuda a su portapapeles en su lugar.

Reanudar por nombre se resuelve en el repositorio actual y sus worktrees. Ambas formas buscan una coincidencia exacta y la reanudan directamente incluso si vive en un worktree diferente:

Nombre sus sesiones

Dé a las sesiones nombres descriptivos para que sean encontrables en el selector de sesiones y reanudables por nombre. Esto es más importante cuando está trabajando en varias tareas en paralelo.

Una vez que una sesión está nombrada, vuelva a ella con claude --resume <name> o /resume <name>. Vea Reanude una sesión para saber cómo se comporta la resolución de nombres en worktrees.

Usar el selector de sesiones

Ejecute /resume dentro de una sesión, o claude --resume sin argumentos, para abrir el selector de sesiones interactivo. Use estos atajos de teclado para navegar, buscar y ampliar la lista:

Cada fila muestra el nombre de la sesión si está establecido, de lo contrario el resumen de la conversación o el primer indicador, junto con el tiempo desde la última actividad, el recuento de mensajes y la rama git. La ruta del proyecto aparece después de ampliar a todos los proyectos con Ctrl+A.

Las sesiones bifurcadas creadas con /branch, /rewind o --fork-session se agrupan bajo su sesión raíz. Presione → para expandir un grupo.

Ramifique una sesión

La ramificación crea una copia de la conversación hasta ahora y lo cambia a ella, dejando el original intacto. Úselo para probar un enfoque diferente sin perder el camino en el que estaba.

Desde dentro de una sesión, ejecute /branch con un nombre opcional:

/branch try-streaming-approach

Desde la línea de comandos, combine --continue o --resume con --fork-session:

claude --continue --fork-session

La sesión original no se modifica y permanece disponible en el selector de sesiones. La confirmación de /branch imprime dos IDs de sesión: la nueva rama en la que se encuentra ahora y la original. Para volver a la original, pase su ID a /resume, use el selector de sesiones o ejecute /resume <original-name>. Los permisos que aprobó con "permitir para esta sesión" no se transfieren a la nueva rama. Si reanuda la misma sesión en dos terminales sin bifurcar, los mensajes de ambos se intercalan en una transcripción.

Para rewind basado en puntos de control dentro de una sola sesión, vea Checkpointing.

Gestione el contexto dentro de una sesión

Estos comandos controlan qué hay en la ventana de contexto sin dejar la sesión:

• /clear: comience de nuevo con un contexto vacío. La conversación anterior se guarda y es reanudable
• /compact [instructions]: reemplace el historial con un resumen, opcionalmente enfocado en lo que especifique
• /context: muestre qué está consumiendo actualmente el contexto

Para saber cómo la compactación interactúa con CLAUDE.md, skills y reglas, vea la guía de ventana de contexto. Para estrategias sobre cuándo limpiar versus compactar, vea Mejores prácticas.

Exporte y localice datos de sesión

Ejecute /export para copiar la conversación actual a su portapapeles o guardarla como un archivo de texto sin formato, con mensajes y salidas de herramientas renderizadas como texto legible. Pase un nombre de archivo para escribir directamente en ese archivo.

Las transcripciones se almacenan como JSONL en ~/.claude/projects/<project>/<session-id>.jsonl, donde <project> se deriva de la ruta de su directorio de trabajo. Cada línea es un objeto JSON para un mensaje, uso de herramienta o entrada de metadatos. Para almacenar sesiones en algún lugar que no sea ~/.claude, establezca CLAUDE_CONFIG_DIR. Estos archivos locales se eliminan después de 30 días de forma predeterminada; cambie esto con cleanupPeriodDays.

Para suprimir completamente las escrituras de transcripción, establezca CLAUDE_CODE_SKIP_PROMPT_HISTORY, o en modo no interactivo use --no-session-persistence.

Ver también

Estas páginas cubren mecánicas relacionadas de sesión y paralelismo:

• Worktrees: ejecute sesiones paralelas aisladas en ramas separadas
• Checkpointing: rebobine código y conversación a un punto anterior
• Ventana de contexto: qué llena el contexto y qué sobrevive a la compactación
• Modo no interactivo: comportamiento de sesión bajo claude -p