Checkpointing

Realiza un seguimiento, revierte y resume las ediciones y conversaciones de Claude para gestionar el estado de la sesión.

Claude Code realiza un seguimiento automático de las ediciones de archivos de Claude mientras trabaja, permitiéndole deshacer rápidamente cambios y revertir a estados anteriores si algo se sale de control.

Cómo funcionan los checkpoints

Mientras trabajas con Claude, el checkpointing captura automáticamente el estado de tu código antes de cada prompt que envías y que inicia un turno.

Seguimiento automático

Claude Code rastrea todos los cambios realizados por sus herramientas de edición de archivos:

• Cada prompt que envías y que inicia un turno crea un nuevo checkpoint
• Claude Code conserva instantáneas de archivos para los 100 checkpoints más recientes de una sesión. Al descartar un checkpoint más antiguo, se eliminan los archivos de instantánea a los que no hace referencia ningún checkpoint restante, excepto la primera instantánea de cada archivo, que la extensión de VS Code usa como base para sus diffs de sesión.
• Claude Code guarda los checkpoints junto con la conversación, por lo que aún puedes ejecutar /rewind después de reanudar una sesión
• Claude Code elimina las instantáneas de archivos de una sesión en el barrido de retención, de forma predeterminada unos 30 días después de que la sesión guardó la última. Retroceder a un checkpoint cuyas instantáneas ya no existen puede fallar con No files were restored. Para conservar las instantáneas durante más tiempo, configura cleanupPeriodDays.

Retroceder y resumir

Ejecuta /rewind, o presiona Esc dos veces cuando la entrada del prompt esté vacía, para abrir el menú de retroceso.

[!NOTE]

Si la entrada del prompt contiene texto, presionar Esc dos veces lo borra en lugar de abrir el menú. El texto borrado se guarda en tu historial de entrada, así que presiona Up para recuperarlo cuando termines en el menú de retroceso.

El menú de retroceso muestra los prompts que enviaste durante la sesión. Selecciona el punto sobre el que quieres actuar y luego elige una acción:

• Restore code and conversation: revierte tanto el código como la conversación a ese punto
• Restore conversation: retrocede a ese mensaje manteniendo el código actual
• Restore code: revierte los cambios en los archivos manteniendo la conversación
• Summarize from here: comprime la conversación desde este punto en adelante en un resumen, liberando espacio en la ventana de contexto
• Summarize up to here: comprime la conversación anterior a este punto en un resumen, manteniendo intactos los mensajes posteriores
• Never mind: vuelve a la lista de mensajes sin realizar cambios

Las dos opciones de restauración de código solo aparecen cuando el checkpoint seleccionado tiene cambios de archivos rastreados que se pueden revertir. Si no se capturaron ediciones de archivos después de ese punto, el menú ofrece solo Restore conversation, las opciones de resumen y Never mind.

Después de restaurar la conversación o elegir Summarize from here, el prompt original del mensaje seleccionado se restaura en el campo de entrada para que puedas volver a enviarlo o editarlo.

Elegir Summarize up to here te deja al final de la conversación con la entrada vacía. Con cualquiera de las dos opciones de resumen, aparece un marcador Summarized conversation en la conversación donde estaban los mensajes comprimidos.

Los mensajes retrocedidos pueden volver si sales antes de tu siguiente prompt

Para eliminar de nuevo los mensajes que volvieron, ejecuta /rewind en la sesión, selecciona el mismo prompt y luego Restore conversation. Antes de salir, envíale un prompt a Claude, porque Claude Code guarda la conversación retrocedida junto con ese prompt. Los archivos que restauraste permanecen como los dejó el retroceso.

Retroceder más allá de una conversación borrada

Si ejecutaste /clear anteriormente en el mismo proceso de Claude Code, el menú de retroceso muestra una entrada adicional en la parte superior de la lista con la etiqueta /resume <session-id> (previous session). Selecciónala para reanudar la conversación que estaba activa antes de ejecutar /clear. La entrada está disponible hasta que salgas de Claude Code o reanudes una sesión diferente.

Guiar un resumen

Resumir no modifica los archivos en disco, y los mensajes originales permanecen en la transcripción de la sesión, por lo que Claude aún puede consultar los detalles. Para guiar en qué se enfoca el resumen, resalta una opción Summarize con las teclas de flecha y escribe instrucciones donde la fila indica add context (optional); luego presiona Enter. Seleccionar la opción con su tecla numérica resume de inmediato sin instrucciones.

[!NOTE]

