Git para IA, quickstart en 30 minutos

Cuando construyes con Claude Code o Cursor, Git deja de ser "control de versiones para equipos de software". Se convierte en un cinturón de seguridad. La IA cambia ocho archivos en segundos, el undo del editor no te salva, y sin un save state te tiras una hora limpiando. Este playbook te lleva de "no tengo Git instalado" a "que la IA haga lo que quiera, estoy protegido" en 30 minutos.

Vamos por tres bloques. Bloque 1, setup y tu primer repo. Bloque 2, disciplina de branches. Bloque 3, el servidor MCP de GitHub para que Claude hable directamente con tu GitHub. Si ya tienes un repo, salta el Bloque 1.

El mismo contenido vive con más detalle en las tres lecciones del Nivel 1 (8, 9, 10). Este playbook es la versión speedrun con todos los comandos juntos.

Bloque 1, setup y primer repo (10 minutos)

Dos cosas en tu máquina. Git en sí: Mac brew install git, Windows el instalador de git-scm.com con ajustes por defecto, Linux sudo apt install git. Y una interfaz gráfica para no tener que empezar con línea de comandos. Recomendación: GitHub Desktop desde desktop.github.com, gratis, muy amigable para principiantes.

Cuenta de GitHub en github.com. Gratis, confirma email. Elige un username que pondrías en una tarjeta de visita.

Primer repo. En GitHub Desktop arriba a la izquierda File, New Repository. Le pones nombre, eliges una ubicación, marcas "Initialize with README", "Create repository". Ya tienes una carpeta en disco con un README dentro.

Primer cambio. Abre el README en un editor, escribe "Hello world", guarda. En GitHub Desktop ves el archivo con un punto amarillo a la izquierda. Abajo a la izquierda un mensaje de commit corto, "primer cambio", click en "Commit to main". Primer save state hecho.

Push a GitHub. Arriba en GitHub Desktop "Publish repository", marca "Keep this code private", "Publish". 30 segundos después tu repo está en github.com/tu-usuario/tu-repo. Backup listo.

Tu nuevo flujo por defecto antes de cualquier sesión de IA: asegúrate de que el repo esté abierto, haz commit de lo pendiente con un mensaje corto, y deja que la IA construya. Si la IA rompe algo, en GitHub Desktop click en "Discard all changes". Estás de vuelta en el último commit.

Bloque 2, disciplina de branches (10 minutos)

Los branches son el patrón que de verdad te da paz mental. En vez de trabajar directamente sobre main, creas un branch separado para cada tarea grande de IA. Si la tarea sale mal, borras el branch. Tu original nunca se toca.

En GitHub Desktop arriba en el centro hay un dropdown de branch. Click, "New branch", le pones nombre (por ejemplo feature/login-form), "Create branch". Ya estás en el nuevo branch.

Ahora dejas que Claude construya. Tres resultados posibles.

Uno, funciona y te gusta. Mira el diff (click en los archivos modificados a la izquierda en GitHub Desktop, el lado derecho muestra el diff línea por línea). Si el diff se ve limpio, commit, vuelve a main, hace merge del branch.

Dos, funciona a medias y quieres seguir iterando. Commit en el branch, sigue trabajando, merge más tarde cuando encaje.

Tres, basura. Vuelve a main, borra el branch. No perdiste nada.

Leer el diff es la disciplina infravalorada. Antes de hacer commit, míralo durante un minuto. Buscas tres cosas. ¿La IA cambió cosas que tú no pediste? (refactor por la cara es el clásico). ¿Faltan archivos que necesitas? (la IA a veces borra código "sin uso" que se llama desde otro sitio). ¿Hay secretos ahí dentro? (API keys, contraseñas, contenido de .env). Si haces commit y push de eso, queda en internet para siempre.

Un aviso importante. Si le dices a Claude Code "¿puedes deshacer eso?", puede ejecutar git reset --hard. Eso es destructivo, todos los cambios sin commit se van. Hay un bug report oficial al respecto (Issue 17190 de enero de 2026). Usa o el revert por GUI (click derecho en el commit, "Revert this commit") o el comando /rewind integrado de Claude (alias /checkpoint), que hace rollback de código y conversación a un punto anterior. Nunca des órdenes vagas tipo "deshazlo".

Disciplina de commits. Haz más commits, más cortos. Los principiantes suelen construir una hora y luego un commit gigante "todo hecho". Si algo se rompe, el rollback sale más caro de lo necesario. Regla práctica: commit corto antes de CADA tarea que le des a la IA.

Bloque 3, servidor MCP de GitHub (10 minutos)

La siguiente palanca. En vez de cambiar entre editor y navegador, le das a Claude acceso directo a tu GitHub. Leer issues, abrir pull requests, depurar pipelines de CI, recorrer alertas de Dependabot, todo por voz desde la conversación.

Crear un personal access token. En github.com, arriba a la derecha click en tu avatar, Settings, Developer settings (abajo a la izquierda), Personal access tokens, "Tokens (classic)", "Generate new token". Note "Claude MCP Server", Expiration 90 días (NO "no expiration"), Scopes mínimo repo y read:org. Si además quieres conducir GitHub Actions, añade workflow. Click en "Generate token". Copia la cadena larga ghp_... a un gestor de contraseñas AHORA, GitHub no la muestra otra vez.

Instalar en Claude Code. En tu terminal:

claude mcp add --transport http github https://api.githubcopilot.com/mcp \
  --header "Authorization: Bearer ghp_TU_TOKEN_AQUI"

Esa es la sintaxis oficial de la documentación de Claude Code. La URL api.githubcopilot.com/mcp funciona sin suscripción a GitHub Copilot, el nombre solo confunde por razones históricas.

Instalar en Claude Desktop. A fecha de 2026, Claude Desktop todavía no soporta la variante hosted vía OAuth. Necesitas la variante local con Docker. Requisito: Docker Desktop instalado. Luego en claude_desktop_config.json (Mac bajo ~/Library/Application Support/Claude/, Windows bajo %APPDATA%\Claude\, Linux bajo ~/.config/Claude/):

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_TU_TOKEN_AQUI"
      }
    }
  }
}

Reinicia Claude Desktop. En la lista de herramientas deberías ver "github" ahora.

Tres ejemplos que muestran el valor inmediatamente. "Lee el issue 42 de mi repo y propón una implementación" deja a Claude leer el issue, mirar el código vinculado, escribir un plan. "¿Qué falló en la última ejecución del workflow de main?" hace que Claude recorra los logs de GitHub Actions y te dé el error exacto. "¿Qué alertas de Dependabot están abiertas en mis repos, y cuáles son críticas?" ordena tus hallazgos de seguridad.

Notas de seguridad. El PAT es como una contraseña, nunca lo commitees ni lo pegues en Slack. Mantén los scopes mínimos, solo lo que de verdad necesitas. Los fine-grained personal access tokens son preferibles a los classic PATs porque son configurables por repo y expiran automáticamente.

Qué tienes ahora

Setup hecho, flujo de branches asentado, GitHub MCP hablando con Claude. A partir de ahora, cuando la IA hace algo tonto, te cuesta un segundo borrar el branch en vez de una hora limpiando. Cuando la IA hace algo bueno, lo fusionas limpio en main con un historial.

Si quieres ir más profundo, mira las tres lecciones del Nivel 1 (8, 9, 10). El mismo material con más detalle, con la metáfora del save-game y más contexto. Más las recipes 2.5, 3.6 y 3.7 son las versiones paso a paso para cuando necesitas buscar algo concreto otra vez.