Git Remote
Última actualización
git remote gestiona los nombres abreviados que tu repositorio usa para los repositorios remotos - lo más habitual es origin, que apunta a tu repositorio de GitHub. Lo usas para añadir un remoto al empezar, listar los que tienes, renombrarlos o eliminarlos, y cambiar la URL de un remoto (por ejemplo, cambiar de HTTPS a SSH).
Prueba esto en el terminal playground - una shell real en tu navegador, sin nada que instalar.
Sintaxis
| Command | What it does |
|---|---|
git remote -v | Lista los remotos con sus URLs |
git remote add origin <url> | Añade un remoto llamado origin |
git remote set-url origin <url> | Cambia la URL de un remoto |
git remote rename origin upstream | Renombra un remoto |
git remote remove origin | Elimina un remoto |
git remote show origin | Muestra detalles sobre un remoto |
Casos comunes
| Goal | Command |
|---|---|
| Conectar un repositorio nuevo a GitHub | git remote add origin <url> |
| Cambiar de HTTPS a SSH | git remote set-url origin git@github.com:... |
| Comprobar a dónde apunta origin | git remote -v |
Ejemplo práctico
| Paso | Comando | Resultado |
|---|---|---|
| 1 | git remote add origin https://github.com/you/app.git | Registra el repositorio de GitHub bajo el nombre origin |
| 2 | git remote -v | Lista origin con sus URL de fetch y de push |
| 3 | git push -u origin main | Sube main y hace que siga a origin/main |
Preguntas frecuentes sobre git remote
¿Qué es un remoto de Git?
Un remoto es una referencia con nombre a un repositorio alojado en otro lugar - normalmente en GitHub, GitLab o un servidor. El nombre por defecto es
origin. Los remotos son con lo que sincronizan git push, git pull y git fetch. git remote es el comando para gestionar esas referencias con nombre.¿Cómo añado un remoto?
Ejecuta
git remote add origin <url>, usando la URL del repositorio. Esto vincula tu repositorio local al remoto con el nombre origin. Después puedes hacer push con git push -u origin main. Usa un nombre distinto (como upstream) si origin ya está en uso.¿Cómo cambio la URL de un remoto?
Usa
git remote set-url origin <new-url>. Así es como cambias un repositorio de una URL HTTPS a una SSH (o la actualizas tras renombrar un repositorio) sin eliminar y volver a añadir el remoto. Verifícalo con git remote -v.¿Cómo veo mis remotos?
Ejecuta
git remote -v para listar cada remoto con sus URLs de fetch y push. Para una vista detallada de un remoto - incluidas sus ramas rastreadas - usa git remote show origin.¿Qué hace git remote add origin?
Guarda una URL bajo el nombre
origin en la configuración de tu repositorio. Todavía no se sube ni se descarga nada: el comando solo crea el nombre, para que después puedas escribir git push origin main en lugar de la URL completa. Si origin ya existe, Git se niega con "remote origin already exists"; usa git remote set-url origin <url> para que apunte a otro sitio.¿Cuál es la diferencia entre origin y upstream?
Los dos son solo nombres convencionales.
origin es el remoto del que clonaste o al que subiste primero, normalmente tu propia copia. Cuando haces un fork de un proyecto, el repositorio original se suele añadir como segundo remoto llamado upstream con git remote add upstream <url>, para descargar sus cambios mientras subes a tu fork.¿Cómo descargo una rama de un remoto?
Ejecuta
git fetch origin para descargar todas las ramas y luego git switch <branch> para crear una rama local que siga a origin/<branch>. La página cambiar a una rama remota cubre las variantes.¿Puedo practicar esto en línea?
Sí. Abre el terminal playground para ejecutar
git remote en una shell real en tu navegador - sin nada que instalar. El curso interactivo y gratuito de Git de Coddy también cubre la conexión a remotos paso a paso.Recursos relacionados
Más comandos de Git
