Inicio

Claude Code con control de versiones local para Windows

Está trabajando con asistencia de IA. Esta realiza cambios en sus archivos. A veces los cambios son brillantes. A veces no lo son. El control de versiones es como un botón de deshacer para todo su proyecto. Cada vez que guarda una instantánea (llamada “commit”), crea un punto de restauración al que siempre puede volver. Lo mejor de todo es que puede hacer esto completamente en su computadora y Claude Code lo hace por usted.

Conceptos Clave

• PowerShell - Herramienta de línea de comandos integrada en Windows, que aquí se usa para ejecutar Git y Claude Code
• Git - Rastrea cada cambio en sus archivos en su computadora, creando puntos de restauración a los que puede volver en cualquier momento
• Commit - Una instantánea de su proyecto en un punto específico en el tiempo con una descripción de qué cambió
• Claude Code - Asistente de programación con IA que escribe código, corrige errores y maneja operaciones de Git mediante solicitudes simples

Lo Que Necesitará

• Haber completado Instalación de Claude Code en Windows
• 20-30 minutos

Paso 1: Abra PowerShell

• Haga clic en el menú Inicio (Start)
• Escriba PowerShell
• Haga clic en Windows PowerShell para abrirlo

Nota: Si configuró la ruta opcional de WSL/Ubuntu en lugar de la instalación nativa, abra la aplicación Ubuntu. Git y Claude Code funcionan igual allí, solo que con rutas de estilo Linux (/mnt/c/Users/...) en lugar de ~\Documents\....

Paso 2: Instale Git

• Verifique si Git ya está instalado:

  git --version
  

• Si ve un número de versión como git version 2.45.0, pase al Paso 3
• Si ve un error, instale Git for Windows:
  • Vaya a git-scm.com/download/win
  • En esa página, haga clic en Click here to download (en la parte superior) y luego abra el instalador cuando termine la descarga
  • Haga clic en Next en cada pantalla del instalador, aceptando las opciones predeterminadas
  • Haga clic en Install y luego en Finish
  • Cierre y vuelva a abrir PowerShell, y luego verifique de nuevo con git --version

Paso 3: Configure Git con Su Identidad

Git necesita saber quién es usted para los mensajes de commit.

• Configure su nombre y correo electrónico (pueden ser ficticios)

  git config --global user.name "Su Nombre"
  git config --global user.email "su.correo@ejemplo.com"
  

Usar su nombre y correo electrónico ayuda a identificar quién realizó los cambios cuando varias personas trabajan en el proyecto.

Paso 4: Navegue a Su Carpeta Documents

• Navegue a su carpeta Documents:

  cd ~\Documents
  

• Verifique que está en el lugar correcto:

  pwd
  

Debería ver una ruta que termina en \Documents.

Si ve Cannot find path, es probable que OneDrive haga copia de seguridad de su carpeta Documents. Ejecute cd ~\OneDrive\Documents en su lugar.

Paso 5: Cree una Carpeta de Proyecto

• Cree una carpeta llamada test_claude:

  mkdir test_claude
  

• Navegue hacia ella:

  cd test_claude
  

Aquí es donde vivirá su proyecto.

Paso 6: Inicie Claude Code

• Inicie Claude Code:

  claude
  

Inicie sesión con su suscripción de Claude siguiendo el tutorial de instalación. Después de iniciar sesión, verá un mensaje de bienvenida y el prompt de Claude Code.

Paso 7: Solicite a Claude que Inicialice Git

• Escriba esta solicitud:

  Comienza a rastrear los cambios
  

Claude inicializa un repositorio de Git en su carpeta (toma 2-5 segundos). ¡Ahora tiene control de versiones!

Si Claude pide permiso, muestra un pequeño menú con Yes y No. Use las teclas de flecha para elegir Yes y presione Enter. Es posible que vea esto varias veces en este tutorial.

Paso 8: Construya la Aplicación de Temporizador

• En Claude Code, copie y pegue toda esta solicitud (al pegarla, todas las líneas se mantienen juntas; presionar Enter la enviaría antes de tiempo):

  Crea una aplicación simple de temporizador en un solo archivo llamado timer.html.
  Debe tener:
  - Un campo de entrada para establecer minutos
  - Botones de Iniciar y Detener
  - Una pantalla que muestre el tiempo restante en formato MM:SS
  

Claude crea timer.html (toma 10-30 segundos) con el código CSS y JavaScript.

Paso 9: Pruebe el Temporizador

• Abra el Explorador de archivos de Windows
• Navegue a Documentos > test_claude (el Explorador de archivos muestra la carpeta Documents como Documentos)
• Haga doble clic en timer.html para abrirlo en su navegador
• Pruebe el temporizador:
  • Escriba 1 en el campo de entrada
  • Haga clic en Iniciar
  • Observe la cuenta regresiva

¿No ve test_claude? Si OneDrive hace copia de seguridad de su carpeta Documentos, el Explorador de archivos muestra una carpeta Documentos diferente. Haga clic en la barra de direcciones del Explorador de archivos, pegue %USERPROFILE%\Documents\test_claude y presione Enter.

Si algo está roto: En Claude Code, describa el error: Veo este error: [describa lo que pasó]. ¿Puedes corregirlo?

Paso 10: Solicite a Claude que Haga un Commit

• En Claude Code, escriba:

  Guarda estos cambios
  

Claude hará lo siguiente:

• Verificar qué archivos cambiaron
• Escribir un mensaje de commit descriptivo
• Crear el commit (toma 5-10 segundos)

¡Ha creado su primer punto de guardado! Siempre puede volver a esta versión funcionando.

Paso 11: Agregue Botones Predefinidos

