7. Repositorios remotos y GitHub

Añadir un repositorio de GitHub como remoto

Ahora que tenemos un repositorio de GitHub, necesitamos conectarlo con nuestro repositorio local. Eso nos permitirá hacer push de nuestros cambios locales a GitHub y hacer pull de los cambios hechos en GitHub.

Hay dos formas habituales de trabajar con repositorios remotos:

  1. Proyectos nuevos. Empiezas en local, creas un repositorio nuevo con

    . Cuando ya has avanzado un poco, conectas el repositorio local a un remoto para compartir tu trabajo con otras personas (o simplemente para tener una copia de seguridad).

  2. Proyectos existentes. Imagina que te has comprado un ordenador nuevo y quieres seguir trabajando en un proyecto que ya existe y que ya se ha sincronizado con un repositorio remoto. En este caso, en vez de git init, usas

    para crear una copia local del repositorio remoto. A partir de ahí, trabajas como siempre.

Aquí vamos a seguir el primer enfoque: ya tenemos un repositorio local con nuestro trabajo y ahora queremos conectarlo con GitHub.

¿Cómo se hace?

Para conectar un repositorio local con GitHub, necesitamos añadir el repositorio de GitHub como remoto dentro de nuestro repositorio local. Un remoto es, básicamente, un marcador que apunta a la URL donde está alojado un repositorio.

El nombre predeterminado del primer remoto suele ser origin, aunque puedes llamarlo como quieras. Aun así, la convención es usar origin para el repositorio remoto principal.

Para añadir un remoto, ejecuta

, seguido del nombre del remoto y la URL del repositorio. En nuestro caso, el comando debería tener este aspecto:

Ejecuta en la terminal:
git remote add origin https://github.com/your-name/your-repo.git
Tarea
Completada

Añade el repositorio de GitHub a tu repositorio local como un remoto llamado origin usando el comando anterior.

Para comprobar que el remoto se ha añadido correctamente, puedes ejecutar

(-v es la abreviatura de --verbose, que significa mostrar más detalles), y Git te enseñará una lista de todos los remotos y sus URLs.

Ejecuta en la terminal:
git remote -v

Deberías ver algo parecido a esto:

Resultado:

origin https://github.com/your-name/your-repo.git (fetch) origin https://github.com/your-name/your-repo.git (push)

Si te has equivocado en la URL, puedes quitar el remoto con git remote remove <remote-name>, donde <remote-name> es origin o el nombre que hayas usado. Después, vuelve a añadirlo con la URL correcta.

Tarea
Completada

Comprueba que el remoto origin se ha añadido correctamente.

¡Genial! Has conectado correctamente tu repositorio local con GitHub.

Un repositorio puede tener varios remotos, cada uno apuntando a una URL distinta. Esto es útil si quieres hacer push a varios repositorios o hacer pull desde varios repositorios.
Next step
¿Quieres probar el modo historia?

Haz el curso como se pensó: avanza poco a poco y en orden, sin distracciones, mientras desbloqueas nuevas entradas de Gitopedia. Cuando quieras, continúa practicando con Git de verdad en VS Code, Cursor o Antigravity IDE.

Modo historia
GRATIS
pero requiere iniciar sesión