Resumir te mantiene en la misma sesión y comprime el contexto, como un /compact dirigido. Para crear una rama y probar un enfoque diferente conservando intacta la sesión original, usa /branch o claude --continue --fork-session en su lugar.

Casos de uso comunes

Los checkpoints son particularmente útiles cuando:

• Explorar alternativas: pruebe diferentes enfoques de implementación sin perder su punto de partida
• Recuperarse de errores: deshaga rápidamente cambios que introdujeron errores o rompieron la funcionalidad
• Iterar en características: experimente con variaciones sabiendo que puede revertir a estados que funcionan
• Liberar espacio de contexto: resuma una sesión de depuración detallada desde el punto medio en adelante, manteniendo sus instrucciones iniciales intactas

Limitaciones

Los cambios de comandos Bash no se rastrean

Una vez que Claude ha editado un archivo con sus herramientas de edición de archivos en tu conversación, /rewind deshace los cambios que los comandos Bash hagan en ese archivo después. Un archivo que solo modificaron comandos Bash no se rastrea y se queda como está. Para revertirlo, usa control de versiones, como Git.

Debajo de cada prompt, el menú de rewind cuenta los cambios en archivos que Claude ya había editado, sin importar qué los haya hecho. Un prompt en el que un comando del shell modificó un archivo de ese tipo también muestra cambios de archivos.

Los cambios de subagentes no se restauran

Un subagente realiza ediciones con las herramientas de edición de archivos de Claude, pero Claude Code normalmente no captura esas ediciones en los checkpoints de su sesión. Si el rewind las restaura depende de cómo se ejecute el subagente:

• Skill forked en primer plano: un skill con context: fork que se ejecuta en primer plano edita su árbol de trabajo durante su propio turno, por lo que el rewind restaura sus ediciones como de costumbre. Establezca background: false para ejecutar un fork en primer plano; algunas situaciones, listadas en la página de skills, lo ejecutan allí independientemente de la configuración.
• Cualquier otro subagente: el rewind solo restaura los archivos que Claude ya había editado en tu conversación. Las ediciones del subagente en otros archivos se mantienen, así que usa control de versiones, como Git, para revertirlas. Esto incluye un skill forked que se ejecuta en segundo plano, el predeterminado, y una ejecución de /code-review --fix en segundo plano.

Los cambios externos no se rastrean

El checkpointing solo rastrea archivos que han sido editados dentro de la sesión actual. Los cambios manuales que realiza en archivos fuera de Claude Code y las ediciones de otras sesiones concurrentes normalmente no se capturan, a menos que modifiquen los mismos archivos que la sesión actual.

Los mensajes enviados a mitad de turno no se someten a checkpoint

En el menú de rewind, un mensaje que escribiste mientras Claude todavía estaba trabajando puede aparecer marcado como No code restore. El mensaje marcado no tiene un checkpoint propio.

Para deshacer las ediciones de archivos que Claude realizó después de ese mensaje, selecciona el prompt que inició el turno y elige Restore code o Restore code and conversation. Eso revierte las ediciones de archivos de Claude de todo el turno, incluidas las de antes de que llegara tu mensaje.

Las rutas con enlaces simbólicos y enlaces duros no se restauran

El checkpointing no revierte archivos con enlaces simbólicos o enlaces duros. Cuando selecciona Restore code o Restore code and conversation del menú /rewind, Claude Code omite cualquier ruta rastreada que sea un enlace simbólico o un enlace duro y muestra una advertencia Restored the code, but skipped N files. Los archivos omitidos mantienen su contenido actual. Para deshacer los cambios de la sesión en uno de ellos, pida a Claude que revierta la edición o edite el archivo usted mismo. Los archivos de configuración que un gestor de dotfiles enlaza simbólicamente en su proyecto y los archivos que pnpm enlaza duramente en su lugar caen en esta categoría.

Para ver qué rutas omite una restauración, active el registro de depuración con /debug antes de restaurar: el registro de depuración en ~/.claude/debug/<session-id>.txt nombra cada ruta omitida. Para cada razón de omisión y los pasos de recuperación, consulte la entrada skipped-files en la referencia de errores.

No es un reemplazo para el control de versiones

Los checkpoints están diseñados para recuperación rápida a nivel de sesión. Para historial de versiones permanente y colaboración, continúe usando control de versiones, como Git, para commits, ramas e historial a largo plazo.

Ver también

• Modo interactivo - Atajos de teclado y controles de sesión
• Comandos - Acceso a checkpoints usando /rewind
• Referencia de CLI - Opciones de línea de comandos