Deepseek ArtifactsDeepseek Artifacts
Guía de checkpoints

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

Ver

Claude Code Checkpoints Are Here (First Look)

Canal: Build at Scale8:16

Ver

Checkpointing — official documentation

Documentación oficial: code.claude.com/docs

Ver

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

    Claude Code checkpoints feature intro card with the snapshot camera icon from a twelve features explainer
    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. 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.

    Claude Code edit loop diagram showing a snapshot captured for every edit with checkpoint snapshots numbered one through k
    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. 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.)

    Claude Code /rewind command typed in the terminal to open the checkpoint list of the current session
    /rewind escrito en el prompt de Claude Code — la lista de checkpoints se abre en la propia sesión.Ver en 2:40
  4. 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.

    Claude Code rewind restore menu offering to restore the code and conversation to the point before an earlier prompt
    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

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

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

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

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

  1. 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».

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

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

Preguntas frecuentes

Guías relacionadas de Claude Code