• En Claude Code, escriba:

  Agrega dos botones en la parte superior. Si hago clic en ellos, inician automáticamente temporizadores de 1 y 5 minutos
  

• Actualice la pestaña de su navegador (presione F5 o Ctrl + R)
• Pruebe: Haga clic en el botón 5 min
• Si funciona, haga commit de los cambios:

  Guarda estos cambios
  

Creamos un segundo punto de guardado. Esta versión tiene los dos botones funcionando.

Paso 12: Agregue Otro Botón

• En Claude Code, escriba:

  Agrega un botón de 15 minutos
  

• Actualice la pestaña de su navegador (presione F5 o Ctrl + R)
• Pruebe: Haga clic en el botón 15 min

Para este tutorial: Suponga que el botón de 15 minutos no funciona correctamente. No haga commit todavía—practicaremos descartando cambios malos.

Paso 13: Descarte los Cambios

A veces el código de la IA no funciona y necesita comenzar de nuevo desde su último punto de guardado.

• En Claude Code, escriba:

  descarta estos cambios
  

• Normalmente Claude le pedirá que confirme primero. Si muestra un menú, elija Yes (con las teclas de flecha o el número junto a esa opción) y presione Enter. Si lo pregunta en un mensaje, escriba sí, descarta los cambios en timer.html y presione Enter
• Actualice su navegador—el botón de 15 minutos desaparece

Claude descarta los nuevos cambios que no nos gustan. ¡El temporizador funciona nuevamente con solo los botones de 1 y 5 minutos!

Paso 14: Agregue Notificación de Sonido

• En Claude Code, escriba:

  Agrega una notificación de sonido cuando el temporizador llegue a cero
  

• Actualice el navegador y pruebe después de que Claude termine (configure el temporizador para 1 minuto)
• Si funciona, haga commit de los cambios:

  Guarda estos cambios
  

Paso 15: Agregue un Botón de Posponer

• En Claude Code, escriba:

  El sonido debe continuar hasta que haga clic en un botón para posponerlo
  

• Actualice el navegador y pruebe después de que Claude termine (configure el temporizador para 1 minuto)
• Si funciona, haga commit de los cambios:

  Guarda estos cambios
  

Paso 16: Vea Su Historial de Commits

• En Claude Code, escriba:

  muestra mi historial de cambios
  

Claude muestra sus commits en un formato legible. Verá:

• Su commit inicial de la aplicación de temporizador
• El commit de botones predefinidos (1 min y 5 min)
• El commit de notificación de sonido
• El commit del botón de posponer

¡Note que el intento del botón de 15 minutos no está ahí—lo descartó!

Paso 17: Examine el Código

• En el navegador que muestra la aplicación, haga clic derecho y seleccione View Page Source
• Puede ver el código fuente.
• En Claude Code, pregunte

  Explica este código. Solo lo general
  

El Flujo de Trabajo Completo

• Solicite a Claude que realice cambios
• Pruebe
• Si funciona → Solicite a Claude que haga commit
• Si falla → Solicite a Claude que lo corrija.
• Incapaz de corregir → Descarte los cambios e intente nuevamente
• Repita

Siempre puede volver a cualquier commit. ¡Descarte sin temor—solo haga commit del código que funciona!

Próximos Pasos

Intente agregar más características a su temporizador:

• Botón de 15 minutos: Agrega un botón preconfigurado de 15 minutos que funcione (¡rehaga lo que descartamos!)
• Botón de pausa: Agrega un botón de Pausa/Reanudar que alterne el estado del temporizador
• Mejor estilo: Mejora el diseño visual con un esquema de colores moderno y fuentes más grandes
• Barra de progreso: Agrega una barra de progreso visual que muestre el tiempo restante

Recuerde: Pruebe después de cada característica, haga commit después de cada éxito, descarte los fallos.

Solución de Problemas

• Error “not a git repository”: Asegúrese de estar en la carpeta test_claude (cd ~\Documents\test_claude, o cd ~\OneDrive\Documents\test_claude si usó la ruta de OneDrive en el Paso 4)
• No puede encontrar timer.html en Windows: El archivo está en C:\Users\SU_USUARIO\Documents\test_claude\timer.html (o C:\Users\SU_USUARIO\OneDrive\Documents\test_claude\timer.html si usó la ruta de OneDrive en el Paso 4)
• Comando git no encontrado: Cierre y vuelva a abrir PowerShell después de instalar Git for Windows para que se actualice el PATH, y luego ejecute git --version otra vez
• El temporizador no funciona: Abra la consola del navegador (haga clic derecho en la página, seleccione Inspect, haga clic en la pestaña Console), copie cualquier mensaje de error rojo y péguelo en Claude

Lo Que Puede Preguntarle a Claude

• ¿qué archivos he cambiado? - Ver cambios sin hacer commit
• muéstrame las diferencias - Ver exactamente qué código cambió
• explica qué hace el código del temporizador - Entender la implementación
• crea una rama llamada experimento - Probar cambios riesgosos de manera segura
• deshaz todo desde mi último commit - Descartar los cambios que aún no ha guardado

¡Claude maneja todas las operaciones de Git a través del lenguaje natural—no hay comandos que memorizar!

Resumen del Flujo de Trabajo

• Configuración: Instale Git una vez, configure la identidad una vez
• Desarrollo: Claude escribe código, usted prueba en el navegador
• Control de Versiones: Claude maneja todas las operaciones de Git mediante solicitudes simples
• Seguridad: Descarte cambios malos en cualquier momento, vuelva a cualquier commit anterior
• Local: Su historial de Git permanece en su computadora, sin necesidad de una cuenta de GitHub (Claude Code en sí todavía necesita internet y su cuenta de Claude)

Creado por Steven Ge el 8 de diciembre de 2025.