# Instalación Guiada de Herramientas Ha llegado el momento de preparar tu entorno de desarrollo. En esta lección instalarás todas las herramientas necesarias para trabajar con Claude Code. ## 🎯 Objetivos de esta lección Al final de esta lección habrás: - ✅ Instalado Node.js y npm - ✅ Instalado Git - ✅ Configurado Visual Studio Code - ✅ Instalado Claude Code CLI - ✅ Verificado que todo funciona correctamente - ✅ Preparado para empezar el Módulo 1 --- ## 📋 Herramientas a Instalar | Herramienta | ¿Para qué sirve? | Obligatorio | |-------------|------------------|-------------| | **Node.js** | Ejecutar JavaScript fuera del navegador | ✅ Sí | | **npm** | Gestor de paquetes (viene con Node.js) | ✅ Sí | | **Git** | Control de versiones | ✅ Sí | | **VS Code** | Editor de código | ✅ Sí | | **Claude Code** | CLI de IA para desarrollo | ✅ Sí | | **Terminal** | Ya viene con tu sistema | ✅ Sí | --- ## 💚 Instalación de Node.js y npm ### Verificar si Ya Está Instalado **Abre tu terminal:** ```bash # Verificar Node.js node --version # Verificar npm npm --version ``` **Si ves algo como:** ``` v20.10.0 10.2.3 ``` ✅ **Ya tienes Node.js instalado** → Puedes saltar a la sección de Git ❌ **Si ves un error** → Continúa con la instalación --- ### Opción 1: Instalación Directa (Recomendada) #### 🪟 Windows **Paso 1:** Ir a [nodejs.org](https://nodejs.org/) **Paso 2:** Descargar la versión **LTS** (botón verde grande) ``` Node.js 20.x LTS Recommended For Most Users ``` **Paso 3:** Ejecutar el instalador `.msi` - ✅ Dejar todas las opciones por defecto - ✅ Marcar "Automatically install the necessary tools" - ✅ Click "Next" → "Install" **Paso 4:** Reiniciar la terminal **Paso 5:** Verificar instalación ```powershell PS C:\> node --version v20.10.0 PS C:\> npm --version 10.2.3 ``` #### 🍎 macOS **Opción A: Usando el instalador oficial** 1. Ir a [nodejs.org](https://nodejs.org/) 2. Descargar versión **LTS** (archivo `.pkg`) 3. Ejecutar instalador 4. Seguir pasos del asistente **Opción B: Usando Homebrew** (recomendado si ya tienes Homebrew) ```bash # Instalar Homebrew si no lo tienes /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Instalar Node.js brew install node # Verificar node --version npm --version ``` #### 🐧 Linux (Ubuntu/Debian) ```bash # Actualizar paquetes sudo apt update # Instalar Node.js LTS curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs # Verificar node --version npm --version ``` --- ### Opción 2: Instalación con nvm (Avanzado) **nvm** (Node Version Manager) permite tener múltiples versiones de Node.js. #### Windows (nvm-windows) ```powershell # Descargar e instalar desde: https://github.com/coreybutler/nvm-windows/releases # Después de instalar: nvm install lts nvm use lts ``` #### macOS/Linux ```bash # Instalar nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash # Reiniciar terminal # Instalar Node.js LTS nvm install --lts nvm use --lts # Verificar node --version ``` --- ## 🔧 Instalación de Git ### Verificar si Ya Está Instalado ```bash git --version ``` **Si ves:** ``` git version 2.42.0 ``` ✅ **Ya tienes Git** → Puedes saltar a la configuración de Git --- ### Instalar Git por Sistema Operativo #### 🪟 Windows **Opción 1: Instalador Oficial** 1. Ir a [git-scm.com](https://git-scm.com/download/win) 2. Descargar instalador 3. Ejecutar `.exe` **Configuración recomendada durante instalación:** - ✅ Use Git from the command line and also from 3rd-party software - ✅ Use bundled OpenSSH - ✅ Use the OpenSSL library - ✅ Checkout Windows-style, commit Unix-style line endings - ✅ Use MinTTY - ✅ Default (fast-forward or merge) - ✅ Git Credential Manager - ✅ Enable file system caching **Opción 2: Con Winget** ```powershell winget install Git.Git ``` #### 🍎 macOS **Opción 1: Xcode Command Line Tools** (más ligero) ```bash xcode-select --install ``` **Opción 2: Homebrew** (recomendado) ```bash brew install git ``` #### 🐧 Linux ```bash # Ubuntu/Debian sudo apt update sudo apt install git # Fedora sudo dnf install git # Arch sudo pacman -S git ``` --- ### Configurar Git (Primera Vez) **Después de instalar Git, configúralo:** ```bash # Tu nombre (aparecerá en los commits) git config --global user.name "Tu Nombre" # Tu email (usa el mismo que en GitHub) git config --global user.email "tu@email.com" # Editor por defecto (opcional) git config --global core.editor "code --wait" # Verificar configuración git config --list ``` --- ## 💻 Instalación de Visual Studio Code ### ¿Por Qué VS Code? - ✅ Gratuito y open source - ✅ Excelente integración con Git - ✅ Miles de extensiones - ✅ Terminal integrada - ✅ Claude Code funciona perfectamente con él --- ### Instalar VS Code #### 🪟 Windows 1. Ir a [code.visualstudio.com](https://code.visualstudio.com/) 2. Click "Download for Windows" 3. Ejecutar instalador **Opciones recomendadas:** - ✅ Add "Open with Code" action to Windows Explorer file context menu - ✅ Add "Open with Code" action to Windows Explorer directory context menu - ✅ Register Code as an editor for supported file types - ✅ Add to PATH #### 🍎 macOS 1. Descargar desde [code.visualstudio.com](https://code.visualstudio.com/) 2. Abrir archivo `.zip` 3. Arrastrar "Visual Studio Code.app" a la carpeta Applications **Añadir comando `code` a la terminal:** - Abrir VS Code - Cmd+Shift+P → "Shell Command: Install 'code' command in PATH" #### 🐧 Linux **Ubuntu/Debian:** ```bash sudo apt update sudo apt install software-properties-common apt-transport-https wget wget -q https://packages.microsoft.com/keys/microsoft.asc -O- | sudo apt-key add - sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main" sudo apt update sudo apt install code ``` --- ### Extensiones Recomendadas para VS Code **Abrir VS Code y instalar (Ctrl+Shift+X o Cmd+Shift+X):** ``` 1. ESLint → Detectar errores JavaScript 2. Prettier → Formatear código automáticamente 3. GitLens → Mejorar integración Git 4. Path Intellisense → Autocompletar rutas 5. Auto Rename Tag → Renombrar tags HTML juntos 6. Bracket Pair Colorizer → Colorear paréntesis 7. Material Icon Theme → Iconos bonitos ``` **Opcional pero útiles:** ``` - Live Server → Servidor local para desarrollo web - REST Client → Probar APIs desde VS Code - Docker → Si trabajas con Docker ``` --- ## 🤖 Instalación de Claude Code CLI ### Requisitos Previos ✅ Node.js instalado (verificar: `node --version`) ✅ npm instalado (verificar: `npm --version`) --- ### Instalar Claude Code **Comando de instalación global:** ```bash npm install -g @anthropic/claude-code ``` **En Windows, si da error de permisos:** ```powershell # Ejecutar PowerShell como Administrador npm install -g @anthropic/claude-code ``` **En macOS/Linux, si da error de permisos:** ```bash sudo npm install -g @anthropic/claude-code ``` --- ### Verificar Instalación ```bash # Verificar que se instaló claude-code --version # Debería mostrar algo como: 1.0.0 ``` --- ### Configurar Claude Code **Primer uso:** ```bash # Iniciar Claude Code claude-code # Te pedirá tu API key de Anthropic # Consíguela en: https://console.anthropic.com/ ``` **Configuración de API Key:** 1. Ir a [https://console.anthropic.com/](https://console.anthropic.com/) 2. Crear cuenta o login 3. Ir a "API Keys" 4. Crear nueva key 5. Copiar la key 6. Pegar cuando `claude-code` la pida --- ## ✅ Verificación Final: Todo Funcionando ### Checklist Completo Ejecuta cada comando y verifica que funciona: ```bash # 1. Node.js node --version # Esperado: v20.x.x o superior ✅ / ❌ # 2. npm npm --version # Esperado: 10.x.x o superior ✅ / ❌ # 3. Git git --version # Esperado: git version 2.x.x ✅ / ❌ # 4. VS Code code --version # Esperado: 1.xx.x ✅ / ❌ # 5. Claude Code claude-code --version # Esperado: 1.x.x ✅ / ❌ ``` --- ### Crear Proyecto de Prueba **Vamos a probar que todo funcione:** ```bash # 1. Crear carpeta de prueba mkdir test-setup cd test-setup # 2. Inicializar Git git init # 3. Crear package.json npm init -y # 4. Crear archivo de prueba echo "console.log('Todo funciona!')" > test.js # 5. Ejecutar con Node.js node test.js # Debería mostrar: Todo funciona! # 6. Ver en VS Code code . # 7. Probar Git git status git add . git commit -m "Test inicial" # 8. Ver log git log ``` --- ## 🎯 Proyecto Completo de Verificación ### Script de Diagnóstico Crea un archivo `diagnostico.js`: ```javascript // diagnostico.js console.log('🔍 Verificando instalación...\n') // Versión de Node.js console.log('✅ Node.js:', process.version) // Sistema operativo console.log('✅ Sistema:', process.platform) // Arquitectura console.log('✅ Arquitectura:', process.arch) // npm (verificar ejecutando) const { execSync } = require('child_process') try { const npmVersion = execSync('npm --version').toString().trim() console.log('✅ npm:', npmVersion) } catch (error) { console.log('❌ npm no encontrado') } try { const gitVersion = execSync('git --version').toString().trim() console.log('✅ Git:', gitVersion) } catch (error) { console.log('❌ Git no encontrado') } try { const codeVersion = execSync('code --version').toString().trim().split('\n')[0] console.log('✅ VS Code:', codeVersion) } catch (error) { console.log('❌ VS Code no encontrado') } console.log('\n🎉 ¡Setup completo y funcionando!') ``` **Ejecutar:** ```bash node diagnostico.js ``` **Salida esperada:** ``` 🔍 Verificando instalación... ✅ Node.js: v20.10.0 ✅ Sistema: darwin (o win32, linux) ✅ Arquitectura: x64 ✅ npm: 10.2.3 ✅ Git: git version 2.42.0 ✅ VS Code: 1.85.0 🎉 ¡Setup completo y funcionando! ``` --- ## 🐛 Solución de Problemas Comunes ### Problema 1: "command not found" o "no se reconoce" **Síntoma:** ```bash $ node --version command not found: node ``` **Solución:** **Windows:** - Reiniciar la terminal (PowerShell) - Reiniciar el computador - Verificar variables de entorno (PATH) **macOS/Linux:** - Reiniciar terminal - Verificar `.bashrc` o `.zshrc`: ```bash echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.zshrc source ~/.zshrc ``` --- ### Problema 2: npm install da error de permisos **Windows:** ```powershell # Ejecutar PowerShell como Administrador npm install -g paquete ``` **macOS/Linux:** ```bash # Opción 1: Usar sudo (no recomendado) sudo npm install -g paquete # Opción 2: Cambiar permisos de npm (recomendado) mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc ``` --- ### Problema 3: Git no está en PATH **Windows:** 1. Buscar "Variables de entorno" en el menú Inicio 2. Click "Variables de entorno" 3. En "Path", añadir: `C:\Program Files\Git\cmd` 4. Reiniciar terminal **macOS:** ```bash # Añadir a .zshrc echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` --- ### Problema 4: VS Code command 'code' no funciona **Windows:** - Reinstalar VS Code y marcar "Add to PATH" **macOS:** - Cmd+Shift+P en VS Code - Buscar: "Shell Command: Install 'code' command in PATH" **Linux:** - Añadir a `.bashrc`: ```bash export PATH="$PATH:/usr/share/code/bin" ``` --- ## 🎓 Ejercicio de Verificación **1. ¿Qué herramientas instalaste?**

