Saltar al contenido

Claude Code rewind: deshaz lo que hizo Claude sin tocar git

En la práctica/ 13 min de lectura

Cada prompt deja un punto de control: con /rewind o Esc dos veces regresas el código, la conversación o ambos. Qué no deshace y cuándo te toca usar git.

  • IA
  • Claude Code
  • Git
En este artículo (7)
  1. Qué son los puntos de control de Claude Code
  2. Cómo usar /rewind: código, conversación o ambos
  3. Lo que rewind no deshace
  4. Rewind y git: cuándo usar cada uno
  5. Errores comunes
  6. Preguntas frecuentes
  7. Checklist

Claude Code guarda un punto de control antes de cada prompt que envías. Para deshacer lo que hizo Claude, escribe /rewind o presiona Esc dos veces con el campo de texto vacío, elige el prompt y decide si restauras el código, la conversación o ambos. No toca git, y no deshace los archivos que solo cambió un comando de Bash.

Abajo: cómo funcionan según la documentación oficial de checkpointing (consultada el 2 de noviembre de 2026), qué hace cada opción del menú, qué queda fuera y cómo repartir el trabajo con git. El menú es interactivo, así que lo que contamos de él viene de la documentación; en Claude Code 2.1.238, la versión que tenemos instalada, comprobamos que el comando y sus opciones existen. Las salidas de git son de un repositorio de prueba. Si todavía no trabajas con ramas y commits pequeños, empieza por git para trabajar con agentes de IA.

Qué son los puntos de control de Claude Code

Un punto de control (checkpoint, en la documentación) es una foto de tus archivos tomada justo antes de que Claude empiece a trabajar en un prompt. Claude Code los crea solo, sin que actives nada: cada prompt que envías y que inicia un turno crea uno nuevo. Lo que guarda son copias de los archivos que Claude cambia con sus herramientas de edición, tomadas antes de cada edición. Esas herramientas son Write, Edit y NotebookEdit, según la página de checkpointing del Agent SDK, que usa el mismo mecanismo.

una sesión: un punto de control antes de cada promptprompt 1Editenvio.jsrastreadoprompt 2Writeenvio.test.jsrastreadoprompt 3Bashrm cupones.jsno rastreadoprompt 4Editenvio.jsrastreadoahora/rewind · Esc Esc · Restore codeel código vuelve a como estaba antes del prompt 2el rm del prompt 3 no se deshace: lo hizo Bashun punto por prompt · hasta 100 por sesiónse guardan con la sesión; la limpieza borra las copias a los ~30 días

Desliza la figura para verla completa

Tres datos de la documentación que conviene saber antes de confiar en ellos:

  • Cuántos. Claude Code conserva las copias de los 100 puntos de control más recientes de cada sesión.
  • Dónde. En ~/.claude/file-history/<sesión>/, según la guía de la carpeta .claude. Se guardan con la conversación, así que puedes usar /rewind después de retomar una sesión con claude --continue o claude --resume.
  • Cuánto duran. Una limpieza automática borra las copias de una sesión, por defecto unos 30 días después de la última que guardó. Si retomas una sesión más vieja, el menú sigue listando sus puntos, pero restaurar el código puede fallar con No files were restored, como explica la referencia de errores.

Los dos ajustes que controlan esto están en la referencia de configuración. Este settings.json guarda las sesiones 60 días en lugar de 30 y deja los puntos de control encendidos:

{
  "cleanupPeriodDays": 60,
  "fileCheckpointingEnabled": true
}
  1. cleanupPeriodDays es cuántos días guarda Claude Code las transcripciones y otros datos de la aplicación, incluidas las copias de los puntos de control. El valor por defecto es 30, el mínimo es 1 y 0 no pasa la validación. Ojo: también alarga el tiempo que las conversaciones completas quedan en tu disco.
  2. fileCheckpointingEnabled viene en true. En false, Claude Code deja de copiar archivos y /rewind ya no puede restaurar código. En /config aparece como Rewind code (checkpoints), y la variable CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING lo apaga para una sola sesión.

Va en ~/.claude/settings.json para todos tus proyectos o en .claude/settings.json para uno. Solo validamos el JSON: el efecto de los ajustes es el que describe la documentación.

Cómo usar /rewind: código, conversación o ambos

