TutorialesTutorials · PrincipianteBeginner

GitHub para principiantes: el centro de todo lo que construyes con IAGitHub for beginners: the hub of everything you build with AI

Qué es GitHub, por qué es el centro de tus proyectos y cómo empezar: crea tu cuenta, instala Git, conéctalo a VS Code y guarda tu primer proyecto con commits y push.What GitHub is, why it's the hub of your projects, and how to start: create your account, install Git, connect it to VS Code and save your first project with commits and push.

  • GitHub
  • Git
  • VS Code

GitHub es el centro de todo lo que construyes: conecta tu editor (VS Code), tu asistente de IA (Claude Code) y tu publicación en línea (Vercel). Tu código vive ahí, guarda cada versión y, cada vez que subes un cambio, tu sitio se actualiza solo.

En esta guía vas a crear tu cuenta, instalar Git, conectarlo a VS Code y guardar tu primer proyecto. Elige tu sistema (Windows o Mac) con los botones de arriba y toca cada paso para abrirlo.

GitHub is the hub of everything you build: it connects your editor (VS Code), your AI assistant (Claude Code) and your online publishing (Vercel). Your code lives there, it saves every version, and every time you push a change your site updates itself.

In this guide you’ll create your account, install Git, connect it to VS Code and save your first project. Pick your system (Windows or Mac) with the buttons above and tap each step to open it.

Git vs GitHub (en 10 segundos)Git vs GitHub (in 10 seconds)
  • Git es la herramienta en tu computadora que guarda versiones de tu código.
  • GitHub es la página web donde subes y compartes esos proyectos (y desde donde se publican).

Piensa: Git es la cámara 📸 y GitHub es el álbum en la nube.

  • Git is the tool on your computer that saves versions of your code.
  • GitHub is the website where you upload and share those projects (and where they get published from).

Think: Git is the camera 📸 and GitHub is the cloud album.

1 Crear tu cuenta de GitHubCreate your GitHub account
  1. Entra a https://github.com
  2. Aprieta “Sign up” (Registrarte).
  3. Pon tu correo, una contraseña y un nombre de usuario (será parte de tus enlaces, ej. github.com/tu-usuario).
  4. Confirma tu correo. ¡Listo, ya tienes cuenta!

El plan gratis incluye repositorios ilimitados (públicos y privados). No necesitas pagar para esta guía.

  1. Go to https://github.com
  2. Click “Sign up”.
  3. Enter your email, a password and a username (it becomes part of your links, e.g. github.com/your-username).
  4. Confirm your email. Done, you have an account!

The free plan includes unlimited repositories (public and private). You don’t need to pay for this guide.

2 Instalar GitInstall Git

Git es lo que crea las “versiones” de tu código en tu computadora.

  1. Entra a https://git-scm.com/download/win y descarga el instalador.
  2. Ábrelo y dale “Siguiente” con las opciones por defecto hasta “Finalizar”.

(Atajo si tienes winget: winget install --id Git.Git -e)

  1. Abre la Terminal y ejecuta xcode-select --install. Acepta la ventana que aparece, eso instala Git.

(O con Homebrew: brew install git)

Para comprobar que funcionó: abre PowerShellla Terminal y escribe:

git --version

Si ves un número como git version 2.45.0, ¡listo!

Git is what creates the “versions” of your code on your computer.

  1. Go to https://git-scm.com/download/win and download the installer.
  2. Open it and click “Next” with the default options until “Finish”.

(Shortcut if you have winget: winget install --id Git.Git -e)

  1. Open the Terminal and run xcode-select --install. Accept the popup, that installs Git.

(Or with Homebrew: brew install git)

To check it worked: open PowerShellthe Terminal and type:

git --version

If you see a number like git version 2.45.0, you’re set!

3 Conectar VS Code con GitHubConnect VS Code to GitHub
  1. Abre VS Code.
  2. Abre el panel de Control de código fuente (el ícono de ramas en la barra izquierda) o usa Ctrl + Shift + GCmd + Shift + G.
  3. Abajo a la izquierda, haz clic en el ícono de cuenta y elige “Sign in with GitHub” (Iniciar sesión con GitHub). Se abrirá tu navegador.
  4. Autoriza y vuelve a VS Code. Ya está conectado.

