Clase 01 · Módulo 02
Instalar VS Code, Node.js y Git
Instalar VS Code, Node.js y Git
Qué logras en esta clase
Dejas tu computador con las tres bases que usa todo el curso, instaladas y comprobadas.
- Sabes para qué sirve cada programa.
- Instalas VS Code, Node.js y Git en tu sistema.
- Compruebas cada uno con un comando.
- Reconoces el error más común y cómo salir de él.
02
Tres programas, tres trabajos
Uno para ver los archivos, uno para ejecutar el proyecto y uno para guardar versiones. Nada más hace falta para empezar.
03
Qué hace cada pieza
| Programa | Qué tipo de cosa es | Para qué lo usas |
|---|---|---|
| VS Code | Editor de código gratuito de Microsoft | Ver y editar los archivos de tu web |
| Node.js | Programa que ejecuta JavaScript fuera del navegador | Levantar y construir el sitio |
| npm | Instalador de paquetes; viene dentro de Node.js | Bajar Astro, Tailwind y el resto |
| Git | Control de versiones | Guardar puntos a los que puedes volver |
04
Cómo trabajan juntas
Claude Code se instala en la clase 5. Primero van las bases, porque sin ellas no tiene dónde trabajar.
05
Antes de instalar, revisa tu equipo
Claude Code, que usarás desde la clase 5, pide como mínimo:
- macOS 13 o posterior.
- Windows 10 (versión 1809 o posterior).
- Ubuntu 20.04 o Debian 10 o posterior.
- 4 GB de memoria RAM y conexión a internet.
06
Instalar VS Code
- Entra a
code.visualstudio.com. - Descarga el instalador que el sitio ofrece para tu sistema.
- Ejecútalo y acepta las opciones que trae marcadas.
- Abre VS Code para confirmar que arranca.
El programa parte en inglés. Los nombres de menú de este curso van en inglés por eso; si instalas el paquete de idioma español, los verás traducidos.
07
Abre carpetas, no archivos sueltos
Una web es una carpeta con muchos archivos que se necesitan entre sí. En VS Code se trabaja abriendo la carpeta entera: menú File, opción Open Folder.
Así ves el árbol de archivos a la izquierda, y la terminal y Claude Code parten ubicados en tu proyecto.
08
La versión de Node importa
Astro, el framework del curso, no se instala en un Node antiguo. Pide Node 22 con un parche reciente, o una versión superior.
09
Qué versión de Node elegir
Node publica versiones LTS (siglas de soporte de largo plazo), que son las estables. Al 18-11-2026, nodejs.org ofrece por defecto la 26 como LTS más reciente; la 24 y la 22 también siguen con soporte.
Instala la LTS que el sitio te ofrece. No elijas versiones marcadas como alfa o de prueba.
10
Instalar Node.js
- Entra a
nodejs.orgy abre la sección de descargas. - Elige tu sistema operativo y la versión LTS.
- En Windows usa el instalador
.msi, que es el que recomienda el sitio. En macOS y Linux, sigue el método que la página muestra para tu sistema. - Termina la instalación con las opciones por defecto.
- Cierra todas las terminales abiertas y abre una nueva.
11
Comprobar Node y npm
Abre una terminal nueva (la clase 2 explica cuál) y escribe:
node --version
npm --versionCada comando debe responder con un número de versión. El de Node empieza con v y debe ser 22.23.4 o mayor.
Si responde un número menor, tienes un Node viejo instalado: repite la instalación con la LTS actual.
12
Instalar Git según tu sistema
| Sistema | Camino recomendado |
|---|---|
| Windows | Instalador «Git for Windows» desde git-scm.com |
| macOS | xcode-select --install en la Terminal, o brew install git si usas Homebrew |
| Ubuntu o Debian | sudo apt install git |
En Windows también existe winget install --id Git.Git -e --source winget, pero ese paquete no lo mantiene el proyecto Git for Windows y puede ir atrasado.
13
En Windows, Git trae algo más
El instalador de Git for Windows incluye Git Bash, una terminal con los mismos comandos que macOS y Linux.
Claude Code la aprovecha: con Git for Windows instalado, ejecuta sus comandos en Bash. Sin él, usa PowerShell. Funciona de ambas formas, pero la documentación de Claude Code recomienda instalarlo.
Durante la instalación, deja las opciones que vienen marcadas.
14
Preséntate ante Git
Git firma cada versión guardada con un nombre y un correo. Se configura una sola vez por computador:
git config --global user.name "Tu Nombre"
git config --global user.email "tu@correo.com"Usa el mismo correo con el que crearás tu cuenta de GitHub en la clase 4. Así tus versiones quedan asociadas a tu cuenta.
15
La comprobación final
En una terminal nueva, los tres comandos deben responder con una versión:
node --version
npm --version
git --versionSi los tres responden, tu entorno base está listo. Anota las versiones: te servirán si algún día pides ayuda.
16
Si la terminal dice «no se reconoce»
Si sigue fallando, reinicia el computador. Los instaladores agregan el programa a la lista de rutas del sistema (llamada PATH) y algunas terminales solo la leen al iniciar.
17
Instalador oficial o gestor: cuál conviene
| Opción | Cuándo conviene | Lo malo |
|---|---|---|
| Instalador oficial | Partes de cero y quieres lo más simple | Actualizas a mano, descargando de nuevo |
| Gestor del sistema (winget, Homebrew, apt) | Ya lo usas para otros programas | La versión puede ir atrasada |
| Gestor de versiones de Node (nvm, fnm) | Trabajas en varios proyectos con distintos Node | Una pieza más que aprender |
Para este curso basta el instalador oficial.
18
Dos descuidos que cuestan una tarde
El segundo descuido: copiar comandos de instalación de un tutorial antiguo. Las versiones cambian cada mes. La fuente es siempre el sitio oficial de cada programa.
19
Lo que te llevas
- VS Code muestra, Node.js ejecuta, npm instala paquetes y Git guarda versiones.
- Se instala la LTS de Node; Astro 7 pide 22.23.4 o superior.
- En Windows, Git for Windows suma Git Bash, que Claude Code aprovecha.
- Cada instalación se comprueba con
--versionen una terminal nueva. - «No se reconoce» casi siempre se arregla abriendo otra terminal.
20
Hazlo ahora
En 15 minutos:
- Instala lo que te falte de los tres programas.
- Ejecuta los tres comandos de versión y anota los resultados.
- Configura tu nombre y correo en Git.
- Crea la carpeta
proyectosy, dentro, una carpeta de prueba. - Ábrela en VS Code con File > Open Folder.
Si un comando no responde con una versión, no avances a la clase 2 hasta resolverlo.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Visual Studio Code (sitio oficial y descargas)code.visualstudio.com ↗
- Node.js: descargasnodejs.org ↗
- Node.js: versiones y su estado (LTS, fin de soporte)nodejs.org ↗
- Git: instalación en Windowsgit-scm.com ↗
- Git: instalación en macOSgit-scm.com ↗
- Astro en el registro de npm (versión de Node exigida)registry.npmjs.org ↗
- Claude Code: requisitos e instalacióncode.claude.com ↗