Hay dos formas de abrir el menú. Una es escribir /rewind, que también responde a /checkpoint y /undo, según la lista de comandos. La otra es presionar Esc dos veces con el campo de texto vacío. Si hay texto escrito, el doble Esc lo borra en lugar de abrir el menú; el texto queda en el historial y lo recuperas con la flecha hacia arriba, como indica la página de modo interactivo.

El menú lista los prompts que enviaste en la sesión. Eliges el punto y después una de estas acciones, con sus nombres tal como salen en pantalla:

OpciónTu códigoLa conversación
Restore code and conversationVuelve a ese puntoVuelve a ese punto
Restore conversationSe queda como estáVuelve a ese mensaje
Restore codeVuelve a ese puntoSe queda como está
Summarize from hereSin cambiosResume desde ese punto hasta el final
Summarize up to hereSin cambiosResume lo anterior y conserva lo posterior
Never mindSin cambiosSin cambios: regresa a la lista

Las dos opciones que restauran código solo aparecen si en ese punto hay cambios de archivos que revertir; si no, el menú ofrece Restore conversation, los dos resúmenes y Never mind. Después de restaurar la conversación o de elegir Summarize from here, el prompt original vuelve al campo de texto para que lo reenvíes o lo corrijas.

Cuál elegir depende de qué salió mal:

  • El código quedó mal, pero la conversación sirve: Restore code. Claude conserva lo que hablaron y puedes pedirle otro enfoque.
  • Claude tomó el camino equivocado desde el principio: Restore code and conversation, y reescribe el prompt con lo que aprendiste.
  • El código está bien, pero la conversación se llenó de intentos fallidos: Restore conversation, o un resumen si solo necesitas liberar contexto.

Los resúmenes no cambian archivos: funcionan como un /compact dirigido, y los mensajes originales siguen en la transcripción. Si lo que quieres es probar otro camino sin perder el actual, la documentación recomienda /branch o claude --continue --fork-session.

Dos detalles que confunden. Un mensaje que escribiste mientras Claude seguía trabajando puede salir marcado como No code restore: no tiene punto propio, así que elige el prompt que inició ese turno. Y si restauras la conversación y sales de Claude Code sin enviar otro prompt, los mensajes que quitaste pueden volver al retomar la sesión: envía un prompt antes de salir.

Lo que rewind no deshace

Esta es la parte que más importa, y la documentación la explica en su sección de limitaciones. Un punto de control guarda los archivos que Claude editó con sus herramientas. Todo lo demás queda fuera:

  • Comandos de Bash. Un archivo que solo cambió un comando (rm, mv, cp, sed -i, un formateador, npm install) no se rastrea y se queda como está. La excepción: si Claude ya había editado ese archivo con sus herramientas en la conversación, /rewind sí deshace lo que Bash le hizo después.
  • Subagentes. Sus ediciones normalmente no entran en tus puntos de control. Solo se restauran las de una skill con context: fork que corre en primer plano; lo que cualquier otro subagente cambió en archivos que Claude no había tocado se queda.
  • Cambios externos. Lo que editas a mano fuera de Claude Code y lo que hace otra sesión al mismo tiempo normalmente no se captura, salvo que toque los mismos archivos que la sesión actual.
  • Enlaces simbólicos y duros. Se omiten al restaurar, con el aviso Restored the code, but skipped N files. Pasa con los archivos que pnpm enlaza en su lugar o que un gestor de dotfiles enlaza en tu proyecto.
  • Carpetas. La página del Agent SDK aclara que crear, mover o borrar carpetas no se deshace.

Y una consecuencia de que un punto de control sea una copia de archivos: lo que no es un archivo de tu proyecto tampoco vuelve. Un git commit o un git push que Claude corrió con Bash, una migración aplicada a la base de datos o un despliegue siguen hechos después del rewind.

qué vuelve con /rewind y qué noel cambio¿vuelve?qué usarEdit / Write de Claudesí/rewindBash en un archivo que Claude ya editósí/rewindsolo Bash: rm, mv, sed -i, npmnogit restoresubagente, en otros archivosnogit restoretus ediciones u otra sesiónnormalmente nogitsymlink o hard linkse omitea manogit commit o git pushno: no son archivosgit revert / resetrewind restaura lo que Claude editó con sus herramientasClaude Code docs, checkpointing: Limitations; carpetas, según el Agent SDK

