Objetivos
- Entender para qué sirve cada una de las cuatro herramientas: VS Code, Python, Git y Node.
- Abrir la terminal de tu sistema y escribir tus primeros comandos sin miedo.
- Instalar las cuatro herramientas con un solo comando por herramienta (winget, brew o apt).
- Comprobar que todo funciona con
--versiony guardar la captura como evidencia. - Saber usar GitHub Codespaces como alternativa si no puedes o no quieres instalar nada.
Antes de empezar: Ninguno. Un ordenador con Windows 11, macOS o Ubuntu, o solo un navegador.
Prompt de arranque
En este curso no vas a memorizar comandos. Los comandos los escribe la IA; tú aprendes a pedirlos, a ejecutarlos y a comprobar que han funcionado. Este es el prompt con el que empieza la unidad. Pégalo en ChatGPT, Gemini o Claude cambiando tu sistema operativo:
Uso Windows 11 y nunca he programado. Quiero instalar VS Code, Python 3.12 o superior, Git y Node.js LTS usando winget desde PowerShell. Dame los comandos uno a uno, explícame en una frase qué hace cada uno y dime qué comando debo ejecutar después para comprobar que se ha instalado bien.
Esto lo escribe la IA, tú compruebas que funciona. Abajo tienes los comandos ya probados para que compares lo que te diga la IA con lo que funciona de verdad.
Explicación
Por qué hay que preparar el ordenador
Piensa en una cocina. Puedes tener la mejor receta del mundo (en nuestro caso, la IA que te escribe el código), pero si no tienes fogones, cazos ni cuchillos, la receta se queda en papel. Este primer paso consiste en montar la cocina una sola vez. Después, cada proyecto del itinerario será «sacar los cazos y cocinar».
La buena noticia: son solo cuatro herramientas, todas sin coste, y se instalan con un comando cada una. La mala: el primer día es donde más gente abandona, casi siempre por un error tonto que nadie le explicó. Por eso esta unidad dedica tanto espacio a los errores frecuentes. Si algo falla, no es que «no sirvas para esto». Es que te has topado con uno de los cinco atascos que le pasan a todo el mundo.
Las cuatro herramientas, explicadas con objetos de casa
VS Code (Visual Studio Code) es tu mesa de trabajo. Es un editor de texto, como el Bloc de notas, pero pensado para código: colorea las palabras, avisa de errores y trae una terminal integrada. Aquí abrirás tus proyectos y aquí trabajará contigo la IA más adelante.
Python es un idioma que entiende el ordenador. Es el más usado en inteligencia artificial porque se lee casi como inglés. Instalar Python es como instalar el diccionario: sin él, el ordenador no entiende los programas escritos en ese idioma. Usaremos la versión 3.12 o superior; en Windows y Mac instalamos la 3.13, porque la 3.14 todavía da problemas con algunas librerías.
Git es una máquina del tiempo para tus proyectos. Cada vez que algo funciona, haces una «foto» (un commit). Si mañana la IA te rompe el proyecto, vuelves a la foto de ayer. En el itinerario lo usarás a fondo; hoy solo lo instalamos.
Node.js es otro motor para ejecutar programas, en este caso escritos en JavaScript, el idioma de las páginas web. Muchas herramientas modernas de IA (por ejemplo, los agentes de código que verás en m03) se instalan con Node. Instalaremos la versión LTS, que significa «soporte a largo plazo»: la versión estable, la que no da sustos.
Qué es la terminal y por qué no muerde
La terminal es una ventana donde le das órdenes al ordenador escribiendo en lugar de pulsando botones. Es como hablar con el camarero en vez de señalar la carta: más directo y más preciso. En Windows se llama PowerShell (o «Terminal»); en macOS, Terminal; en Ubuntu, también Terminal.
Una orden en la terminal tiene casi siempre la misma forma: el nombre del programa, lo que quieres que haga y, a veces, opciones que empiezan por guiones. Por ejemplo, git --version significa «Git, dime tu versión». Cuando pulsas Intro, el ordenador responde con texto. Si responde con un número de versión, todo bien. Si responde con un mensaje rojo, hay un error que se puede leer y resolver.
Tres reglas de oro para la terminal:
- Lee antes de pulsar Intro. Sobre todo si la orden la propone una IA y contiene
rm,delosudo. - Cierra y vuelve a abrir la terminal después de instalar algo. La terminal solo «se entera» de los programas nuevos al abrirse. Este es el error número uno del primer día.
- Copia el error completo y pégaselo a la IA. El mensaje de error no es un insulto; es una pista.
Un aviso para Windows: muchos tutoriales usan curl para descargar o probar direcciones web. En Windows PowerShell, curl es un alias (un apodo) de otro comando, Invoke-WebRequest, que no entiende las mismas opciones. Cuando veas curl en una guía, escribe curl.exe: es el curl de verdad, que viene incluido en Windows 11.
Los gestores de paquetes: la tienda de aplicaciones de la terminal
En lugar de ir a cuatro webs, descargar cuatro instaladores y pulsar «Siguiente» veinte veces, usaremos un gestor de paquetes: una especie de tienda de aplicaciones que se maneja con comandos. Cada sistema tiene el suyo:
- Windows 11:
winget, que ya viene instalado. - macOS:
brew(Homebrew), que se instala una vez con un comando que aparece en su web oficial. - Ubuntu:
apt, que viene de serie, ysnappara algunas aplicaciones como VS Code.
La ventaja no es solo la comodidad. Con un gestor de paquetes, actualizar o desinstalar también es un solo comando, y los pasos son repetibles: si cambias de ordenador, repites la misma lista y en diez minutos estás listo.
Qué significa «comprobar con --version»
Instalar no basta: hay que comprobar que la terminal encuentra cada programa. Para eso usamos la opción --version, que todos estos programas entienden. Si escribes python --version y ves Python 3.13.x, el ordenador sabe dónde está Python. Si ves «no se reconoce como nombre de un cmdlet» o «command not found», el programa está instalado pero la terminal no lo encuentra. Ese «saber dónde está» se llama PATH: la lista de carpetas en las que la terminal busca programas. Casi siempre se arregla cerrando y abriendo la terminal.
La ruta sin instalar nada: GitHub Codespaces
Si tu ordenador es del trabajo y no te deja instalar, si es muy antiguo o si simplemente quieres empezar ya, existe un plan B: GitHub Codespaces. Es un ordenador en la nube que abres desde el navegador y que ya trae VS Code, Python, Git y Node instalados. Es como cocinar en una cocina de alquiler totalmente equipada: llegas y cocinas.
Las cuentas gratuitas de GitHub incluyen una cuota mensual de uso (en octubre de 2026, 120 horas de núcleo al mes, que con la máquina básica de 2 núcleos son unas 60 horas, y 15 GB de almacenamiento) sin pedir tarjeta. Si la agotas, simplemente se para hasta el mes siguiente. Dos consejos: detén el Codespace cuando termines y borra los que no uses.
Codespaces es perfectamente válido para todo el Curso 0. Lo único que cambia es que lo que en tu ordenador sería localhost, en Codespaces se abre con una dirección especial que te da GitHub (lo verás en pe03).
Qué NO hace esta unidad
No instalamos todavía ningún agente de código ni Claude Code: eso llega en m03, que da por hecho que ya tienes Node funcionando. Tampoco creamos cuentas ni claves: eso es pe02. Hoy, solo la cocina montada y comprobada.
Lab paso a paso
Objetivo del lab: una terminal con cuatro respuestas de versión. Elige tu sistema y sigue solo esa sección. Si no puedes instalar nada, ve directamente a la ruta Codespaces.
Windows 11
1Abre PowerShell: pulsa la tecla Windows, escribe PowerShell y pulsa Intro. No hace falta «Ejecutar como administrador».
2Comprueba que tienes winget:
winget --version
Debe verse algo como v1.11.x o superior. Si no aparece, actualiza «Instalador de aplicación» desde Microsoft Store.
3Instala las cuatro herramientas, una línea cada vez. Las opciones del final aceptan las condiciones de uso para que no se quede esperando:
winget install -e --id Microsoft.VisualStudioCode --accept-source-agreements --accept-package-agreements
winget install -e --id Python.Python.3.13 --accept-source-agreements --accept-package-agreements
winget install -e --id Git.Git --accept-source-agreements --accept-package-agreements
winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements
Si va bien, cada comando termina con Instalado correctamente (o Successfully installed). Puede aparecer una ventana pidiendo permiso: acepta.
4Cierra PowerShell y ábrelo de nuevo. Imprescindible.
5Permite que PowerShell ejecute los scripts de las herramientas que acabas de instalar (lo necesitan npm y, en pe04, el entorno de Python). Solo afecta a tu usuario:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
Responde S (o Y) y pulsa Intro.
6Comprueba las cuatro herramientas:
code --version
python --version
git --version
node --version
npm --version
Qué debe verse (los números exactos pueden ser más altos):
1.10x.x ← VS Code (tres líneas; la primera es la versión)
Python 3.13.x
git version 2.5x.x.windows.1
v24.x.x
11.x.xmacOS
1Abre Terminal: pulsa Cmd + Espacio, escribe Terminal y pulsa Intro.
2Si no tienes Homebrew, instálalo con el comando oficial de https://brew.sh/ (te pedirá la contraseña de tu Mac; al escribirla no se ve nada, es normal):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Al terminar, Homebrew muestra en «Next steps» dos líneas que empiezan por echo y eval. Cópialas y ejecútalas: añaden brew a tu PATH. Después comprueba:
brew --version3Instala las herramientas:
brew install --cask visual-studio-code
brew install [email protected] git node@244Node LTS (node@24) no se activa solo en Homebrew. Añádelo a tu PATH y recarga la configuración:
echo 'export PATH="$(brew --prefix node@24)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Alternativa sin Homebrew para Node: descarga el instalador .pkg de la versión LTS en https://nodejs.org/en/download y ábrelo con doble clic (no necesitas este paso 4).
5Comprueba:
code --version
python3 --version
git --version
node --version
npm --version
Qué debe verse: una versión de VS Code (1.10x.x), Python 3.13.x, git version 2.5x.x, v24.x.x y 11.x.x. En Mac se escribe python3, no python.
Ubuntu (24.04 o superior)
1Abre Terminal con Ctrl + Alt + T.
2Actualiza la lista de paquetes e instala Python, Git y utilidades (te pedirá tu contraseña):
sudo apt update
sudo apt install -y python3 python3-venv python3-pip git curl3Instala VS Code desde Snap:
sudo snap install code --classic4Instala Node LTS con nvm, el método que recomienda la web oficial de Node para Linux. apt trae una versión antigua de Node, por eso no la usamos:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
Cierra la terminal y ábrela de nuevo, y después:
nvm install --lts5Comprueba:
code --version
python3 --version
git --version
node --version
npm --version
Qué debe verse: VS Code 1.10x.x, Python 3.12.x (Ubuntu 24.04 trae la 3.12, que es suficiente), git version 2.4x.x o superior, v24.x.x y 11.x.x.
Ruta sin instalar nada: GitHub Codespaces
1Crea tu cuenta de GitHub si aún no la tienes (lo explicamos con calma en pe02): https://github.com/signup
2Entra en https://github.com/codespaces y pulsa New codespace, o elige la plantilla Blank en la sección de plantillas.
3Espera uno o dos minutos. Se abrirá VS Code dentro del navegador, con una terminal abajo.
4En esa terminal, comprueba:
python3 --version
git --version
node --version
npm --version
Debe verse una versión de Python 3.12 o superior, Git, Node y npm. Aquí no hace falta code --version: ya estás dentro de VS Code.
5Al terminar, detén el Codespace: menú de la esquina inferior izquierda (Codespaces) y Stop Current Codespace.
Evidencia
Una captura de pantalla de tu terminal con las respuestas de code --version (salvo en Codespaces), python --version o python3 --version, git --version, node --version y npm --version. Recorta la captura para que no se vea tu nombre de usuario si aparece en la ruta.
Criterio de aceptación
URLs de activación
Verificadas el 11-10-2026 (200 OK; GitHub devuelve 403 a peticiones automáticas pero abre bien en el navegador).
| Para qué | URL oficial |
|---|---|
| Descargar VS Code | https://code.visualstudio.com/download |
| Descargar Python | https://www.python.org/downloads/ |
| Descargar Git | https://git-scm.com/downloads |
| Descargar Node.js (LTS) | https://nodejs.org/en/download |
| Qué es winget (Windows) | https://learn.microsoft.com/es-es/windows/package-manager/winget/ |
| Instalar Homebrew (macOS) | https://brew.sh/ |
| Instalar nvm (Linux) | https://github.com/nvm-sh/nvm |
| Crear cuenta de GitHub | https://github.com/signup |
| Abrir un Codespace | https://github.com/codespaces |
| Cuota gratuita de Codespaces | https://docs.github.com/es/billing/concepts/product-billing/github-codespaces |
| Directivas de ejecución de PowerShell | https://learn.microsoft.com/es-es/powershell/module/microsoft.powershell.core/about/about_execution_policies |
Errores frecuentes
| Síntoma | Qué pasa | Cómo se arregla |
|---|---|---|
npm : No se puede cargar el archivo C:\...\npm.ps1 porque la ejecución de scripts está deshabilitada en este sistema | Windows trae bloqueados los scripts de PowerShell por seguridad (directiva Restricted). npm es un script, así que no arranca. | Ejecuta Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, responde S y vuelve a probar. Solo cambia la directiva de tu usuario y sigue bloqueando scripts descargados sin firmar. |
python : El término 'python' no se reconoce... o command not found justo después de instalar | La terminal se abrió antes de la instalación y no conoce el nuevo PATH. | Cierra la terminal (todas las ventanas) y ábrela de nuevo. Si sigue igual, reinicia la sesión de Windows. |
En Windows, al escribir python se abre Microsoft Store | Son los «alias de ejecución de aplicaciones» de Windows, que apuntan a la Store cuando Python aún no está instalado. | Instala Python con winget y reabre PowerShell. Si persiste: Configuración > Aplicaciones > Configuración avanzada de aplicaciones > Alias de ejecución de aplicaciones, y desactiva python.exe y python3.exe. |
En macOS, zsh: command not found: brew después de instalar Homebrew | No ejecutaste las líneas de «Next steps» que añaden brew al PATH. | Vuelve a lanzar el instalador o ejecuta echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile y luego eval "$(/opt/homebrew/bin/brew shellenv)" (en Mac con procesador Intel la ruta es /usr/local/bin/brew). |
En macOS, node --version dice command not found tras brew install node@24 | node@24 es una versión «aparcada» en Homebrew y no se enlaza sola. | Ejecuta el paso 4 de macOS (la línea echo 'export PATH=...' y source ~/.zshrc). |
En Ubuntu, nvm: command not found | La terminal no ha cargado nvm después de instalarlo. | Cierra y abre la terminal. Si persiste, ejecuta source ~/.bashrc. |
E: No se pudo bloquear /var/lib/dpkg/lock o Permiso denegado en Ubuntu | Otra instalación está en marcha (por ejemplo, las actualizaciones automáticas) o has olvidado sudo. | Espera unos minutos y repite el comando con sudo delante. |
En Windows, una orden con curl copiada de una guía da un error en rojo sobre Invoke-WebRequest o sobre un parámetro desconocido | En Windows PowerShell, curl es un alias de Invoke-WebRequest, que usa otras opciones. | Escribe curl.exe en lugar de curl. En macOS y Linux no pasa: allí curl es siempre el programa real. |
winget no se reconoce | Windows sin actualizar o versión LTSC sin «Instalador de aplicación». | Actualiza Windows y la app «Instalador de aplicación» desde Microsoft Store. Si no puedes, usa los instaladores de las URLs oficiales o la ruta Codespaces. |
Quiz
Cinco preguntas para comprobar que lo has entendido. Necesitas un 70 % para aprobar.