Configurando tu entorno de desarrollo en Windows

Si estás empezando a programar y usas Windows, esta guía va a preparar tu máquina con todo lo que necesitás para tener un entorno de desarrollo profesional.

Vamos a instalar, configurar y entender cada herramienta: desde la terminal hasta el editor de código, desde el control de versiones hasta las herramientas de IA que van a acelerar tu aprendizaje.

Warp: la terminal

Warp es la terminal más moderna disponible para Windows. Hecha en Rust, renderizada en la GPU y con inteligencia artificial integrada, es el equivalente (y muchos dicen que superior) a iTerm2 de Mac.

A diferencia de la Terminal de Windows estándar, Warp organiza cada comando en bloques navegables, tiene autocompletado inteligente, sugerencias por IA y hasta permite compartir sesiones de terminal con otras personas.

Instalación

1. Accedé a warp.dev/download
2. Descargá la versión para Windows
3. Ejecutá el instalador
4. Creá una cuenta (podés usar GitHub o Google): es gratuito

Si preferís instalar desde la terminal, abrí PowerShell y ejecutá:

winget install Warp.Warp

Configuración inicial

Después de instalar y abrir Warp:

1. Ya viene con un tema oscuro bonito por defecto
2. Andá a Settings (engranaje) > Appearance para personalizar colores, fuente y opacidad
3. Andá a Settings > Features y explorá las opciones de IA

Consejos para principiantes

• Bloques de comando: cada comando que ejecutás se convierte en un bloque separado. Podés copiar toda la salida haciendo clic en el ícono de copia
• IA integrada: presioná Ctrl + Space para pedir ayuda en lenguaje natural. Ej: "¿cómo listo todos los archivos .js en esta carpeta?"
• Historial inteligente: presioná Ctrl + R para buscar en el historial con fuzzy search

Git: control de versiones

Git es el sistema de control de versiones que todo programador usa. Es con él que guardás el historial de tu código y colaborás con otras personas.

Instalación

1. Accedé a git-scm.com/downloads/win
2. Descargá el instalador (64-bit)
3. Ejecutá el instalador: en la mayoría de las pantallas, podés hacer clic en Next con las opciones predeterminadas
4. Prestá atención a dos pantallas:
   • “Choosing the default editor”: seleccioná Visual Studio Code (en lugar de Vim)
   • “Adjusting the name of the initial branch”: seleccioná “Override” y escribí main

Configuración inicial

Abrí Warp (o PowerShell) y configurá tu nombre y email:

git config --global user.name "Tu Nombre"
git config --global user.email "tuemail@ejemplo.com"

Verificar que funcionó

git --version

Debería aparecer algo como git version 2.47.1.windows.1.

Visual Studio Code (VSCode)

VSCode es el editor de código más usado en el mundo. Es gratuito, liviano y tiene miles de extensiones.

Instalación

1. Accedé a code.visualstudio.com
2. Hacé clic en el botón grande de descarga para Windows
3. Ejecutá el instalador
4. Marcá estas opciones durante la instalación:
   • Agregar al PATH
   • “Abrir con Code” en el menú contextual de archivos
   • “Abrir con Code” en el menú contextual de directorios

Verificar que funcionó

code --version

Configuraciones recomendadas

Abrí VSCode y presioná Ctrl + , (coma) para abrir la Configuración. Buscá y activá:

WSL 2 + Zsh + Oh My Zsh

WSL (Windows Subsystem for Linux) te permite ejecutar Linux dentro de Windows. Con él, tenés acceso a una terminal Linux de verdad, con Zsh (un shell más poderoso que Bash) y Oh My Zsh (que hace todo más lindo y productivo).

Instalar WSL

Abrí PowerShell como Administrador (clic derecho en el ícono > “Ejecutar como administrador”) y ejecutá:

wsl --install

Esto instala WSL 2 con Ubuntu automáticamente. Reiniciá la computadora cuando se te pida.

Después de reiniciar, Ubuntu se va a abrir automáticamente pidiendo que crees un nombre de usuario y contraseña. Elegí algo simple que vayas a recordar. La contraseña no aparece mientras escribís: eso es normal en Linux.

Después de configurar WSL, volvé a Warp y andá a Settings > Features > Session para cambiar el shell predeterminado a WSL / Ubuntu.

Instalar Zsh

Con Ubuntu abierto en la terminal, ejecutá:

sudo apt update && sudo apt install zsh -y

Definí Zsh como shell predeterminado:

chsh -s $(which zsh)

Cerrá y volvé a abrir la terminal Ubuntu.

Instalar Oh My Zsh

