Como subir un proyecto local a github

como-subir-un-proyecto-local-a-github.md

Cómo subir un proyecto local a GitHub

Una guía rápida para subir a GitHub un proyecto que ya tienes en tu equipo.

1. Crear un repositorio vacío en GitHub

Crea un nuevo repositorio en GitHub.

Indica:

• nombre del repositorio;
• descripción, si quieres;
• si será público o privado.

Para este procedimiento es más sencillo crear el repositorio vacío:

• no añadas README;
• no añadas .gitignore;
• no añadas licencia.

Así evitamos que el repositorio remoto tenga commits que todavía no existen en nuestro proyecto local.

2. Abrir una terminal en la carpeta del proyecto

Sitúate en la carpeta raíz de tu proyecto.

Por ejemplo:

cd mi-proyecto

3. Inicializar Git

git init -b main

Esto crea un repositorio Git local y utiliza main como rama principal.

4. Añadir los archivos

git add .

Puedes comprobar qué se va a incluir con:

git status

5. Crear el primer commit

git commit -m "Initial commit"

6. Conectar el proyecto con GitHub

Copia la URL HTTPS del repositorio que acabas de crear.

Tendrá una forma similar a:

https://github.com/USUARIO/REPOSITORIO.git

Añádela como remoto:

git remote add origin https://github.com/USUARIO/REPOSITORIO.git

Puedes comprobarlo con:

git remote -v

7. Subir el proyecto

git push -u origin main

La opción -u deja configurada la relación entre tu rama local main y la rama remota.

A partir de ese momento, normalmente podrás utilizar simplemente:

git push

---

Después del primer push

Cuando hagas nuevos cambios en tu proyecto:

git add .
git commit -m "Descripción del cambio"
git push

No necesitas volver a ejecutar git init ni volver a crear origin.

---

Problemas frecuentes

git: command not found o 'git' no se reconoce como un comando

Git no está instalado o no está disponible en el PATH.

Comprueba primero:

git --version

Si el comando no existe, instala Git y vuelve a abrir la terminal.

En Windows puedes instalar Git for Windows desde:

https://git-scm.com/

---

Author identity unknown

Git necesita saber qué nombre y correo debe asociar a tus commits.

Configúralos:

git config --global user.name "Tu nombre"
git config --global user.email "tu-email@example.com"

Puedes comprobar la configuración con:

git config --global user.name
git config --global user.email

Si utilizas GitHub y no quieres publicar tu dirección de correo real en los commits, puedes utilizar la dirección noreply que GitHub proporciona en la configuración de tu cuenta.

---

error: remote origin already exists

Tu repositorio ya tiene un remoto llamado origin.

Comprueba cuál es:

git remote -v

Si la URL es correcta, no necesitas hacer nada.

Si necesitas cambiarla:

git remote set-url origin https://github.com/USUARIO/REPOSITORIO.git

Después comprueba de nuevo:

git remote -v

---

He utilizado master pero GitHub utiliza main

Comprueba primero en qué rama estás:

git branch --show-current

Si tu rama local se llama master y quieres renombrarla a main:

git branch -M main

Después:

git push -u origin main

---

repository not found

Comprueba la URL configurada:

git remote -v

Debería tener una forma similar a:

https://github.com/USUARIO/REPOSITORIO.git

Un error frecuente es copiar la URL de una página o de un archivo en vez de la URL del repositorio.

Por ejemplo, una URL que contiene algo como:

/blob/main/...

no es la URL que debes utilizar como remoto.

También comprueba:

• que el repositorio existe;
• que el nombre de usuario es correcto;
• que tienes permisos para acceder a él;
• que estás autenticado con la cuenta adecuada.

---

Error 403 o Git intenta utilizar otra cuenta de GitHub

Puede ocurrir que Git tenga almacenadas credenciales de otra cuenta.

Comprueba primero que el repositorio y la URL son correctos:

git remote -v

Si utilizas HTTPS, Git normalmente gestiona las credenciales mediante Git Credential Manager.

