Curso – Claude
EN

Puntos de control y rebobinado

Los puntos de control le permiten guardar el estado de conversación y rebobinar a puntos anteriores en su sesión de Claude Code. Esto es invaluable para explorar diferentes enfoques, recuperarse de errores o comparar soluciones alternativas.

Introducción

Los puntos de control le permiten guardar el estado de conversación y volver a los puntos anteriores, lo que permite la experimentación segura y la exploración de múltiples enfoques. Son instantáneas de su estado de conversación, incluyendo: - Todos los mensajes intercambiados - Modificaciones de archivos realizadas - Historial de uso de herramientas - Contexto de sesión

Los puntos de control son invaluables cuando se exploran diferentes enfoques, se recuperan de errores o comparan soluciones alternativas.

Conceptos clave

Concepto Descripción
Punto de control Captura de pantalla del estado de conversación, incluyendo mensajes, archivos y contexto
Rebobinar Volver a un puesto de control anterior, descartando los cambios posteriores
Sucursal Punto de control desde el que se exploran múltiples enfoques

Acceso a los puestos de control

Puede acceder y gestionar los puestos de control de dos maneras principales:

Uso del acceso directo al teclado

Prensa Esc dos veces (Esc + Esc) para abrir la interfaz de control y navegar por los puestos de control guardados.

Usar el comando Slash

Usar la /rewind orden (alias: /checkpoint, /undo) para un acceso rápido:

# Open rewind interface
/rewind

# Or use the alias
/checkpoint

Opciones de rebobinado

Cuando se rebobina, se le presenta un menú de seis opciones:

  1. Restaurar código y conversación -- Revertir archivos y mensajes a ese punto de control
  2. Restaurar conversación -- Rebobinar mensajes solamente, mantener su código actual tal y como está
  3. Código de restauración -- Revertir sólo los cambios de archivo, mantener el historial completo de la conversación
  4. Resuma desde aquí -- Comprimir la conversación desde este punto hacia adelante en un resumen generado por IA, liberando espacio de ventana de contexto. Los mensajes antes de que el punto seleccionado permanezca intacto. No se cambian los archivos en disco. Los mensajes originales se conservan en la transcripción de la sesión. Opcionalmente, puede proporcionar instrucciones para enfocar el resumen en temas específicos.
  5. Resuma hasta aquí -- La contraparte hacia atrás: comprimir todo antes el punto seleccionado en un resumen generado por IA, manteniendo intactos los mensajes de este punto hacia adelante. Junto con "Resumir desde aquí" esto le da compactación bidireccional, dirigida de su ventana de contexto. No se cambian archivos en disco, y los mensajes originales se conservan en la transcripción de la sesión.
  6. No importa. -- Cancelar y volver al estado actual

Nota: Después de restaurar la conversación o elegir Resuma desde aquí, el indicador original del mensaje seleccionado se restaura en el campo de entrada para que pueda volver a enviarlo o editarlo. Resuma hasta aquí te deja al final de la conversación con la entrada vacía.

Consejo: Enviar a Claude un aviso antes de salir después de un rebobinado. Claude Code guarda la conversación de rebobinado junto con ese aviso, por lo que si sale primero, los mensajes de rebobinado pueden volver. /rewind, seleccione el mismo prompt, y elija Restaurar conversación. Los archivos restaurados permanecen como el rebobinado los dejó.

/clear ya no es un límite duro (v2.1.191+): /rewind puede reanudarse desde un puesto de control tomado antes Corriste. /clear. Limpiar la conversación ya no descarta de forma permanente el estado que la precedió — puede volver a rebobinar a través de la clara si necesita ese código o contexto anterior de nuevo.

Puntos de control automáticos

Claude Code crea automáticamente puntos de control para usted:

  • Cada indicador de usuario - Se crea un nuevo puesto de control con cada entrada de usuario
  • Persistente - Los puntos de control se guardan con la conversación, así que /rewind todavía funciona después de reanudar una sesión
  • Limpieza automática - Los puestos de control se limpian automáticamente después de 30 días

Esto significa que siempre puedes rebobinar a cualquier punto anterior de tu conversación, desde hace unos minutos hasta días antes.

Casos de uso

Escenario Flujo de trabajo
Explorando enfoques Guardar → Probar A → Guardar → Rebobinar → Probar B → Comparar
Refactorización segura Guardar → Refactor → Prueba → Si falla: Rebobinar
Ensayo A/B Guardar → Diseño A → Guardar → Rebobinar → Diseño B → Comparar
Recuperación de errores Aviso de emisión → Rebobinar para durar buen estado

Uso de puntos de control

Visualización y rebobinado

Prensa Esc dos veces o utilizar /rewind para abrir el navegador de puntos de control. Verá una lista de todos los puntos de control disponibles con marcas de tiempo. Seleccione cualquier punto de control para rebobinar a ese estado.

Detalles del punto de control

Cada punto de control muestra: - Marca de tiempo de cuando fue creado - Archivos que fueron modificados - Número de mensajes en la conversación - Herramientas que se utilizaron