Oh My Zsh agrega temas, autocompletado inteligente y atajos a la terminal:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Cuando pregunte si querés cambiar el shell predeterminado a Zsh, respondé Y (sí).

Plugins útiles

Estos dos plugins van a acelerar mucho tu día a día.

zsh-autosuggestions: sugiere comandos mientras escribís:

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

zsh-syntax-highlighting: colorea los comandos en la terminal:

git clone https://github.com/zsh-users/zsh-syntax-highlighting ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

Ahora activá los plugins editando el archivo de configuración:

vim ~/.zshrc

Encontrá la línea que dice plugins=(git) y reemplazala por:

plugins=(git zsh-autosuggestions zsh-syntax-highlighting)

Guardá con Ctrl + O, Enter, y salí con Ctrl + X. Después recargá:

source ~/.zshrc

Tema Powerlevel10k (opcional, pero recomendado)

Powerlevel10k es el tema más popular y lindo para Zsh.

Primero, instalá una Nerd Font (fuente con íconos especiales):

1. Accedé al repositorio de Powerlevel10k y descargá las 4 fuentes MesloLGS NF
2. Extraé e instalá las fuentes (doble clic en cada .ttf > Instalar)
3. En Warp, andá a Settings > Appearance > Font y seleccioná MesloLGS NF
4. En VSCode, presioná Ctrl + ,, buscá terminal font y poné MesloLGS NF

Ahora instalá el tema:

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

Editá ~/.zshrc:

vim ~/.zshrc

Encontrá la línea ZSH_THEME="robbyrussell" y cambiala a:

ZSH_THEME="powerlevel10k/powerlevel10k"

Guardá y recargá:

source ~/.zshrc

El asistente de Powerlevel10k se va a abrir automáticamente. Seguí las preguntas para personalizar el aspecto de tu terminal.

Configurar VSCode para usar WSL

1. Abrí VSCode
2. Instalá la extensión WSL (buscá “WSL” en extensiones)
3. Presioná Ctrl + Shift + P, escribí Terminal: Select Default Profile y seleccioná Ubuntu (WSL)

Ahora tu terminal integrada de VSCode va a usar Linux con Zsh. Para abrir una carpeta de WSL en VSCode, ejecutá en la terminal Ubuntu:

code .

Node.js (vía nvm)

Node.js te permite ejecutar JavaScript fuera del navegador. nvm (Node Version Manager) te permite instalar y alternar entre versiones de Node fácilmente.

Instalá Node dentro de WSL (Ubuntu), no en Windows. Esto evita problemas de compatibilidad.

Instalar nvm

En la terminal Ubuntu (WSL), ejecutá:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Cerrá y abrí la terminal, después verificá:

nvm --version

Instalar Node.js

Instalá la versión LTS (más estable) y la versión 22 (necesaria para algunas herramientas):

nvm install --lts
nvm install 22

Definí la versión LTS como predeterminada:

nvm alias default lts/*

Verificar que funcionó

node --version
npm --version

npm (Node Package Manager) viene incluido con Node. Es con lo que instalás bibliotecas y herramientas de JavaScript: pensá en él como una tienda de piezas para programadores.

Extensiones esenciales de VSCode

Abrí VSCode e instalá estas extensiones (hacé clic en el ícono de cuadraditos en la barra lateral o presioná Ctrl + Shift + X).

Para principiantes

Para cuando avances

Extras útiles

Crear una cuenta en GitHub

GitHub es donde los programadores guardan y comparten código. Es como un Google Drive para código.

Después de crear tu cuenta, configurá la autenticación SSH para no tener que escribir la contraseña cada vez. En la terminal Ubuntu (WSL):

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

Presioná Enter en todas las preguntas (aceptá los valores predeterminados). Copiá la clave pública:

cat ~/.ssh/id_ed25519.pub

Copiá el texto que aparezca. Andá a GitHub > Settings > SSH Keys, hacé clic en New SSH key, pegá la clave y guardá.

Probá la conexión:

ssh -T git@github.com

Debería aparecer: Hi tuusuario! You've successfully authenticated.

Configurar Git en WSL

Dentro de Ubuntu (WSL), configurá Git de nuevo: la configuración de Windows no vale acá:

git config --global user.name "Tu Nombre"
git config --global user.email "tuemail@ejemplo.com"
git config --global init.defaultBranch main

Estructura de carpetas recomendada

Dentro de WSL, creá una carpeta para tus proyectos:

mkdir -p ~/proyectos
cd ~/proyectos

Regla de oro: siempre trabajá dentro del sistema de archivos de Linux (~/...), nunca en /mnt/c/.... Trabajar dentro de /mnt/c/ es significativamente más lento.

Claude Code: IA de Anthropic en la terminal

Claude Code es un agente de IA que corre directo en tu terminal. Entiende tu proyecto, edita archivos, ejecuta comandos y te ayuda a programar como si fuera un compañero de trabajo senior.

Requisitos

• Una cuenta de Anthropic con plan Pro, Max, Teams o Enterprise (el plan gratuito no incluye Claude Code)
• Git instalado (ya lo hiciste)

Instalación en WSL/Ubuntu

curl -fsSL https://claude.ai/install.sh | bash

Verificá la instalación:

claude --version

Instalación en PowerShell (si preferís usarlo fuera de WSL)

irm https://claude.ai/install.ps1 | iex

Claude Code en Windows nativo requiere Git for Windows, que ya instalaste.

Primer uso

1. Navegá hasta la carpeta de tu proyecto:

   cd ~/proyectos/mi-proyecto
   

2. Ejecutá claude
3. El navegador se va a abrir para que inicies sesión con tu cuenta de Anthropic
4. Después de autenticarte, volvés a la terminal y ya podés empezar a conversar

Qué podés hacer

• Pedirle que cree archivos, funciones, componentes
• Preguntarle sobre errores en tu código
• Pedirle que explique fragmentos de código
• Lee y edita tus archivos directamente
• Ejecuta comandos en la terminal por vos (con tu permiso)

Ejemplo práctico

> claude
> Creá una página HTML con un botón que cambie el color de fondo cuando se haga clic

Claude Code va a crear los archivos necesarios para vos.

Codex CLI: IA de OpenAI en la terminal

Codex es el agente de IA de OpenAI para la terminal. Al igual que Claude Code, puede editar tus archivos y ejecutar comandos.

Requisitos

• Una cuenta en OpenAI (ChatGPT Plus o API key)
• Node.js 22+ (ya lo instalaste vía nvm)

Instalación en WSL/Ubuntu

Asegurate de estar usando Node 22:

nvm use 22

Instalá globalmente:

npm i -g @openai/codex

Primer uso

1. Navegá hasta la carpeta de tu proyecto:

   cd ~/proyectos/mi-proyecto
   

2. Ejecutá codex
3. La primera vez, te va a pedir que te autentiques con tu cuenta de OpenAI

Diferencias entre Claude Code y Codex

Los dos son excelentes. Probá ambos y fijate con cuál te sentís más cómodo: muchos desarrolladores usan los dos.

Checklist final

Después de seguir todo el tutorial, comprobá que todo esté funcionando. Ejecutá estos comandos en la terminal Ubuntu (WSL):

git --version          # Git instalado
node --version         # Node.js instalado
npm --version          # npm instalado
nvm --version          # nvm instalado
zsh --version          # Zsh instalado
claude --version       # Claude Code instalado
codex --version        # Codex instalado
code --version         # VSCode accesible desde la terminal

Si todos devuelven una versión, tu entorno está 100% configurado.

Resumen visual del stack

┌──────────────────────────────────────────────┐
│            Warp (terminal con IA)             │
│  ┌────────────────────────────────────────┐   │
│  │        Ubuntu (WSL 2)                  │   │
│  │  ┌──────────────────────────────────┐  │   │
│  │  │  Zsh + Oh My Zsh + P10k         │  │   │
│  │  │  ┌────────────┐ ┌─────────────┐ │  │   │
│  │  │  │  Node.js   │ │     Git     │ │  │   │
│  │  │  │  (nvm)     │ │             │ │  │   │
│  │  │  └────────────┘ └─────────────┘ │  │   │
│  │  │  ┌──────────────────────────────┐│  │   │
│  │  │  │  Claude Code  |  Codex CLI  ││  │   │
│  │  │  └──────────────────────────────┘│  │   │
│  │  └──────────────────────────────────┘  │   │
│  └────────────────────────────────────────┘   │
│                                               │
│  ┌────────────────────────────────────────┐   │
│  │  Visual Studio Code (con extensión WSL)│   │
│  └────────────────────────────────────────┘   │
└───────────────────────────────────────────────┘

Próximos pasos

Ahora que tu entorno está listo, podés:

1. Continuar tus estudios de JavaScript: ahora con una terminal profesional
2. Practicar Git: creá un repositorio en GitHub y hacé commits de tus ejercicios
3. Explorar Claude Code: pedile que te explique partes del código que no entendiste
4. Crear tu primer proyecto: empezá con algo simple como una calculadora o lista de tareas

¡Éxitos en tus estudios!