En Windows, si tienes guardada una cuenta incorrecta, puedes revisar las credenciales almacenadas en el Administrador de credenciales de Windows y volver a autenticarte con la cuenta correcta.

---

GitHub me pide usuario y contraseña

GitHub ya no permite utilizar la contraseña normal de tu cuenta para autenticar operaciones Git mediante HTTPS.

Puedes utilizar, entre otras opciones:

• Git Credential Manager;
• GitHub CLI;
• un Personal Access Token;
• SSH.

En Windows, Git for Windows suele incluir Git Credential Manager y permite autenticarte mediante el navegador.

---

nothing to commit, working tree clean

No es necesariamente un error.

Significa que Git no detecta cambios pendientes de guardar en un commit.

Compruébalo con:

git status

Si acabas de modificar archivos y Git no los detecta, revisa también tu archivo .gitignore.

---

src refspec main does not match any

Normalmente aparece cuando intentas hacer push antes de tener algún commit o cuando la rama no se llama main.

Comprueba:

git status
git branch --show-current

Si todavía no has creado ningún commit:

git add .
git commit -m "Initial commit"

Después:

git push -u origin main

---

failed to push some refs / non-fast-forward

Esto suele significar que el repositorio remoto contiene cambios que tu copia local todavía no tiene.

Puede ocurrir, por ejemplo, si al crear el repositorio en GitHub añadiste un README, una licencia o algún otro archivo.

No utilices automáticamente:

git push -f

Un push forzado puede sobrescribir el historial remoto.

Primero revisa el estado:

git status
git remote -v
git branch --show-current

Y recupera los cambios del remoto:

git pull origin main

Si Git detecta conflictos tendrás que resolverlos antes de continuar.

Después:

git push

Si estás empezando desde cero, normalmente es más sencillo crear inicialmente el repositorio remoto vacío, como se explica al principio de esta guía.

---

He hecho el push pero no veo mis archivos en GitHub

Comprueba primero:

git status
git branch --show-current
git remote -v

Después revisa qué rama estás viendo en GitHub.

Por ejemplo, si has subido:

git push -u origin main

pero estás visualizando otra rama, parecerá que tus archivos no están allí.

También puedes comprobar tus últimos commits:

git log --oneline -5

---

Quiero subir cambios después del primer commit

No vuelvas a ejecutar todo el procedimiento.

Simplemente:

git add .
git commit -m "Descripción del cambio"
git push

---

Quiero subir una nueva rama

Créala:

git switch -c nombre-rama

Haz tus cambios y crea el commit:

git add .
git commit -m "Descripción del cambio"

Sube la nueva rama:

git push -u origin nombre-rama

A partir de entonces:

git push

---

Tres comandos útiles para diagnosticar problemas

Si algo no funciona y necesitas pedir ayuda, estos tres comandos suelen aportar bastante información:

git status
git branch --show-current
git remote -v

También puede ser útil conocer la versión instalada:

git --version

Con esa información es mucho más fácil entender qué está ocurriendo que probar comandos al azar.

Nota: esta guía se actualizó en 2026 incorporando problemas y dudas recurrentes aparecidos en los comentarios a lo largo de los años.

Cuando publiqué este gist hace años era simplemente una pequeña chuleta para resolver una tarea muy básica: subir un proyecto local a GitHub.

No esperaba que terminara siendo útil para tanta gente ni que durante todos estos años siguierais llegando aquí, dejando preguntas, respuestas, correcciones y soluciones.

Me hace especial ilusión ver que ha servido sobre todo a personas que estaban empezando con Git y GitHub. Todos hemos pasado por ese momento en el que algo que parece obvio después no lo es en absoluto cuando lo haces por primera vez.

Gracias a todos los que habéis participado en los comentarios, tanto preguntando como ayudando a otros.

En 2026 he actualizado el gist manteniendo la idea original —que siga siendo una guía sencilla— y he añadido una sección de problemas frecuentes basada precisamente en muchas de las dudas que habéis ido planteando aquí durante estos años.

Gracias de verdad por haber convertido una pequeña nota en algo útil para tanta gente. ❤️