Checkpoints de Claude Code

Los checkpoints son laherramienta de reversión segura de código de Claude Code, que rastrea automáticamente las ediciones de Claude en los archivos, ayudándote a deshacer rápidamente los cambios no deseados y evitando que sea difícil recuperarse después de que el código se dañe.

Cómo funcionan los checkpoints

Cuando usas Claude Code, los checkpoints se ejecutanautomáticamente en segundo plano, sin necesidad de configuración manual en todo el proceso:

  1. Creación automática: después de cada mensaje del usuario, se crea automáticamente un checkpoint que registra el estado actual del código.
  2. Guardado persistente: los checkpoints se conservan entre sesiones; incluso si cierras la sesión, podrás acceder a los checkpoints históricos al restaurarla la próxima vez.
  3. Limpieza automática: los checkpoints de más de 30 días se eliminan automáticamente (el tiempo de limpieza es configurable).

Nota: solo se rastreanlas modificaciones directas de Claude a través de sus herramientas de edición de archivos; los cambios realizados por otros medios no se registrarán.


Cómo revertir cambios con checkpoints

1. Abre el menú de reversión

Hay dos formas de activarlo, elige una:

  • Atajo de teclado: presiona dos vecesEsc(Esc + Esc)
  • Comando de barra: escribe/rewind

2. Selecciona el tipo de reversión

Después de abrir el menú, puedes elegir entre tres modos de reversión según tus necesidades:

Tipo de reversión Efecto Escenario aplicable
Solo conversación Revierte al contenido de la conversación anterior, conservando los cambios de código actuales. Si crees que la conversación se desvió y quieres volver a preguntar, pero los cambios de código no tienen problemas.
Solo código Restaura los archivos a un estado anterior, conservando la conversación actual. Si el código se dañó, pero quieres seguir ajustándolo basándote en la conversación actual.
Código y conversación Revierte tanto el código como la conversación al estado anterior. Si quieres empezar desde cero por completo y volver a un punto con el que estés satisfecho.

Casos de uso comunes

Los checkpoints son especialmente adecuados para los siguientes escenarios de desarrollo:

  1. Explorar múltiples enfoques: prueba diferentes ideas de implementación de código; si no estás satisfecho, revierte al punto inicial con un clic y prueba otro enfoque.
  2. Corregir errores rápidamente: cuando las modificaciones de Claude introducen bugs o rompen funcionalidades, revierte rápidamente al estado funcional anterior.
  3. Desarrollo iterativo de funciones: realiza múltiples experimentos de variantes de una función y restaura en cualquier momento una versión intermedia estable.

Limitaciones importantes

Los checkpoints sonuna red de seguridad temporal, no son infalibles; presta atención a sus límites:

No rastrean cambios de comandos Bash
comorm mv cpEste tipo de operaciones de archivos ejecutadas mediante la herramienta Bash no se registran en los checkpoints y no se pueden revertir.

No rastrean cambios externos
Solo se rastrean los archivos que Claude haya editado dentro de la sesión actual. Los archivos que modifiques manualmente en herramientas externas como VS Code o la terminal, o los cambios de otras sesiones, no se capturarán.

No sustituyen a las herramientas de control de versiones
Los checkpoints se usan solo parala reversión temporal a nivel de sesión; no son adecuados para la gestión de proyectos a largo plazo ni para la colaboración en equipo.

  • Historial a largo plazo, gestión de ramas → usa herramientas de control de versiones como Git
  • Checkpoints = deshacer temporal local; Git = historial permanente del proyecto
Otras extensiones