441 palabras

2 minutos

Setup de Git y GitHub — Configuración completa

2025-09-24

Git

/

GitHub

/

CLI

/

Setup

/

SSH

Setup de Git y GitHub#

Esta guía está pensada para ayudarte a configurar Git y GitHub desde cero, de manera que puedas trabajar cómodamente con repositorios. Es el setup básico que necesitas antes de empezar cualquier proyecto.

1. Instalar Git CLI#

Windows#

Ve a git-scm.com y descarga el instalador. Durante la instalación:

Deja las opciones por defecto
Asegúrate de marcar “Git Bash Here” para tener terminal integrada

macOS#

Tienes varias opciones:

Con Homebrew (recomendado):

1
brew install git

Descarga directa: git-scm.com/download/mac

Linux (Ubuntu/Debian)#

1
sudo apt update
2
sudo apt install git

Verificar instalación#

1
git --version

2. Instalar GitHub CLI (gh)#

Windows#

Con winget:

1
winget install --id GitHub.cli

O descarga desde: cli.github.com

macOS#

Con Homebrew:

1
brew install gh

Linux#

1
# Ubuntu/Debian
2
sudo apt update
3
sudo apt install gh
4

5
# O con snap
6
sudo snap install gh

Verificar instalación#

1
gh --version

3. Autenticación con GitHub#

1
gh auth login

Te preguntará:

¿Qué cuenta? → GitHub.com
¿Protocolo preferido? → SSH (recomendado)
¿Generar clave SSH? → Yes (si no tienes una)
¿Título para la clave? → Deja el por defecto o pon algo como “Mi PC”
¿Cómo autenticarte? → Login with a web browser

Paso 2: Verificar autenticación#

1
gh auth status

Deberías ver algo como:

1
✓ Logged in to github.com as tu-usuario (keyring)
2
✓ Git operations for github.com configured to use ssh protocol.

Paso 3: Verificar clave SSH#

1
ssh -T git@github.com

Si funciona verás:

1
Hi tu-usuario! You've successfully authenticated, but GitHub does not provide shell access.

4. Configurar Git (usuario y email)#

Configura tu identidad para los commits:

1
git config --global user.name "Tu Nombre"
2
git config --global user.email "tu-email@ejemplo.com"

IMPORTANT
Usa el mismo email y username que tienes en GitHub.

Verificar configuración#

1
git config --global --list

5. Comandos básicos para trabajar#

Ya tienes todo listo. Los comandos que más usarás:

Clonar un repositorio#

1
git clone git@github.com:usuario/repositorio.git
2
cd repositorio

Inicializar un proyecto nuevo#

1
# Crear carpeta y entrar
2
mkdir mi-proyecto
3
cd mi-proyecto
4

5
# Inicializar Git
6
git init

Workflow básico de trabajo#

1
# 1. Ver estado de archivos
2
git status
3

4
# 2. Añadir archivos al staging
5
git add archivo.txt        # Un archivo específico
6
git add .                  # Todos los archivos modificados
7

8
# 3. Hacer commit
9
git commit -m "Mensaje descriptivo del cambio"
10

11
# 4. Subir cambios
12
git push

Comandos adicionales útiles#

1
# Ver historial de commits
2
git log --oneline
3

4
# Ver diferencias
5
git diff
6

7
# Crear rama nueva
8
git checkout -b nueva-rama
9

10
# Cambiar de rama
11
git checkout main
12

13
# Ver ramas
14
git branch
15

16
# Descargar cambios del repositorio remoto
17
git pull
18

19
# Deshacer cambios (git reset y git restore)
20
git reset archivo.txt           # Quitar archivo del staging
21
git reset --soft HEAD~1         # Deshacer último commit (mantiene cambios)
22
git reset --hard HEAD~1         # Deshacer último commit (BORRA cambios)
23
git reset --hard origin/main    # Resetear a la versión remota
24

25
# Restaurar archivos (git restore - más moderno)
26
git restore archivo.txt         # Descartar cambios no guardados
27
git restore --staged archivo.txt # Quitar archivo del staging
28
git restore --source=HEAD~1 archivo.txt # Restaurar desde commit anterior