Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
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:
| Comando | Qué hace |
|---|
claude --continue | Reanuda la sesión más reciente en el directorio actual |
claude --resume | Abre el selector de sesiones |
claude --resume <name> | Reanuda la sesión nombrada directamente |
claude --from-pr <number> | Reanuda la sesión vinculada a esa solicitud de extracción |
/resume | Cambia a una conversación diferente desde dentro de una sesión activa |
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>.
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. 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:
| Comando | Coincidencia exacta | Nombre ambiguo |
|---|
claude --resume <name> | Reanuda directamente | Abre el selector de sesiones con el nombre rellenado previamente como término de búsqueda |
/resume <name> | Reanuda directamente | Reporta un error; ejecute /resume sin argumentos para abrir el selector de sesiones |
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.
| Cuándo | Cómo establecer el nombre |
|---|
| Al inicio | claude -n auth-refactor |
| Durante una sesión | /rename auth-refactor. El nombre también aparece en la barra de indicaciones |
| Desde el selector de sesiones | Resalte una sesión y presione Ctrl+R |
| Al aceptar un plan | Aceptar un plan en modo de plan nombra la sesión desde el contenido del plan a menos que ya haya establecido uno |
claude --resume <name> o /resume <name>. Vea Reanude una sesión para saber cómo se comporta la resolución de nombres en worktrees.
Use 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:
| Atajo | Acción |
|---|
↑ / ↓ | Navegar entre sesiones |
→ / ← | Expandir o contraer sesiones agrupadas |
Enter | Reanuda la sesión resaltada |
Space | Previsualiza el contenido de la sesión. Ctrl+V también funciona en terminales que no lo capturan como pegado |
Ctrl+R | Renombra la sesión resaltada |
/ o cualquier carácter imprimible que no sea Space | Ingrese al modo de búsqueda y filtre sesiones. Pegue una URL de solicitud de extracción o fusión de GitHub, GitHub Enterprise, GitLab o Bitbucket para encontrar la sesión que la creó |
Ctrl+A | Muestra sesiones de todos los proyectos en esta máquina. Presione nuevamente para volver al repositorio actual |
Ctrl+W | Muestra sesiones de todos los worktrees del repositorio actual. Presione nuevamente para volver al worktree actual. Solo se muestra en repositorios con múltiples worktrees |
Ctrl+B | Filtra a sesiones de la rama git actual. Presione nuevamente para mostrar todas las ramas |
Esc | Salga del selector de sesiones o del modo de búsqueda |
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
--continue o --resume con --fork-session:
claude --continue --fork-session
/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:
