Checkpoints de Claude Code: cómo rebobinar código y conversación
Cada prompt de Claude Code es un checkpoint que puede restaurar. Aprenda /rewind y doble Esc, las tres opciones de restauración, qué capturan los checkpoints (y qué no), los límites de retención y cómo complementan a git — verificado contra la documentación oficial.
TL;DR
- Los checkpoints son automáticos: cada prompt que inicia un turno captura antes su código, así que no hay nada que configurar — solo necesita saber cómo rebobinar.
- Ejecute /rewind (o pulse Esc dos veces con el prompt vacío) para obtener un menú de puntos de restauración que ofrece, cada uno: restaurar código y conversación, solo la conversación o solo el código.
- Rebobinar es recuperación a nivel de sesión, no control de versiones: los efectos laterales de Bash (rm, mv, cp), la mayoría de ediciones de subagentes y sus propias ediciones manuales no se capturan. Siga haciendo commits en git.
- Claude Code conserva los 100 checkpoints más recientes de una sesión durante unos 30 días (ajustable con cleanupPeriodDays), y los checkpoints sobreviven a /resume, así que puede rebobinar la sesión de ayer hoy.
12 Claude Code Features Every Engineer Should Know: Subagents, CLAUDE.md, Checkpoints, MCP, and more
Canal: ByteByteAI7:30
Claude Code Checkpoints Are Here (First Look)
Canal: Build at Scale8:16
Checkpointing — official documentation
Documentación oficial: code.claude.com/docs
Cada opción de restauración, límite y cifra de retención de esta página está verificado contra la documentación oficial de checkpointing; los vídeos de arriba son la fuente visual y de datos.
Las capturas se atribuyen a sus creadores con enlaces profundos a los minutos exactos. No se usan fotogramas con caras.
Rebobinar con los checkpoints de Claude Code, paso a paso
Parte 1 — Qué se captura
- 1
Saber qué es un checkpoint
Un checkpoint es una instantánea automática del estado de su código, tomada antes de cada prompt que inicia un turno nuevo. Existe para que un refactor desafortunado, una edición demasiado entusiasta o un rumbo equivocado estén a un comando de deshacerse — sin stashes, sin commits, sin ceremonia.

La promesa de los checkpoints: instantánea antes de cada edición, rebobinar código y conversación cuando un experimento se tuerce.Ver en 2:15 - 2
Cada prompt que inicia turno crea uno
Los checkpoints no se crean a mano — cada prompt que pone a Claude a trabajar captura los archivos que va a tocar. Una sesión larga construye una cadena de puntos de restauración, uno por prompt, como partidas guardadas automáticas para su repositorio.

El bucle de edición: Claude edita, una instantánea aterriza en la cadena de checkpoints y el siguiente prompt arranca un ciclo nuevo.Ver en 2:33 - 3
Abrir el menú de rebobinado con /rewind
Escriba /rewind en el prompt para listar los checkpoints de la sesión actual. La vía de teclado es aún más rápida: pulse Esc dos veces con la caja de entrada vacía. (Si hay texto, doble Esc solo lo borra — pulse Flecha arriba para recuperar lo escrito.)

/rewind escrito en el prompt de Claude Code — la lista de checkpoints se abre en la propia sesión.Ver en 2:40 - 4
Elegir su punto de restauración
El menú lista cada checkpoint con el prompt que lo creó — «restaurar el código y/o la conversación al punto anterior a…». Navegue hasta el momento en que todo se torció, pulse Enter y elija qué restaurar.

El menú de restauración: elija el prompt anterior al error — las entradas resaltadas en rojo son preguntas anteriores de esta sesión.Ver en 2:45
Parte 2 — El menú de rebobinado
- 5
Restaurar código y conversación juntos
El rebobinado completo: los archivos vuelven a su estado de instantánea y la conversación se bifurca de vuelta a ese punto. Úselo cuando el rumbo entero estaba mal — el código y la memoria que Claude tiene de la tarea se reinician ambos.
- 6
Restaurar solo el código — conservar la conversación
Restaurar solo el código revierte los archivos mientras la conversación se queda donde está. Perfecto para «el enfoque es bueno, el resultado no»: Claude recuerda todo lo conversado, pero las ediciones rotas desaparecen.
- 7
Restaurar solo la conversación — bifurcar el chat
La tercera opción rebobina la conversación a un punto anterior y deja sus archivos intactos — el mismo comportamiento de bifurcación que tenía el doble Esc antes de los checkpoints. Úsela cuando el código está bien pero la discusión se fue por las ramas.
- 8
Resumir desde aquí en vez de rebobinar
El menú ofrece también «Summarize from here» y «Summarize up to here» — un /compact dirigido que condensa un tramo de la conversación en un resumen conservando sus instrucciones iniciales. Para bifurcaciones de verdad, use /branch o claude --continue --fork-session.
Parte 3 — Límites y el hábito de git
- 9
Saber qué no puede deshacer el rebobinado
Los checkpoints rastrean las ediciones de archivos que hace Claude, no todo: los cambios hechos vía Bash (rm, mv, cp), la mayoría de ediciones de subagentes, sus ediciones manuales y los cambios de otras sesiones no se capturan. Los symlinks se saltan — la restauración avisa «Restored the code, but skipped N files».
- 10
Checkpoints frente a git: repartirse el trabajo
Los checkpoints son para recuperación rápida a nivel de sesión: deshacer este prompt, reintentar esa idea. Git es para la historia permanente: commitear estados que funcionan, ramificar, hacer push. El ritmo recomendado es rebobinar sin miedo mientras explora y commitear con intención cuando un cambio merece la pena.
- 11
Vigilar la ventana de retención
Claude Code conserva los 100 checkpoints más recientes por sesión y barre las instantáneas viejas pasados unos 30 días — el mismo ajuste cleanupPeriodDays que rige el historial de transcripciones. Alargue en settings.json si quiere que /rewind y /resume alcancen más atrás.
Checkpoints vs git vs /branch vs doble Esc vs /compact
Claude Code le da cinco maneras de volver atrás — resuelven problemas distintos:
- 1Checkpoints (/rewind) — instantáneo, automático, a nivel de sesión: deshacer código, conversación o ambos hasta cualquier frontera de prompt. Sin configuración, ni permanente, ni compartido.
- 2Git — la historia de verdad: commits explícitos que usted hace cuando el trabajo merece conservarse. Los checkpoints nunca lo reemplazan; se sitúan antes en la cadena de seguridad.
- 3/branch y --fork-session — arrancar una línea temporal paralela desde la conversación actual sin tocar archivos. Cuando quiera explorar una alternativa y conservar las dos líneas.
- 4Doble Esc — el camino de teclado al mismo menú de rebobinado cuando el prompt está vacío; con texto en la caja solo borra la entrada (el historial la conserva, pulse Flecha arriba para recuperarla).
- 5/compact y «Summarize from here» — encoger la conversación en vez de moverse por ella: recuperar contexto conservando las decisiones, a costa de detalle.
Un modelo mental sencillo: rebobinar para los errores, git para el progreso, bifurcar para las alternativas, resumir para el espacio.
¿Rebobinar no hizo lo que esperaba? Primeros auxilios
Cuatro sorpresas habituales de los checkpoints y qué hacer con cada una:
- 1«No files were restored». Las instantáneas fueron barridas — superaron el tope de 100 checkpoints o la retención de ~30 días. Alargue cleanupPeriodDays en settings.json para conservar una cola más larga.
- 2«Restored the code, but skipped N files». Los symlinks y hard links se saltan por diseño. Ejecute /debug y revise ~/.claude/debug/<session-id>.txt para ver las rutas exactas saltadas, y revierta esas a mano.
- 3Los archivos cambiados vía Bash siguen iguales. rm, mv y cp corren en el shell, fuera del sistema de instantáneas — deshágalo con git checkout o restaure desde copias de seguridad.
- 4El prompt que busca no está en la lista. Los mensajes encolados a mitad de turno no crean checkpoints — rebobine hasta el prompt de inicio de turno más cercano, y las ediciones de subagentes pueden necesitar un git revert.
- 5No existe ningún comando /rewind. Los checkpoints llegaron con Claude Code 2.0 — ejecute claude update (o claude doctor) para comprobar su versión, y tenga en cuenta que las sesiones realmente antiguas, anteriores a la función, no tienen instantáneas a las que rebobinar.
Regla de oro: si el cambio importa, comítelo. Los checkpoints son el airbag, git el cinturón — llévelos ambos puestos.
