02 · Instala tus herramientas: VS Code + Claude Code

Aquí dejas tu computador listo para que la IA trabaje dentro de él. Son dos instalaciones y un inicio de sesión. Después de cada paso te digo cómo comprobar que quedó bien — y qué hacer si no.

⏱ 40 minutos 📶 Cero conocimiento previo 💻 Windows o Mac ✅ Requiere: módulo 01

Al terminar este módulo vas a tener…

VS Code instalado y abierto.
Claude Code instalado, con sesión iniciada y respondiendo.
Tu primera carpeta de proyecto creada.
Un archivo real, hecho por la IA, guardado en tu computador.

Antes de partir: reserva 40 minutos sin interrupciones

Esta es la única parte del curso donde algo puede salir mal por culpa de tu computador y no tuya. Si te apuras, te frustras. Si vas paso a paso verificando, no falla. Cada paso tiene su verificación — no avances sin pasarla.

Qué vamos a instalar, y por qué

Herramienta	Qué es	Por qué la necesitas
Visual Studio Code	Un editor gratuito de Microsoft.	Es tu escritorio de trabajo digital: a la izquierda ves tus carpetas, al centro los archivos, y en un panel conversas con Claude. Todo en una ventana.
Claude Code	El programa que conecta la IA con tu computador.	Es lo que le permite a la IA crear archivos de verdad, no solo darte texto para copiar y pegar.

¿Por qué no usar solo el chat de claude.ai?

Porque el chat te devuelve texto y tú lo copias a mano. Claude Code deja el archivo terminado en tu carpeta. Es la diferencia entre un asesor que te dicta la carta por teléfono y uno que te la deja escrita, impresa y sobre el escritorio.

Instalación paso a paso

Elige tu sistema. Lo que aprendas sirve igual en los dos — solo cambian dos comandos.

Instala Visual Studio Code Entra a code.visualstudio.com y presiona el botón azul grande de descarga. Ejecuta el archivo que se baja (VSCodeUserSetup-…exe).
Durante la instalación acepta todo por defecto, pero en la pantalla de "Tareas adicionales" marca la casilla que dice "Agregar a PATH". Suele venir marcada; si no, márcala. Sigue: Siguiente → Siguiente → Instalar.

Verifica
Abre VS Code. Debería aparecer una ventana con una barra de íconos a la izquierda y una pantalla de bienvenida. Si la ves, listo.
Abre PowerShell Presiona la tecla Windows, escribe PowerShell y presiona Enter. Se abre una ventana azul oscuro con texto. Esa es la terminal: un lugar donde le das órdenes al computador escribiendo en vez de haciendo clic.
No le tengas miedo. No vas a romper nada escribiendo lo que te indico.
Instala Claude Code Copia este comando, pégalo en PowerShell (clic derecho pega) y presiona Enter:
```
irm https://claude.ai/install.ps1 | iex
```
Va a descargar e instalar solo. Tarda uno o dos minutos y escupe bastante texto. Espera a que vuelva a aparecer el cursor parpadeando.

Paso crítico que casi todos se saltan
Cierra PowerShell por completo y vuelve a abrirlo. Sin esto, el computador no se entera de que instalaste algo nuevo, y el siguiente paso va a fallar.
Verifica
En la ventana nueva de PowerShell, escribe:
```
claude --version
```
Debería responder con un número de versión, algo así:
```
2.0.14 (Claude Code)
```
Si dice "no se reconoce el término 'claude'", mira los problemas comunes más abajo. No sigas hasta que este comando responda.
Instala la extensión de Claude en VS Code Abre VS Code. En la barra izquierda, haz clic en el ícono de Extensiones (cuatro cuadraditos, uno separado). En el buscador escribe Claude Code.
Busca la que dice publisher: Anthropic — es la oficial. Presiona Install.

Verifica
Al terminar aparece un ícono nuevo de Claude en la barra izquierda de VS Code.
Inicia sesión En VS Code abre la terminal integrada: menú Terminal → Nueva terminal (o Ctrl + ñ). Escribe claude y Enter.
La primera vez te va a abrir el navegador para iniciar sesión. Entra con la misma cuenta de claude.ai que creaste en el módulo 01. Autoriza, vuelve a VS Code.

Verifica
En la terminal debería aparecer el saludo de Claude Code, esperando tu mensaje. Ya estás dentro.

