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á enviar nuestros cambios locales a GitHub y traer al repositorio local 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. Después trabajas con ella como harías normalmente.

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 como un remoto llamado origin para tu repositorio local usando el comando anterior.

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

(-v es la forma corta 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 un remoto con git remote remove <remote-name> (donde <remote-name> es origin u otro nombre que hayas usado para tu remoto) y luego volver 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 enviar cambios a varios repositorios o traer cambios desde varios repositorios.
Next step
¿Quieres probar el modo historia?

Haz el curso como estaba pensado: progreso en pequeñas dosis, un orden lineal y sin distracciones, y entradas de Gitopedia que se desbloquean poco a poco. Continúa con Git real en VS Code/Cursor/Antigravity/Windsurf cuando quieras.

Modo historia
GRATIS
pero requiere iniciar sesión