Cómo configurar claves SSH en Windows 11 y conectarte a GitHub sin contraseña

Si todavía escribes tu usuario y contraseña cada vez que haces git push, estás perdiendo tiempo y usando un método menos seguro. Windows 11 incluye un cliente OpenSSH integrado que permite generar claves SSH y autenticarte con GitHub (o cualquier servidor) sin contraseñas.

Esta guía cubre todo el proceso: desde la generación de la clave hasta la verificación de la conexión.

Requisitos previos

• Windows 10 (versión 1809+) o Windows 11.
• Una cuenta en GitHub.
• Acceso a PowerShell o Windows Terminal.

Paso 1: Verificar que OpenSSH está instalado

Abre PowerShell y ejecuta:

ssh -V

Deberías ver algo como OpenSSH_for_Windows_9.x. Si no aparece, ve a Configuración > Sistema > Características opcionales y busca "Cliente OpenSSH" para instalarlo.

Paso 2: Comprobar si ya tienes claves SSH

Antes de crear nuevas claves, revisa si ya existen:

ls $env:USERPROFILE\.ssh\

Si ves archivos como id_ed25519 e id_ed25519.pub, ya tienes un par de claves. Si la carpeta no existe o está vacía, continúa al siguiente paso.

Paso 3: Generar una clave SSH con Ed25519

Ed25519 es el algoritmo recomendado actualmente: más rápido, más seguro y con claves más cortas que RSA.

ssh-keygen -t ed25519 -C "tu_email@ejemplo.com"

El sistema te preguntará:

1. Ubicación del archivo: presiona Enter para aceptar la ruta predeterminada (C:\Users\TuUsuario\.ssh\id_ed25519).
2. Passphrase: escribe una contraseña para proteger la clave (recomendado) o presiona Enter para dejarla vacía.

Al terminar, se generan dos archivos:

Paso 4: Activar el agente SSH

El agente SSH almacena tu clave en memoria para que no tengas que escribir la passphrase en cada operación.

Abre PowerShell como administrador y ejecuta:

Set-Service ssh-agent -StartupType Automatic
Start-Service ssh-agent

Después, agrega tu clave privada al agente:

ssh-add $env:USERPROFILE\.ssh\id_ed25519

Si configuraste una passphrase, te la pedirá una sola vez.

Paso 5: Copiar la clave pública

Ejecuta este comando para copiar tu clave pública al portapapeles:

Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard

Paso 6: Agregar la clave en GitHub

1. Ve a github.com/settings/keys.
2. Haz clic en New SSH key.
3. En Title, escribe un nombre descriptivo (ejemplo: Laptop-Windows11-2026).
4. En Key, pega el contenido del portapapeles.
5. Haz clic en Add SSH key.

Paso 7: Verificar la conexión

Ejecuta:

ssh -T git@github.com

Si todo está bien, verás un mensaje como:

Hi tu_usuario! You've successfully authenticated, but GitHub does not provide shell access.

Paso 8: Configurar Git para usar SSH

Si tus repositorios actuales usan HTTPS, cámbialos a SSH:

git remote set-url origin git@github.com:tu_usuario/tu_repositorio.git

Verifica con:

git remote -v

A partir de ahora, git push y git pull funcionarán sin pedirte credenciales.

Errores comunes y soluciones

"Permission denied (publickey)": tu clave no está registrada en GitHub o no se cargó en el agente. Ejecuta ssh-add -l para verificar que el agente tiene tu clave.

"Could not open a connection to your authentication agent": el servicio ssh-agent no está corriendo. Repite el Paso 4.

Conexión bloqueada en el puerto 22: algunas redes corporativas o universidades bloquean ese puerto. Crea el archivo ~/.ssh/config con este contenido:

Host github.com
  Hostname ssh.github.com
  Port 443
  User git

Múltiples claves para distintos servicios: usa el archivo ~/.ssh/config para asignar claves específicas:

Host github.com
  IdentityFile ~/.ssh/id_ed25519_github

Host gitlab.com
  IdentityFile ~/.ssh/id_ed25519_gitlab

Buenas prácticas

• Usa siempre una passphrase. Con el agente SSH activo, solo la escribes una vez por sesión.
• Nombra tus claves de forma descriptiva si manejas varias: id_ed25519_github, id_ed25519_trabajo, etc.
• Rota tus claves al menos una vez al año. Elimina las que ya no uses tanto en tu equipo como en GitHub.
• Nunca copies tu clave privada a otro equipo por canales inseguros. Genera una nueva en cada máquina.

Idea clave

Las claves SSH no solo eliminan la fricción de escribir contraseñas: son un estándar de seguridad superior. Si trabajas con Git, servidores remotos o despliegues automatizados, configurarlas correctamente en Windows 11 es una inversión de 10 minutos que mejora tu flujo de trabajo de forma permanente.