Desliza la figura para verla completa

Lo vimos en un repositorio de prueba con una sesión en la que Claude agrega envío gratis. Con sus herramientas edita src/envio.js y crea src/envio.test.js; con Bash borra src/cupones.js y corre un sed -i sobre src/carrito.js. Simulamos esas acciones con comandos de shell para poder repetir la prueba. Esto es lo que muestra git al terminar:

$ git status --short
 M src/carrito.js
 D src/cupones.js
 M src/envio.js
?? src/envio.test.js
$ git restore src/carrito.js src/cupones.js
$ git status --short
 M src/envio.js
?? src/envio.test.js
  1. M src/carrito.js: lo modificó el sed -i de Bash, y Claude nunca lo editó con sus herramientas. /rewind lo deja como está.
  2. D src/cupones.js: lo borró rm. /rewind no lo trae de vuelta.
  3. M src/envio.js: lo editó Claude con su herramienta Edit. Este sí lo restaura Restore code.
  4. ?? src/envio.test.js: un archivo nuevo que Claude creó con Write. Según la página del Agent SDK, al rebobinar Claude Code borra los archivos que creó y restaura los que modificó.
  5. git restore recupera los dos archivos de Bash desde el índice, que aquí es igual al último commit (ver git-restore). La segunda lista muestra lo que queda: justo lo que un rewind sí cubre.

Por eso conviene mirar git status después de cada rewind: te dice si quedó algo que el punto de control no veía.

Rewind y git: cuándo usar cada uno

La documentación lo resume así: los puntos de control sirven para recuperarte rápido dentro de una sesión, y git sigue siendo el historial permanente y la forma de colaborar. Las buenas prácticas de Claude Code lo repiten: funcionan junto con git, no en su lugar. En la práctica se reparten así:

SituaciónUsa
Claude se equivocó hace unos prompts, en esta sesión/rewind, Restore code
La conversación se desvió, pero el código sirve/rewind, Restore conversation
Un comando de Bash borró, movió o reformateó archivosgit status y git restore
Un subagente cambió archivos que Claude no había tocadogit restore
Quieres apartar el intento y empezar limpiogit stash push -u
El cambio sirvegit add y git commit en la rama del agente
Es otra sesión, otra persona o pasaron más de 30 díasgit

El orden que usamos: un punto seguro en git antes de pedir, rewind para los errores de los últimos minutos y git otra vez al terminar. El punto seguro son cuatro comandos:

$ git status --short
 M README.md
$ git add -A
$ git commit -m "Documenta el envío"
[main ca01a57] Documenta el envío
 1 file changed, 1 insertion(+)
$ git switch -c agente/envio-gratis
Switched to a new branch 'agente/envio-gratis'
  1. git status --short muestra trabajo tuyo sin commit: README.md modificado.
  2. git add -A y git commit lo guardan. El hash ca01a57 es el punto al que puedes volver aunque la sesión ya no exista.
  3. git switch -c crea la rama del agente y se cambia a ella: lo que haga Claude queda separado de main.

Si al final el intento no convence, pero no quieres tirarlo, apártalo con git stash:

$ git stash push -u -m "intento envío gratis"
Saved working directory and index state On agente/envio-gratis: intento envío gratis
$ git status --short
$ git stash list
stash@{0}: On agente/envio-gratis: intento envío gratis
  1. -u incluye los archivos nuevos que git no sigue, como el test que creó Claude; sin esa opción se quedarían en tu carpeta.
  2. -m le pone un nombre para reconocerlo en la lista.
  3. El git status --short vacío confirma que la carpeta volvió al último commit.
  4. git stash list muestra lo apartado. git stash pop lo devuelve cuando lo necesites y git stash drop lo descarta.
rewind y git: quién cubre quéantes de pedirgit statusgit commit -m "…"git switch -cagente/tareaen la sesióncada prompt:un checkpoint¿salió mal?/rewindal terminargit status --shortgit diffbien: git commitmal: git restore/rewindmisma sesión, minutos atrássolo lo que Claude editótambién la conversacióngitBash, subagentes, tus cambiosotra sesión o más de 30 díashistorial y tu equiporewind para los últimos minutos, git para lo demáslos checkpoints no reemplazan el control de versiones (Claude Code docs)