Instala Visual Studio Code Entra a code.visualstudio.com y descarga la versión para Mac. Se baja un .zip: ábrelo y arrastra el ícono de Visual Studio Code a tu carpeta Aplicaciones.
La primera vez que lo abras, macOS te va a preguntar si estás seguro porque viene de internet. Dale Abrir.

Verifica
Se abre una ventana con una barra de íconos a la izquierda. Listo.
Abre la Terminal Presiona Cmd + Espacio, escribe Terminal y Enter. Se abre una ventana con texto. Ese es tu lugar para darle órdenes escritas al computador.
No vas a romper nada escribiendo lo que te indico.
Instala Claude Code Copia este comando, pégalo en la Terminal (Cmd + V) y presiona Enter:
```
curl -fsSL https://claude.ai/install.sh | bash
```
Descarga e instala solo. Tarda uno o dos minutos.

Paso crítico que casi todos se saltan
Cierra la Terminal por completo (Cmd + Q) y vuelve a abrirla. Sin esto, el siguiente paso va a fallar.
Verifica
En la Terminal nueva, escribe:
```
claude --version
```
Debería responder con un número de versión:
```
2.0.14 (Claude Code)
```
Si dice "command not found: claude", mira los problemas comunes más abajo. No sigas hasta que este comando responda.
Instala la extensión de Claude en VS Code Abre VS Code. En la barra izquierda, clic en Extensiones (cuatro cuadraditos). Busca Claude Code y elige la de publisher: Anthropic. Presiona Install.
Verifica
Aparece un ícono nuevo de Claude en la barra izquierda de VS Code.
Inicia sesión En VS Code abre la terminal integrada con Cmd + J. Escribe claude y Enter.
Se abre el navegador para iniciar sesión. Entra con la misma cuenta de claude.ai que creaste en el módulo 01. Autoriza y vuelve a VS Code.

Verifica
En la terminal aparece el saludo de Claude Code esperando tu mensaje. Ya estás dentro.

Crea tu carpeta de trabajo

Claude Code trabaja siempre dentro de una carpeta. Esa carpeta es su mundo: ve lo que hay adentro y no toca nada de afuera. Es una medida de seguridad, y también de orden.

Crea la carpeta En tus Documentos, crea una carpeta nueva llamada Mi Oficina IA. Sin tildes ni caracteres raros en el nombre — te ahorra problemas después.
Ábrela en VS Code Menú Archivo → Abrir carpeta… y selecciona Mi Oficina IA. VS Code te va a preguntar si confías en los autores de la carpeta: como la creaste tú, dile que sí.
Verifica
En el panel izquierdo de VS Code ahora dice MI OFICINA IA arriba. Está vacía. Perfecto.
Arranca Claude dentro de esa carpeta Abre la terminal integrada (Ctrl+ñ en Windows, Cmd+J en Mac) y escribe claude.
Desde ahora, todo lo que la IA cree va a caer dentro de esta carpeta. En el módulo 04 la vamos a ordenar bien.

Tu primer trabajo real

Basta de configurar. Vamos a hacer que la IA produzca un archivo de verdad, que puedas abrir y mostrarle a alguien.

Practica ahora — pídele un informe visual

Con claude corriendo en la terminal, pega esto y presiona Enter:

Crea un archivo llamado prueba.html con una página simple
que diga "Mi oficina con IA ya está funcionando", con un
diseño limpio, colores agradables y la fecha de hoy.

Cuando termines, dime exactamente cómo abrirlo.

Claude te va a pedir permiso para crear el archivo. Acepta. Verás el archivo prueba.html aparecer en el panel izquierdo de VS Code, en tiempo real.

Verifica — este es el momento importante del módulo

Haz clic derecho sobre prueba.html en el panel izquierdo → Reveal in File Explorer (Windows) o Reveal in Finder (Mac). Doble clic al archivo: se abre en tu navegador con la página hecha.

Acabas de hacer que una IA cree un archivo real en tu computador. Eso es lo que un chat de IA no puede hacer.

El truco del HTML — recuérdalo, lo vas a usar siempre

Cuando le pidas a Claude un informe, un resumen o una comparación, pídeselo como archivo .html en vez de texto plano. Se abre en el navegador con títulos, tablas y colores, listo para mostrarle a un cliente o al contador.

