~/docs /Github

Github

Github

Imported from Notion: Github

updated:: 2026.07.10

child_page Recuperación Nested page shared through Notion.
child_page Branches Nested page shared through Notion.
info

Esta guía cubre la configuración inicial de GitHub con un repositorio local y el primer flujo de trabajo básico entre tu máquina y GitHub. Úsala cuando vayas a crear el remoto, enlazarlo con tu proyecto y publicar el primer commit.

1) Resumen rápido

  • Crea el repositorio en GitHub.

  • Inicializa Git en tu proyecto local.

  • Configura tu usuario y correo.

  • Añade el remoto.

  • Haz tu primer commit y súbelo con push.

  • A partir de ahí, repite la rutina básica: add → commit → push.

important

Esta página no entra en ramas, tags ni recuperación de cambios perdidos. Si buscas eso, usa las páginas específicas de Branches o Recuperación.

2) Primer setup

2.1 Crear el repositorio en GitHub

  1. Entra a GitHub y crea un nuevo repositorio público o privado.

  2. Si ya tienes un proyecto local, no lo inicialices con README, .gitignore ni licencia desde GitHub para evitar conflictos al primer push.

https://github.com/tu-user/tu-repo
validated

Si vas a trabajar con un proyecto ya existente en local, deja el repositorio remoto vacío para que el primer push sea limpio.

2.2 Inicializar Git en tu proyecto local

En la carpeta de tu proyecto:

cd /ruta/de/tu/proyecto
git init

Si todavía no existe un historial Git, esto creará el repositorio local y preparará la carpeta para registrar cambios.

2.3 Configurar usuario y correo

Si aún no lo has hecho, configura tu identidad de Git:

git config --global user.name "TuNombre"
git config --global user.email "tuemail@example.com"
important

Usa el mismo correo que tienes en GitHub si quieres que tus commits queden vinculados a tu cuenta.

main vs master

En la mayoría de repositorios nuevos, la rama principal se llama main. master todavía puede aparecer en proyectos antiguos, pero hoy el nombre más habitual y recomendado para repos nuevos es main.

tip

Si tu repositorio remoto usa otra rama principal, adapta los comandos a ese nombre.

2.4 Añadir el remoto de GitHub

Puedes conectar el repositorio local con GitHub usando HTTPS o SSH.

Opción A: HTTPS

git remote add origin https://github.com/tu-usuario/tu-repo.git

Opción B: SSH

git remote add origin git@github.com:tu-usuario/tu-repo.git
warning

Si usas HTTPS, Git puede pedirte usuario y contraseña. En GitHub, la contraseña se sustituye por un Personal Access Token (PAT). Genera uno desde GitHub y usa el token como credencial cuando se solicite.

Token y credenciales

Genera un token en la configuración de GitHub y da permisos mínimos necesarios para tu caso. Como referencia general, para repositorios privados suele hacer falta acceso a repo, y workflow solo si vas a trabajar con automatizaciones o CI.

critical

Evita credential.helper store si no quieres guardar credenciales en texto plano en tu equipo. Si prefieres no persistirlas así, usa el gestor de credenciales del sistema o un flujo con SSH.

git config --global credential.helper store

Este comando guarda credenciales localmente para no volver a escribirlas en cada operación, pero no es la opción más segura.

2.5 Comprobar el remoto

git remote -v

Deberías ver el nombre origin apuntando a tu URL de GitHub.

validated

Si necesitas cambiar la URL más tarde, usa git remote set-url origin ....

3) Primer commit

3.1 Revisar el estado

Antes de registrar cambios, comprueba qué archivos están listos para añadirse:

git status

3.2 Añadir archivos al staging

git add .

3.3 Crear el commit

git commit -m "Primer commit"
validated

Escribe mensajes claros y breves. El mensaje debe explicar qué cambió, no solo que “hubo cambios”.

4) Subir el proyecto a GitHub

4.1 Asegurar el nombre de la rama principal

Si el repositorio nuevo todavía no usa main, puedes renombrar la rama actual:

git branch -M main

4.2 Publicar la rama en GitHub

git push -u origin main

-u deja configurada la relación entre tu rama local y la rama remota para que, a partir de ahí, basten git push y git pull.

tip

Si el repositorio ya tenía historial previo, revisa que la rama local y la remota coincidan antes de empujar cambios.

5) Flujo de trabajo básico

Después del primer push, la rutina normal suele ser esta:

git add .
git commit -m "Descripción de los cambios"
git push

Si quieres traer cambios desde GitHub a tu copia local:

git pull

pull vs fetch

  • git fetch descarga los cambios del remoto, pero no los aplica automáticamente a tu rama actual.

  • git pull hace fetch y luego integra esos cambios en tu rama.

important

Usa fetch cuando quieras revisar primero qué cambió. Usa pull cuando quieras actualizar tu rama local directamente.

6) Flujo recomendado

  1. Crea el repositorio remoto en GitHub.

  2. Inicializa Git en local con git init.

  3. Configura usuario y correo.

  4. Añade el remoto con origin.

  5. Haz git add y git commit.

  6. Publica con git push -u origin main.

  7. A partir de ahí, repite add → commit → push.

  8. Usa git pull para sincronizar tu copia local con GitHub cuando sea necesario.

7) Resumen rápido

  • git init crea el repositorio local.

  • git remote add origin ... enlaza tu proyecto con GitHub.

  • git add + git commit registran cambios.

  • git push -u origin main publica el primer historial.

  • git pull trae cambios desde GitHub a tu máquina.

  • credential.helper store guarda credenciales en claro; úsalo solo si aceptas ese riesgo.

- EOF -