Desliza la figura para verla completa

Para deshacer un commit que ya hizo el agente, o uno que ya subiste, el camino es git reset en su rama o git revert. Lo explicamos paso a paso en git para trabajar con agentes de IA.

Errores comunes

  • Creer que rewind deshace todo lo que hizo el agente. Solo restaura lo que Claude editó con sus herramientas. Lo que hizo con Bash, lo que hicieron los subagentes y lo que cambiaste tú a mano sigue ahí: revisa git status después.
  • Usar los puntos de control en lugar de commits. Viven en tu computadora, atados a una sesión, y la limpieza los borra a los 30 días por defecto. Tu equipo no los ve y no pasan a otra máquina.
  • Presionar Esc dos veces con texto escrito. Borra el texto en lugar de abrir el menú. Lo recuperas con la flecha hacia arriba, o usa /rewind.
  • Salir justo después de restaurar la conversación. Los mensajes que quitaste pueden volver al retomar la sesión. Envía un prompt antes de salir.
  • Esperar que rewind deshaga a un subagente. Si delegas un cambio grande a un subagente en segundo plano, trabaja en una rama y revierte con git.
  • Restaurar el código y no revisar el diff. Volver a un punto anterior no garantiza que lo que queda esté bien. Revisa el diff y las pruebas como con cualquier cambio de un agente, incluidos los tests que pudo haber borrado o saltado: lo vemos en el agente pasó los tests porque los borró.

Preguntas frecuentes

¿Rewind borra los archivos nuevos que creó Claude?

Sí, si los creó con sus herramientas. La página de checkpointing del Agent SDK, que usa el mismo mecanismo, dice que al rebobinar Claude Code borra los archivos que creó y restaura los que modificó. No deshace la creación, el movimiento ni el borrado de carpetas, ni los archivos que generó un comando de Bash, como un npm install.

¿Puedo usar /rewind después de cerrar Claude Code?

Sí. Los puntos de control se guardan con la conversación: retoma la sesión con claude --continue o claude --resume y abre el menú. El límite es la limpieza automática, por defecto unos 30 días después de que la sesión guardó su última copia; después, restaurar el código puede fallar con No files were restored. Para guardarlos más tiempo, sube cleanupPeriodDays.

¿Rewind deshace un commit?

No. Un commit lo hace un comando de Bash dentro de la carpeta .git, y eso queda fuera de los puntos de control. Si Claude editó archivos y después hizo commit, Restore code puede regresar esos archivos en tu carpeta, pero el commit sigue en el historial. Para quitarlo usa git reset en la rama del agente, o git revert si ya lo compartiste.

¿Funciona en modo no interactivo o en CI?

El menú de /rewind es del modo interactivo. En una ejecución con -p o en el Agent SDK, Claude Code ignora fileCheckpointingEnabled: el SDK activa los puntos de control con la opción enableFileCheckpointing y restaura con rewindFiles(), y una ejecución con -p sola necesita CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true. En CI, nuestra recomendación es apoyarte en git: cada ejecución parte de un commit.

Checklist

  • git status limpio y la rama del agente creada antes del primer prompt.
  • Sabes abrir el menú: /rewind, o Esc dos veces con el campo vacío.
  • Eliges la opción según lo que salió mal: el código, la conversación o ambos.
  • Después de un rewind, revisas git status por si quedó algo que hizo Bash.
  • Lo que un comando borró, movió o generó lo recuperas con git restore o lo apartas con git stash push -u.
  • Los cambios de subagentes en segundo plano los revisas y los reviertes con git.
  • Lo que sirve termina en un commit: el punto de control no es historial.
  • Si retomas sesiones viejas, ajustaste cleanupPeriodDays.

Rewind te deja probar sin miedo dentro de una sesión; git guarda lo que decidiste quedarte. Para equivocarte menos desde el principio, pide un plan antes de que Claude toque archivos con plan mode en Claude Code, trabaja con commits pequeños y una rama para el agente y revisa sus pruebas con las tres revisiones de los tests que cambió el agente.

¿Viste esto en Instagram? Comenta REWIND en el Reel y te mando la guía.

Escrito por

Luis Morales

Luis Morales

Desarrollador frontend y Shopify, EcomLabs

@luismoralesdev en Instagram

Publicado el 3 de noviembre de 2026

← Blog