Ejemplo: "Hazme un resumen de estas ventas como un archivo informe-marzo.html, con una tabla y un gráfico simple."

Problemas comunes (léelos aunque no te pase nada)

"No se reconoce el término 'claude'" / "command not found: claude"

Causa: la terminal se abrió antes de que instalaras Claude, y no se enteró del cambio.

Solución 1: cierra la terminal completamente y ábrela de nuevo. En Windows, cierra la ventana de PowerShell. En Mac, Cmd+Q sobre la Terminal.

Solución 2: si abriste la terminal dentro de VS Code, cierra VS Code entero y vuelve a abrirlo.

Solución 3: reinicia el computador. Suena a chiste, pero resuelve este caso el 99% de las veces.

Windows bloquea el script y dice algo de "ExecutionPolicy"

Causa: Windows no deja ejecutar scripts descargados de internet, por seguridad.

Solución: cierra PowerShell. Vuelve a abrirlo, pero esta vez haz clic derecho → Ejecutar como administrador. Pega esto y acepta con S:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Luego repite el comando de instalación. Esto solo permite scripts firmados para tu usuario — no baja la seguridad del equipo.

El antivirus o Windows Defender bloquea la instalación

Causa: cualquier programa que se instala desde la terminal despierta sospechas del antivirus.

Solución: si el aviso viene de Windows y dice "Windows protegió tu PC", haz clic en Más información → Ejecutar de todas formas. Si es un antivirus de terceros, pausa la protección un minuto, instala, y vuelve a activarla.

Solo hazlo si descargaste desde claude.ai. Nunca desactives el antivirus para instalar algo que te llegó por correo o WhatsApp.

Inicié sesión pero dice que no tengo acceso o que se acabó mi cupo

Causa: la cuenta gratuita de Claude tiene un límite de mensajes cada cierto número de horas.

Solución: espera unas horas y vuelve. Si vas a usar esto todos los días, evalúa el plan pago — pero recién después del módulo 03, cuando ya sepas si te sirve.

Claude no ve mis archivos / dice que la carpeta está vacía

Causa: arrancaste claude desde una carpeta distinta a la de tu proyecto.

Solución: en VS Code, asegúrate de haber abierto la carpeta con Archivo → Abrir carpeta… (no solo un archivo suelto). Después abre la terminal integrada — esa siempre arranca dentro de la carpeta abierta.

Para confirmar dónde estás parado, escribe pwd en la terminal: te dice la ruta actual.

La terminal integrada no se abre con Ctrl + ñ

Causa: distribución de teclado. El atajo real es Ctrl + ` (la tecla del acento grave), que en el teclado español cae donde está la ñ o al lado del 1.

Solución: usa el menú Terminal → Nueva terminal. Funciona siempre.

Claude me pide permiso para todo y me cansa

Es a propósito, y es bueno. Claude no toca ningún archivo sin que lo autorices. Al principio parece tedioso; con el tiempo agradeces que nada pase a tus espaldas.

En el módulo 03 vas a aprender a manejar los permisos con criterio, sin desactivarlos a lo bruto.

Comprueba que lo entendiste

Instalaste Claude Code, escribes claude --version y la terminal responde que no conoce ese comando. ¿Qué haces primero?

Correcto. Una terminal abierta no se entera de los programas que instalas mientras está abierta — solo lee la lista de programas disponibles al arrancar. Cerrarla y abrirla de nuevo resuelve este error casi siempre.

Reinstalar no arregla nada (ya estaba instalado), y desactivar el antivirus es lo último que uno hace, nunca lo primero.

Lo que te llevas de este módulo

VS Code instalado: tu escritorio de trabajo digital.
Claude Code instalado, verificado con claude --version y con sesión iniciada.
La extensión oficial de Anthropic dentro de VS Code.
Tu carpeta Mi Oficina IA creada y abierta — el mundo donde la IA puede trabajar.
Un archivo real creado por la IA, abierto en tu navegador.
El truco de pedir los resultados como .html para que se vean bien.
Los seis errores comunes y cómo salir de cada uno.

Lo difícil ya pasó

La instalación es la única parte donde el computador puede ponerse en contra. De aquí en adelante, todo depende de cómo le hablas a la IA. Eso es el módulo 03.