Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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 funciona el checkpointing

Mientras trabaja con Claude, el checkpointing captura automáticamente el estado de su código antes de cada edición. Esta red de seguridad le permite realizar tareas ambiciosas y a gran escala sabiendo que siempre puede volver a un estado de código anterior.

​
Seguimiento automático

Claude Code realiza un seguimiento de todos los cambios realizados por sus herramientas de edición de archivos:
  • Cada solicitud del usuario crea un nuevo checkpoint
  • Los checkpoints persisten entre sesiones, por lo que puede acceder a ellos en conversaciones reanudadas
  • Se limpian automáticamente junto con las sesiones después de 30 días (configurable)

​
Revertir y resumir

Presione Esc dos veces (Esc + Esc) o use el comando /rewind para abrir el menú de rewind. Una lista desplazable muestra cada una de sus solicitudes de la sesión. Seleccione el punto en el que desea actuar y luego elija una acción:
  • Restaurar código y conversación: revierte tanto el código como la conversación a ese punto
  • Restaurar conversación: revierte a ese mensaje mientras mantiene el código actual
  • Restaurar código: revierte los cambios de archivo mientras mantiene la conversación
  • Resumir desde aquí: comprime la conversación desde este punto en adelante en un resumen, liberando espacio de context window
  • Resumir hasta aquí: comprime la conversación antes de este punto en un resumen, manteniendo los mensajes posteriores intactos
  • Cancelar: regresa a la lista de mensajes sin hacer cambios
Después de restaurar la conversación o elegir Resumir desde aquí, la solicitud original del mensaje seleccionado se restaura en el campo de entrada para que pueda reenviarlo o editarlo. Al elegir Resumir hasta aquí, se queda al final de la conversación con la entrada vacía.

​
Restaurar vs. resumir

Las opciones de restauración revierten el estado: deshacen cambios de código, historial de conversación, o ambos. Las opciones de resumir comprimen parte de la conversación en un resumen generado por IA sin cambiar archivos en el disco:
  • Resumir desde aquí: los mensajes anteriores al mensaje seleccionado permanecen intactos. El mensaje seleccionado y todo lo que viene después se reemplazan con un resumen. Utilice esto para descartar una discusión secundaria mientras mantiene el contexto inicial en detalle completo.
  • Resumir hasta aquí: los mensajes anteriores al mensaje seleccionado se reemplazan con un resumen. El mensaje seleccionado y todo lo que viene después permanecen intactos, y usted permanece al final de la conversación. Utilice esto para comprimir la discusión de configuración inicial mientras mantiene el trabajo reciente en detalle completo.
En ambos casos, los mensajes originales se conservan en la transcripción de la sesión, por lo que Claude puede hacer referencia a los detalles si es necesario. Puede escribir instrucciones opcionales para guiar en qué se enfoca el resumen. Esto es similar a /compact, pero dirigido: en lugar de resumir toda la conversación, elige qué lado del mensaje seleccionado comprimir.
Resumir lo mantiene en la misma sesión y comprime el contexto. Si desea ramificarse e intentar un enfoque diferente mientras preserva la sesión original intacta, use fork en su lugar (claude --continue --fork-session).

​
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

El checkpointing no rastrea archivos modificados por comandos bash. Por ejemplo, si Claude Code ejecuta: 
rm file.txt
mv old.txt new.txt
cp source.txt dest.txt
Estas modificaciones de archivo no se pueden deshacer a través de rewind. Solo se rastrean las ediciones de archivo directo realizadas a través de las herramientas de edición de archivos de Claude.

​
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.

​
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 (por ejemplo, Git) para commits, ramas e historial a largo plazo
  • Los checkpoints complementan pero no reemplazan el control de versiones adecuado
  • Piense en los checkpoints como “deshacer local” y Git como “historial permanente”

​
Ver también