Ejemplos prácticos

Ejemplo 1: Explorando diferentes enfoques

User: Let's add a caching layer to the API

Claude: I'll add Redis caching to your API endpoints...
[Makes changes at checkpoint A]

User: Actually, let's try in-memory caching instead

Claude: I'll rewind to explore a different approach...
[User presses Esc+Esc and rewinds to checkpoint A]
[Implements in-memory caching at checkpoint B]

User: Now I can compare both approaches

Ejemplo 2: Recuperandose de errores

User: Refactor the authentication module to use JWT

Claude: I'll refactor the authentication module...
[Makes extensive changes]

User: Wait, that broke the OAuth integration. Let's go back.

Claude: I'll help you rewind to before the refactoring...
[User presses Esc+Esc and selects the checkpoint before the refactor]

User: Let's try a more conservative approach this time

Ejemplo 3: Experimentación segura

User: Let's try rewriting this in a functional style
[Creates checkpoint before experiment]

Claude: [Makes experimental changes]

User: The tests are failing. Let's rewind.
[User presses Esc+Esc and rewinds to the checkpoint]

Claude: I've rewound the changes. Let's try a different approach.

Ejemplo 4: Enfoques de ramificación

User: I want to compare two database designs
[Takes note of checkpoint - call it "Start"]

Claude: I'll create the first design...
[Implements Schema A]

User: Now let me go back and try the second approach
[User presses Esc+Esc and rewinds to "Start"]

Claude: Now I'll implement Schema B...
[Implements Schema B]

User: Great! Now I have both schemas to choose from

Retención en el punto de control

Claude Code gestiona automáticamente sus puestos de control:

  • Los puntos de verificación se crean automáticamente con cada indicador de usuario
  • Los antiguos puestos de control se mantienen hasta 30 días
  • Los puestos de control se limpian automáticamente para evitar el crecimiento ilimitado del almacenamiento

Patrones de flujo de trabajo

Estrategia de subdivisión para la exploración

Al explorar múltiples enfoques:

1. Start with initial implementation → Checkpoint A
2. Try Approach 1 → Checkpoint B
3. Rewind to Checkpoint A
4. Try Approach 2 → Checkpoint C
5. Compare results from B and C
6. Choose best approach and continue

Patrón de refactorización seguro

Al hacer cambios significativos:

1. Current state → Checkpoint (auto)
2. Start refactoring
3. Run tests
4. If tests pass → Continue working
5. If tests fail → Rewind and try different approach

Mejores prácticas

Dado que los puestos de control se crean automáticamente, puede centrarse en su trabajo sin preocuparse por el estado de ahorro manual. Sin embargo, tenga en cuenta estas prácticas:

Uso eficaz de los puntos de control

✅ Hacer: - Revisar los puestos de control disponibles antes de rebobinar - Usar rebobinado cuando desee explorar diferentes direcciones - Mantener los puestos de control para comparar diferentes enfoques - Comprender lo que hace cada opción de rebobinado (restore código y conversación, restaurar la conversación, restaurar el código o resumir)

❌ No: - Confíe únicamente en los puestos de control para la preservación de códigos - Espere que los puestos de control sigan los cambios del sistema de archivos externos - Utilice los puestos de control como sustituto de git commits

Configuración

Los puntos de control son un comportamiento por defecto incorporado en Claude Code y no requieren ninguna configuración para habilitar. Cada solicitud de usuario crea automáticamente un punto de control.

Dos ajustes rigen el comportamiento de los puntos de control: si se toman instantáneas y cuánto tiempo se mantienen:

{
  "fileCheckpointingEnabled": true,
  "cleanupPeriodDays": 30
}
Ajuste Predeterminado Efecto
fileCheckpointingEnabled true Archivos de instantánea antes de cada edición /rewind Requiere v2.1.119+. Superficies en /config como Código de rebobinado (puntos de control). Env equivalente: CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING
cleanupPeriodDays 30 Número de días para mantener el historial de las sesiones y los puestos de control

Claude Code mantiene instantáneas para el 100 puestos de control más recientes; los más viejos se caen incluso dentro de la ventana de retención.

Actualización v2.1.117: cleanupPeriodDays Ahora rige la retención de muchos cachés en disco, no sólo puntos de control (una selección a continuación; transcripciones de sesión, file-history/, plans/, debug/, paste-cache/ y más están cubiertos también):

  • Puestos de control de sesión
  • ~/.claude/tasks/ — listas de tareas persistentes
  • ~/.claude/shell-snapshots/ — instantáneas capturadas de la shell y del medio ambiente
  • ~/.claude/backups/ — versiones anteriores de ~/.claude.json (los cinco más nuevos se conservan)

Una única configuración ahora poda estos directorios uniformemente después del mismo número de días.

Limitaciones

