Clase 03 · Módulo 02
Git: guardar versiones y volver atrás
Git: guardar versiones y volver atrás
Qué logras en esta clase
Guardas versiones de tu web y vuelves a cualquiera de ellas cuando algo sale mal.
- Inicias un repositorio y haces tu primer commit.
- Lees el estado y el historial de tu proyecto.
- Deshaces cambios según el caso.
- Sabes qué cubre Git y qué cubre
/rewind.
02
Tu red de seguridad
Con Git, ningún cambio de Claude es irreversible si guardaste una versión antes de pedirlo.
03
El problema que resuelve
Claude Code puede modificar veinte archivos en un minuto. Casi siempre acierta. Cuando no, necesitas responder dos preguntas: qué cambió exactamente y cómo vuelvo a como estaba.
Sin control de versiones, la respuesta es copiar carpetas a mano y esperar no equivocarte. Con Git, cada versión guardada queda registrada con fecha, autor y descripción, y volver es un comando.
04
Cuatro palabras que necesitas
| Palabra | Qué es |
|---|---|
| Repositorio | Tu carpeta de proyecto con su historial de versiones |
| Commit | Una versión guardada: una foto de todos los archivos en un momento |
| Preparar (stage) | Elegir qué cambios entran en el próximo commit |
.gitignore | Lista de archivos que Git no debe guardar nunca |
El historial vive en una carpeta oculta llamada .git, dentro de tu proyecto. No se toca a mano.
05
El ciclo básico
Guardar es siempre dos pasos: primero eliges qué entra, después lo confirmas con un mensaje.
06
Iniciar el repositorio
Dentro de la carpeta de tu proyecto:
- Comprueba que estás donde corresponde con
pwd. - Ejecuta
git init -b main. - Ejecuta
git status.
El primer comando crea el repositorio con una línea principal llamada main, el nombre que usa GitHub. Se ejecuta una sola vez por proyecto.
07
Antes del primer commit: .gitignore
Crea en la raíz del proyecto un archivo llamado .gitignore. Cada línea es algo que Git debe ignorar:
node_modules/
dist/
.envnode_modules son los paquetes descargados, que pesan mucho y se reinstalan con un comando. dist es el sitio ya construido. .env guarda tus claves: lo verás en el módulo 7 y jamás debe entrar al historial.
08
Tu primer commit
git add .
git commit -m "Primer commit: estructura inicial"git add . prepara todos los cambios de la carpeta (el punto significa «todo lo de aquí»). git commit los guarda con el mensaje entre comillas.
Si Git reclama que no sabe quién eres, te falta la configuración de nombre y correo de la clase 1.
09
git status: tu tablero
Es el comando que más vas a escribir. No cambia nada; solo informa:
- En qué rama estás.
- Qué archivos cambiaron desde el último commit.
- Cuáles ya están preparados y cuáles no.
- Qué archivos son nuevos y Git todavía no sigue.
10
La regla del curso
Commit antes de cada pedido grande a Claude. Si el resultado no sirve, vuelves al punto exacto donde estabas.
11
Mirar qué cambió
git diff
git log --onelinegit diff muestra línea por línea lo que cambió y aún no guardas: en rojo lo que salió, en verde lo que entró. git log --oneline lista tus commits, uno por línea, con un código corto que identifica a cada uno.
Si la salida es larga y la terminal queda esperando, sal con la tecla q.
12
Mensajes que te sirvan en tres meses
El mensaje es para ti en el futuro, cuando busques en qué momento se rompió algo.
Una frase que diga qué cambió en el sitio, no qué archivos tocaste. Los archivos ya los registra Git.
13
Deshacer: depende de dónde está el cambio
| Situación | Comando | Efecto |
|---|---|---|
| Cambio sin guardar en un archivo | git restore ruta/del/archivo | Ese archivo vuelve al último commit |
| Todos los cambios sin guardar | git restore . | La carpeta vuelve al último commit |
| El último commit estuvo mal | git revert HEAD | Crea un commit nuevo que lo anula |
HEAD es el nombre que Git le da al commit más reciente de tu rama.
14
git restore no tiene papelera
Antes de ejecutarlo, mira con git diff qué vas a perder. Y recuerda su límite: solo devuelve archivos que Git ya seguía. Un archivo nuevo, nunca guardado, no se borra con restore.
15
Por qué revert y no «borrar el commit»
git revert no elimina nada del historial. Agrega un commit nuevo que hace lo contrario del que quieres anular. Queda registro de ambos, y eso es bueno: siempre puedes arrepentirte de haberte arrepentido.
Para volver a un commit más antiguo, pídeselo a Claude Code indicando el código corto de git log, y lee lo que propone antes de aprobar.
16
El comando que no debes copiar
Lo mismo vale para cualquier comando con --force. Si Claude Code te pide permiso para ejecutar uno de ellos, detente y pídele la alternativa que no destruye historial.
17
Git y /rewind no son lo mismo
Claude Code guarda puntos de control propios y permite retroceder con /rewind (clase 5).
/rewind de Claude Code | Git | |
|---|---|---|
| Qué registra | Ediciones que Claude hace con sus herramientas de archivos | Todo lo que guardes en un commit |
| Cambios hechos solo por comandos | No los sigue | Sí |
| Duración | Limitada: por defecto unos 30 días | Permanente |
| Respaldo fuera del computador | No | Sí, con GitHub |
18
La rutina con Claude Code
«Limpio» significa que git status no muestra cambios pendientes. Partir limpio es lo que te permite distinguir qué hizo Claude de lo que ya estaba a medias.
19
Claude también sabe usar Git
Claude Code puede preparar cambios, escribir el mensaje y hacer el commit si se lo pides con palabras: «guarda estos cambios con un mensaje descriptivo».
Lo bueno: mensajes claros y menos tecleo. Lo malo: si dejas que haga commit de todo sin mirar, pierdes el momento de revisión.
20
Si prefieres botones
VS Code trae un panel llamado Source Control (ícono de ramas en la barra lateral). Muestra los archivos cambiados, abre el diff al hacer clic en uno y permite preparar y hacer commit sin comandos.
| Vía | Cuándo conviene |
|---|---|
| Panel de VS Code | Revisar diferencias con comodidad y hacer commits simples |
| Terminal | Deshacer, mirar el historial y seguir instrucciones exactas |
Hacen lo mismo por debajo. Puedes alternar sin problema.
21
Lo que te llevas
- Un commit es una foto completa del proyecto a la que puedes volver.
.gitignorese crea antes del primer commit;.envsiempre va dentro.git statusinforma,git diffdetalla,git log --onelinelista.git restoredescarta lo no guardado;git revertanula un commit sin borrar historial.- Commit antes de cada pedido grande: esa es la red.
22
Hazlo ahora
En 15 minutos, en tu carpeta practica:
- Inicia el repositorio y crea el
.gitignore. - Crea un archivo
notas.txtcon una línea y haz el primer commit. - Agrega una segunda línea, mira
git diffy haz otro commit. - Escribe algo absurdo en el archivo y descártalo con
git restore. - Anula tu segundo commit con
git revert HEADy revisagit log --oneline.
Debes terminar con tres commits y el archivo con una sola línea.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026