Cap 16: Checkpointing y Sesiones

Por: Artiko
claude-codecheckpointingsesionesrewindteleport

Checkpointing automático

Claude Code realiza tracking automático de cambios basado en git. Cada vez que Claude edita archivos, se crea un checkpoint interno que permite retroceder a estados anteriores.

Rewind — Retroceder cambios

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

/rewind

Al ejecutar /rewind:

  1. Se muestra una lista de checkpoints disponibles
  2. Seleccionas el punto al que quieres retroceder
  3. Claude revierte los cambios de código a ese estado
  4. La conversación se recorta al punto seleccionado

Esc Esc (doble escape)

Presionar Esc dos veces rápidamente es un atajo para /rewind — retrocede el último cambio de Claude.

Cuándo usar rewind

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:

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

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