Si haces el siguiente paso (publicar un repo), VS Code también te pedirá iniciar sesión ahí mismo.

  1. Open VS Code.
  2. Open the Source Control panel (the branch icon in the left bar) or use Ctrl + Shift + GCmd + Shift + G.
  3. At the bottom-left, click the account icon and choose “Sign in with GitHub”. Your browser opens.
  4. Authorize and go back to VS Code. You’re connected.

If you do the next step (publish a repo), VS Code will also prompt you to sign in right there.

4 Crear tu primer repositorioCreate your first repository

Un repositorio (o “repo”) es la carpeta de tu proyecto en GitHub. La forma más fácil es desde VS Code:

  1. Abre la carpeta de tu proyecto con Archivo → Abrir carpeta.
  2. Ve a Control de código fuente y haz clic en “Publish to GitHub” (Publicar en GitHub).
  3. Elige público (cualquiera lo ve) o privado (solo tú).
  4. VS Code crea el repo en tu cuenta y sube tu proyecto.

¿Prefieres la web? En github.com aprieta “New” → ponle nombre → “Create repository”, y luego conéctalo desde VS Code.

A repository (or “repo”) is your project’s folder on GitHub. The easiest way is from VS Code:

  1. Open your project folder with File → Open Folder.
  2. Go to Source Control and click “Publish to GitHub”.
  3. Choose public (anyone can see it) or private (only you).
  4. VS Code creates the repo in your account and uploads your project.

Prefer the web? On github.com click “New” → name it → “Create repository”, then connect it from VS Code.

5 Guardar tus cambios: commit y pushSave your changes: commit and push

Cada vez que cambias algo, guardas una “versión” y la subes:

  1. En Control de código fuente, escribe un mensaje corto (ej. “Agrego la página de inicio”).
  2. Aprieta ✓ Commit (guarda la versión en tu computadora).
  3. Aprieta “Sync Changes / Push” para subirla a GitHub.

Commit = guardar una foto de tu proyecto con un mensaje. Push = subir esa foto a GitHub.

Every time you change something, you save a “version” and upload it:

  1. In Source Control, write a short message (e.g. “Add the home page”).
  2. Click ✓ Commit (saves the version on your computer).
  3. Click “Sync Changes / Push” to upload it to GitHub.

Commit = save a snapshot of your project with a message. Push = upload that snapshot to GitHub.

Bonus: deja que Claude Code (y Vercel) hagan el trabajoBonus: let Claude Code (and Vercel) do the work
  • Con Claude Code (ver tutorial) solo le dices: “haz commit y push con un mensaje claro” y lo hace por ti.
  • Conecta tu repo a Vercel y cada push publica tu sitio automáticamente. Ese es exactamente el flujo con el que se construyó este sitio: escribes → Claude sube a GitHub → Vercel lo publica.
  • With Claude Code (see tutorial) you just say: “commit and push with a clear message” and it does it for you.
  • Connect your repo to Vercel and every push publishes your site automatically. That’s exactly the flow this site was built with: you write → Claude pushes to GitHub → Vercel publishes it.
Si algo sale malIf something goes wrong
ProblemaSolución
Dice que git no se reconoceVuelve al Paso 2 e instala Git; cierra y abre VS Code
No veo “Publish to GitHub”Inicia sesión con GitHub primero (Paso 3)
Subí algo privado por errorEn GitHub → Settings del repo → cámbialo a privado
Me pide usuario/contraseña al subirInicia sesión con GitHub en VS Code (Paso 3)
ProblemFix
It says git is not recognizedGo back to Step 2 and install Git; close and reopen VS Code
I don’t see “Publish to GitHub”Sign in with GitHub first (Step 3)
I uploaded something private by mistakeOn GitHub → repo Settings → switch it to private
It asks for a username/password when pushingSign in with GitHub in VS Code (Step 3)