Ver respuesta

Node.js, npm, Git, Visual Studio Code, Claude Code CLI

**2. ¿Qué comando verifica la versión de Node.js?**

Ver respuesta

`node --version`

**3. ¿Para qué sirve npm?**

Ver respuesta

Gestor de paquetes para instalar librerías y herramientas de JavaScript

**4. ¿Dónde se configura el nombre y email de Git?**

Ver respuesta

`git config --global user.name "Nombre"` y `git config --global user.email "email"`

--- ## 🎉 ¡Felicidades! Módulo 0 Completado Has terminado el **Módulo 0: Fundamentos para Principiantes Absolutos**. ### Lo que Aprendiste ✅ Qué es la programación ✅ Usar la terminal sin miedo ✅ Navegar por archivos y carpetas ✅ Qué es Node.js y npm ✅ Control de versiones con Git ✅ Setup completo de desarrollo --- ## 🚀 Próximo Módulo **Módulo 1: Instalación, setup y primera práctica** En el Módulo 1 aprenderás: - Requisitos previos específicos de Claude Code - Instalación paso a paso de Claude Code - Crear tu primer proyecto - Primeras interacciones - Modos de permisos - Atajos útiles - Crear un CLAUDE.md básico **¡Estás listo para empezar a trabajar con Claude Code!** 🎊 --- ## 📖 Recursos Útiles ### Documentación Oficial - [Node.js Docs](https://nodejs.org/docs/) - [Git Docs](https://git-scm.com/doc) - [VS Code Docs](https://code.visualstudio.com/docs) - [Claude Code Docs](https://docs.anthropic.com/claude-code) ### Comunidades - [Node.js Community](https://nodejs.org/en/community) - [Git Community](https://git-scm.com/community) - [VS Code Community](https://github.com/microsoft/vscode/discussions) --- > **Tip Pro:** Mantén tus herramientas actualizadas. Cada pocas semanas ejecuta `node --version`, `npm --version`, y `git --version` para verificar que tienes las últimas versiones. Actualizar regularmente te da acceso a nuevas features y correcciones de seguridad.