Cap 16: Checkpointing y Sesiones

Checkpointing automático

Claude Code guarda un snapshot antes de cada prompt del usuario. No es tracking basado en git ni se dispara con cada edición de archivo: el punto de corte es el prompt.

Retención

• Se conservan los 100 checkpoints más recientes por sesión.
• Se limpian junto con las sesiones a los 30 días, según cleanupPeriodDays.

Qué NO cubre

El checkpointing solo cubre las ediciones hechas con las herramientas de edición. No se restauran:

• Los cambios producidos por comandos bash.
• Los cambios externos (otro editor, otro proceso, otra sesión).
• Las rutas symlink y hardlink.

flowchart TD
    P[Prompt del usuario] --> S[Snapshot del estado]
    S --> T[Claude trabaja en el turno]
    T --> E[Ediciones con herramientas de edición]
    T --> B[Comandos bash / cambios externos]
    E --> R[Restaurables con /rewind]
    B --> N[NO restaurables]

Rewind — Retroceder cambios

El comando /rewind permite retroceder en la conversación y/o en los cambios de código:

/rewind

Al ejecutar /rewind se muestra la lista de checkpoints disponibles. Tras elegir el punto, el menú ofrece cinco acciones distintas:

Acción	Qué hace
Restore code and conversation	Restaura el código y recorta la conversación
Restore conversation	Recorta solo la conversación, deja el código como está
Restore code	Restaura solo el código, conserva la conversación
Summarize from here	Resume desde ese punto en adelante
Summarize up to here	Resume hasta ese punto (disponible desde la semana 20, mayo 2026)

Las dos acciones de resumen aceptan instrucciones inline para guiar qué debe conservar el resumen.

Rewind después de un /clear

Desde v2.1.191, /rewind puede reanudar la conversación anterior a un /clear ejecutado en el mismo proceso. Aparece como /resume <session-id> (previous session) al inicio de la lista.

Esc Esc (doble escape)

Presionar Esc dos veces con el input vacío abre el mismo menú de /rewind, con sus cinco acciones. No revierte nada por sí solo: sigue siendo necesario elegir checkpoint y acción.

Cuándo usar rewind

• Claude tomó una dirección equivocada
• Un cambio introdujo un bug
• Quieres probar un enfoque diferente
• La respuesta de Claude fue demasiado extensa

Ten presente la limitación de cobertura: si el turno tocó archivos vía comandos bash, o hubo cambios externos, o rutas symlink/hardlink, /rewind no los deshace. No conviene confiar en él como si fuera un git reset.

Resume — Retomar sesiones

Continuar la más reciente

# Retomar la última sesión en el directorio actual
claude -c

# Retomar y enviar un prompt
claude -c -p "continúa con los tests"

Retomar sesión específica

# Por ID
claude -r "abc-123-def"

# Por nombre
claude -r "auth-refactor"

# Selector interactivo
claude -r

Nombrar sesiones

Puedes nombrar sesiones para encontrarlas fácilmente:

/rename auth-refactor

Fork — Bifurcar sesión

/fork crea una nueva sesión que hereda todo el contexto de la actual, pero con un ID nuevo:

/fork

Útil para:

• Probar un enfoque alternativo sin perder el progreso
• Ramificar una investigación
• Mantener el contexto pero empezar trabajo nuevo

Fork al reanudar

# Reanudar sesión creando un nuevo ID
claude --resume abc123 --fork-session

Compact — Comprimir contexto

Cuando la conversación crece demasiado, /compact comprime el historial preservando la información relevante:

# Compactar automáticamente
/compact

# Compactar con instrucciones específicas
/compact "conserva los detalles del módulo de auth"

Auto-compactación

Claude Code compacta automáticamente cuando el contexto alcanza cierto umbral. Puedes ajustar el umbral:

# Compactar al 50% del contexto (recomendado)
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=50 claude

Toolkit completo de gestión de contexto

La documentación agrupa checkpointing y rewind dentro de un conjunto más amplio de herramientas para administrar el contexto:

Herramienta	Uso
/clear	Entre tareas no relacionadas
/compact <instrucciones>	Compactación dirigida
Esc	Interrumpe preservando el contexto
Esc+Esc o /rewind	Abre el menú de checkpoints
/btw	Preguntas laterales cuya respuesta no entra al historial

Teleport — Traer sesiones remotas

/teleport permite traer una sesión web (claude.ai/code) a tu terminal local:

/teleport

Flujo de trabajo

1. Inicias una tarea en claude.ai/code desde el móvil
2. La tarea trabaja en tu repo de forma remota
3. Cuando llegas a tu computadora, ejecutas /teleport
4. La sesión continúa localmente con todo el contexto

Desde CLI

claude --teleport

Remote — Sesiones web

Crea una sesión en claude.ai directamente desde el terminal:

# Crear sesión web con una tarea
claude --remote "Fix the login bug"

# Desde dentro de la sesión
/remote

Export

Exporta la conversación actual:

/export         # Copia la conversación al portapapeles
/copy           # Alias de export

Sesiones vinculadas a PRs

Las sesiones se pueden vincular a Pull Requests:

# Reanudar sesiones de un PR específico
claude --from-pr 123

# Las sesiones se vinculan automáticamente al crear PRs con gh

Gestión de sesiones

# Listar sesiones recientes
claude -r    # Selector interactivo

# Deshabilitar persistencia
claude -p --no-session-persistence "tarea temporal"

Almacenamiento

Las sesiones se guardan en ~/.claude/tasks/ (filesystem local, no en la nube).

---

Siguiente: Debugging