Cómo guardar tu proyecto en GitHub con Claude Code
Aprende a usar GitHub con Claude Code para guardar, versionar y compartir tu proyecto en la nube, paso a paso, sin programar ni usar la terminal.
Por qué guardar tu proyecto en GitHub con Claude Code
Imagina que llevas dos semanas construyendo una aplicación con Claude Code. Todo funciona perfecto. Entonces haces un cambio, algo se rompe, y no recuerdas qué tocaste. Si tu proyecto solo vive en tu ordenador, no hay forma de volver atrás. GitHub resuelve exactamente este problema, y Claude Code lo hace accesible sin necesidad de saber programar.
GitHub es donde vive tu proyecto de forma segura. Si nunca lo has usado, piénsalo como un Google Drive especializado en proyectos de software. La diferencia fundamental: Google Drive guarda archivos sueltos. GitHub guarda versiones completas de tu proyecto, con todo el historial de cambios.
Qué es un commit (y por qué importa)
Antes de subir nada, necesitas entender un concepto: el commit. Un commit es una foto instantánea de tu proyecto en un momento concreto. Cada vez que haces un commit, GitHub registra el estado exacto de todos tus archivos. Si después algo sale mal, puedes volver a cualquier foto anterior.
Piénsalo así:
| Concepto | Analogía |
|---|---|
| Repositorio | La carpeta de tu proyecto en la nube |
| Commit | Una foto instantánea de esa carpeta |
| Push | Subir las fotos a la nube (GitHub) |
| Historial | El álbum completo de fotos, ordenado por fecha |
Cada commit lleva un mensaje corto que describe qué cambió. Por ejemplo: "Añadir página de contacto" o "Corregir error en el formulario". Estos mensajes son tu diario de cambios.
Paso a paso: de cero a GitHub con Claude Code
No necesitas memorizar comandos. Claude Code se encarga de todo. Solo tienes que pedírselo con lenguaje natural.
1. Inicializar el proyecto
Si tu proyecto todavía no está preparado para GitHub, dile a Claude:
Inicializa este proyecto como repositorio de git
Claude ejecutará los comandos necesarios para que tu carpeta se convierta en un repositorio. No verás nada diferente en tus archivos, pero internamente ya está listo para registrar cambios.
2. Hacer tu primer commit
Ahora dile a Claude que guarde el estado actual:
Haz un commit con todos los archivos actuales. Mensaje: Primera versión del proyecto
Claude revisará qué archivos hay, los añadirá al registro y creará tu primera foto instantánea. A partir de este momento, tienes un punto de retorno seguro.
3. Subir a GitHub
Para que tu proyecto exista en la nube (y no solo en tu ordenador), pídele:
Crea un repositorio privado en GitHub y sube el proyecto
Claude creará el repositorio en tu cuenta de GitHub, lo conectará con tu carpeta local y subirá todos los archivos. Tu proyecto ya está a salvo en la nube.
Usa "repositorio privado" si no quieres que nadie más vea tu código. Siempre puedes cambiarlo a público después.
4. Seguir trabajando y guardar cambios
A partir de aquí, cada vez que hagas cambios importantes, pídele a Claude:
Haz un commit con los cambios. Mensaje: Añadir formulario de contacto
Y después:
Sube los cambios a GitHub
Cada commit es una nueva foto. Si algo se rompe mañana, puedes decirle a Claude "vuelve al commit anterior" y recuperar tu proyecto tal como estaba.
Por qué esto cambia tu forma de trabajar
Guardar tu proyecto en GitHub no es solo una copia de seguridad. Tiene tres ventajas concretas que afectan a tu día a día:
Seguridad
Si tu ordenador se estropea, pierdes el disco o borras algo por error, tu proyecto sigue intacto en GitHub. Es tu red de seguridad permanente.
Colaboración
Si trabajas con alguien más (un diseñador, otro profesional que usa Claude Code, o un programador), GitHub permite que todos trabajen sobre el mismo proyecto sin pisarse. Cada persona hace sus commits y los cambios se combinan.
Despliegue automático
Plataformas como Vercel se conectan directamente a GitHub. Cada vez que subes cambios, tu aplicación se actualiza automáticamente en producción, sin pasos manuales ni errores humanos. Te explicamos cómo en la guía para publicar tu web con Vercel, y si quieres profundizar más, en la guía avanzada de Claude Code.
En nuestros workshops, cada participante sube su proyecto a GitHub durante la sesión. Es el paso que convierte un ejercicio local en un proyecto real que puedes compartir y desplegar.
Errores comunes que evitar
No hacer commits frecuentes. Si trabajas tres horas sin hacer un solo commit, pierdes la capacidad de volver a un punto intermedio. Haz un commit cada vez que completes algo que funciona.
Mensajes de commit genéricos. "Cambios" o "Update" no te dicen nada cuando los lees un mes después. Dedica 5 segundos a escribir qué hiciste: "Añadir validación al formulario de registro".
Subir archivos sensibles. Contraseñas, claves de acceso y datos privados nunca deben subirse a GitHub. Para eso existe el archivo .gitignore, que le dice a git qué archivos ignorar. En el siguiente artículo te explico cómo proteger tus claves correctamente.
Empieza con un commit. Sube a GitHub. Y a partir de ahí, cada cambio queda registrado para siempre.
Preguntas frecuentes
¿Qué es un commit en GitHub?
Un commit es una foto instantánea de tu proyecto en un momento concreto. Cada commit registra el estado exacto de todos tus archivos, así que siempre puedes volver a una versión anterior.
¿Necesito saber programar para usar GitHub con Claude Code?
No. Le pides los pasos a Claude en lenguaje natural (inicializar, hacer commit, subir) y él ejecuta los comandos por ti. No memorizas nada.
¿Qué diferencia hay entre commit y push?
El commit guarda una foto del proyecto en tu ordenador. El push sube esas fotos a la nube de GitHub, donde quedan a salvo y se pueden compartir.
¿Cómo evito subir contraseñas a GitHub por error?
Usa un archivo .gitignore para decirle a git qué archivos ignorar. Las claves y datos privados nunca deben subirse al repositorio.
Workshop presencial de 8 horas donde guardas y despliegas tu primer proyecto. Grupos de 15-25 personas, 100% práctico.
Aprende GitHub en el workshop Código para HumanosTu proyecto merece vivir en la nube
Si estás construyendo algo con Claude Code, ya sea una web, una automatización o una herramienta interna, guardarlo en GitHub es el paso que separa un experimento de un proyecto real. No necesitas ser programador. Solo necesitas pedírselo a Claude.
Empieza con un commit. Sube a GitHub. Y a partir de ahí, cada cambio queda registrado para siempre.
Siguiente lectura: API keys y variables de entorno en Claude Code | Ver la guía completa