Los puestos de control tienen las siguientes limitaciones:

  • Cambios en el archivo solo de Bash NO rastreado - Una vez que Claude haya editado un archivo con sus herramientas de edición de archivos, /rewind también deshace los cambios que los comandos Bash hacen a ese archivo después; un archivo que sólo los comandos Bash cambiados no es rastreado. Desde v2.1.309, sed -i se trata como cualquier otra edición de Bash
  • Cambios externos NO seguidos - Los cambios realizados fuera de Claude Code (en su editor, terminal, etc.) no son capturados
  • No es un reemplazo para el control de versiones - Use git para cambios permanentes y auditables en su base de código
  • Subagent edita NO restaurado - Las ediciones de un subagente a archivos que Claude no había editado en tu conversación no están rastreadas, así que /rewind los deja como están (revertirlos con git); la excepción es un primer plano context: fork habilidad, cuyas ediciones se restauran como la sesión principal

Actualización de v2.1.216: /rewind Ya no restaura ni elimina archivos a través de enlaces simbólicos o duros en rutas de seguimiento. Si una ruta de seguimiento resuelve a través de un enlace simbólico o duro, rebobina omitiéndolo en lugar de seguir el enlace, e informa de cuántas rutas omitió por esta razón.

Solución de problemas

Faltan puntos de control

Problema: No se ha encontrado el puesto de control previsto

Solución: - Comprobar si los puestos de control fueron limpiados - Comprobar el espacio en disco - Asegurar cleanupPeriodDays se fija lo suficientemente alto (por defecto: 30 días)

Rebobinado fallido

Problema: No se puede rebobinar al puesto de control

Solución: - Asegúrese de que no hay conflictos de cambios no comprometidos - Compruebe si el punto de control está dañado - Trate de volver a un punto de control diferente

Integración con Git

Los puntos de control complementan (pero no sustituyen) git:

Característica Git Puntos de control
Ámbito de aplicación Sistema de archivos Conversación + archivos
Persistencia Permanente Basados en el período de sesiones
Granularidad Compromisos Cualquier punto
Velocidad Más lento Instantánea
Compartir Sí. Limitada

Use ambos juntos: 1. Use puntos de control para la experimentación rápida 2. Use git commits para los cambios finalizados 3. Cree punto de control antes de las operaciones de git 4.

Guía de inicio rápido

Flujo de trabajo básico

  1. Trabajo normal - Claude Code crea puestos de control automáticamente
  2. ¿Quieres volver? - Prensa Esc dos veces o utilizar /rewind
  3. Elija un puesto de control - Seleccione de la lista para rebobinar
  4. Seleccione qué restaurar - Elija entre restaurar código y conversación, restaurar conversación, restaurar código, resumir desde aquí, resumir hasta aquí, o cancelar
  5. Continuar trabajando - Has vuelto a ese punto.

Accesos rápidos del teclado

  • Esc + Esc - Abrir navegador de puntos de control
  • /rewind - Otra forma de acceder a los puestos de control
  • /checkpoint, /undo - Alias para /rewind

Saber cuándo rebobinar: Monitorización del contexto

Los puestos de control te permiten volver, pero ¿cómo sabes cuando ¿Deberías? A medida que tu conversación crece, la ventana de contexto de Claude se llena y modela la calidad silenciosamente se degrada.

cc-context-stats resuelve esto añadiendo tiempo real zonas de contexto a su barra de estado de Claude Code. Rastrea dónde se encuentra en la ventana de contexto — desde Plan (verde, seguro para planificar y codificar) Código (amarillo, evitar el inicio de nuevos planes) Dump Cuando veas el cambio de zona, sabes que es hora de poner un control y empezar de nuevo en lugar de empujar con salida degradada.

Recursos adicionales

Resumen

Los puntos de control son una función automática en Claude Code que le permite explorar con seguridad diferentes enfoques sin miedo a perder trabajo. Cada solicitud de usuario crea un nuevo punto de control automáticamente, para que pueda volver a cualquier punto anterior de su sesión.

Beneficios clave: - Experimentar sin miedo con múltiples enfoques - Rápidamente recuperarse de errores - Comparar diferentes soluciones lado a lado - Integrar de forma segura con los sistemas de control de versiones

Recuerde: los puestos de control no son un reemplazo para git. Utilice los puestos de control para la experimentación rápida y git para cambios permanentes de código.

Última actualización: 26 de octubre de 2026 Versión de Claude Code: 2.1.310 Fuentes: - https://code.claude.com/docs/en/checkpointing - https://code.claude.com/docs/en/settings - https://github.com/anthropics/claude-code/releases/tag/v2.1.117 - https://code.claude.com/docs/en/model-config - https://code.claude.com/docs/en/commands - https://code.claude.com/docs/en/claude-directory - https://code.claude.com/docs/en/changelog#2-1-309 - https://code.claude.com/docs/en/checkpointing#bash-command-changes-not-tracked - https://code.claude.com/docs/en/checkpointing#subagent-edits-not-restored - https://code.claude.com/docs/en/checkpointing#rewound-messages-can-return-if-you-exit-before-your-next-prompt Modelos compatibles: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5

← Anterior
Revisión de las relaciones públicas
Siguiente →
Ejemplos de puntos de control

Versión en español de Cris Severin. Basado en Claude How To de luongnv89, bajo licencia MIT. Proyecto original