Checkpoints y Rewind
- Entender qué captura un checkpoint — y qué deja fuera silenciosamente
- Abrir el menú de rewind de dos formas y elegir siempre la acción de restauración correcta
- Distinguir 'restaurar' (deshacer estado) de 'resumir' (comprimir contexto)
- Saber exactamente por qué los checkpoints complementan a Git pero nunca lo reemplazan
La idea principal
Cuando dejas a Claude libre en un cambio ambicioso y de amplia escala, la pregunta que más asusta es "¿y si sale mal a tres ediciones de profundidad?" El checkpointing es la respuesta: Claude Code toma automáticamente una instantánea de tu código antes de cada edición, de modo que puedes rebobinar a cualquier estado anterior en lugar de desenredar a mano un refactor a medio terminar.
Piénsalo como un deshacer local para toda la sesión — una red de seguridad que te permite decir "sí, prueba el enfoque atrevido" sin miedo.
Cómo se crean los checkpoints
Tú no creas los checkpoints — se producen automáticamente.
- Cada prompt del usuario captura el estado de tu código antes de que se ejecuten las herramientas de edición de archivos de Claude. Ningún comando, ninguna configuración, ninguna ceremonia.
- Los checkpoints sobreviven al salir y reanudar una conversación, así que puedes rebobinar en una sesión reanudada, no solo en la activa.
- Los checkpoints se eliminan junto con su sesión al cabo de 30 días (configurable). Son recuperación a nivel de sesión, no un archivo histórico.
Abrir el menú de rewind
Hay dos maneras de entrar:
- Escribe el comando de barra desde el prompt. Siempre funciona.
- El doble Esc abre el menú de rewind cuando la caja del prompt está vacía. Si hay texto en ella, el doble Esc borra ese texto en su lugar (el texto borrado se guarda en el historial de entrada, así que pulsa Arriba para recuperarlo después).
Open the rewind menu
/rewind
El menú lista todos los prompts que enviaste en esta sesión. Elige el punto sobre el que quieres actuar y luego escoge una acción.
Restaurar vs. resumir: la distinción clave
Aquí es donde la gente se confunde. El menú ofrece dos tipos de acción:
- Las acciones de restauración cambian el estado en disco o en la conversación — deshacen.
- Las acciones de resumen nunca tocan tus archivos — comprimen la conversación para liberar espacio en la ventana de contexto.
- Restaurar = deshacer (revierte código, conversación, o ambos). Resumir = comprimir contexto (los archivos en disco quedan intactos).
- Recurre a restaurar cuando una edición rompió algo. Recurre a resumir cuando la sesión está sobrecargada pero el código está bien.
Las acciones de restauración
- Revierte tanto tus archivos como el historial del chat al punto seleccionado — un limpio 'rebobinar el tiempo' hasta ese momento.
- Rebobina el chat a ese mensaje pero conserva tu código actual. Útil para volver a hacer una pregunta sin perder las ediciones que quieres mantener.
- Revierte los cambios de archivos pero conserva la conversación. Deshaz las ediciones, conserva la discusión sobre ellas.
Tras restaurar la conversación (o elegir "Resumir desde aquí"), el prompt original del mensaje seleccionado se devuelve al campo de entrada para que puedas reenviarlo o editarlo.
Las acciones de resumen
Ambas comprimen parte de la conversación en un resumen generado por IA — como un /compact dirigido en el que eliges qué lado del mensaje seleccionado exprimir.
- Los mensajes ANTERIORES al mensaje seleccionado quedan intactos. El mensaje seleccionado y todo lo que le sigue se convierten en un resumen. Úsalo para descartar una discusión secundaria manteniendo el contexto inicial con todo detalle.
- Los mensajes ANTERIORES al mensaje seleccionado se convierten en un resumen; el mensaje seleccionado y todo lo que sigue quedan intactos. Permaneces al final de la conversación. Úsalo para comprimir la cháchara de configuración inicial manteniendo el trabajo reciente literal.
De cualquier modo, los mensajes originales permanecen en la transcripción de la sesión, así que Claude puede seguir consultando los detalles. Puedes escribir instrucciones opcionales para orientar en qué se enfoca el resumen.
Para ver el flujo completo, consulta Gestión del contexto — las acciones de resumen de /rewind son un bisturí donde /compact es una brocha ancha.
Rebobinar más allá de un /clear
Si ejecutaste /clear antes en el mismo proceso de Claude Code, el menú de rewind muestra una entrada extra en la parte superior: /resume <session-id> (previous session). Selecciónala para volver a la conversación que estaba activa antes del /clear.
Dónde se detienen los checkpoints — los límites que muerden
Los checkpoints parecen mágicos hasta que dejan de serlo. Importan tres huecos:
- Los archivos tocados por comandos de shell que Claude ejecuta — rm, mv, cp, generadores de código, formateadores — NO se rastrean. Solo las ediciones directas a través de las herramientas de edición de archivos de Claude se registran en checkpoints. Un archivo eliminado con rm desaparece en lo que respecta a rewind.
- Las ediciones manuales que haces fuera de Claude Code, y las ediciones de otras sesiones concurrentes, normalmente no se capturan — a menos que casualmente toquen los mismos archivos que editó la sesión actual.
- Los checkpoints son recuperación rápida y local. No son commits, ni ramas, ni compartibles con tu equipo.
Checkpoints vs. Git: usa ambos
Resuelven problemas distintos, así que combínalos.
Checkpoints (/rewind) | Git | |
|---|---|---|
| Alcance | Una sesión | Historial completo del proyecto |
| Granularidad | Por prompt, automática | Por commit, deliberada |
| ¿Rastrea cambios hechos por bash? | No | Sí (una vez preparados/confirmados) |
| Vida útil | ~30 días, luego desaparece | Permanente |
| Compartible / colaborativo | No | Sí |
| Modelo mental | "Deshacer local" | "Historial permanente" |
- Confirma los estados que funcionan con Git antes de una ejecución arriesgada y de amplia escala — ese es tu suelo duradero.
- Usa /rewind para una recuperación rápida dentro de la sesión entre commits sin ensuciar tu historial de Git.
- Si Claude va a ejecutar bash destructivo (rm/mv) o generadores, apóyate en Git — rewind no salvará esos archivos.
Cuándo recurrir a ello
- Prueba una implementación atrevida y, si no te gusta, restaura código y conversación al punto de bifurcación y prueba otra.
- ¿Una edición introdujo un bug hace tres prompts? Restaura el código a justo antes en lugar de depurar los escombros.
- Experimenta con variaciones, sabiendo siempre que un estado bueno conocido está a un /rewind de distancia.
- ¿Un desvío verboso de depuración se comió tu ventana de contexto? Resume desde el punto medio en adelante y conserva tus instrucciones originales con todo detalle.
Ponte a prueba
0/3- Los checkpoints son instantáneas automáticas de tu código, por prompt — un deshacer local para toda la sesión, conservado unos 30 días.
- Abre el menú de rewind con /rewind o con doble Esc en una entrada vacía; lista todos los prompts que enviaste.
- Las acciones de restauración deshacen el estado (código, conversación, o ambos); las acciones de resumen comprimen el contexto y nunca tocan los archivos.
- Los cambios hechos por bash, externos y concurrentes NO se rastrean — solo las ediciones directas con herramientas de archivo.
- Los checkpoints complementan a Git, no lo reemplazan: piensa en 'deshacer local' vs. 'historial permanente y compartible'.
Siguiente
- Gestión del contexto —
/compact,/cleary cómo encaja el resumen en el panorama general - Modo Plan — investiga y aprueba un plan antes de que se ejecuten las ediciones, para rebobinar con menos frecuencia
- Permisos — la otra mitad de ejecutar tareas ambiciosas de forma segura