Instalación y configuración: VS Code, Claude Code, el primer arranque

Módulo: 2. Inicio rápido | Tiempo: ~20 min de teoría + 30 min de práctica

Lo esencial

El taller de un artesano tiene que estar bien equipado antes de empezar a trabajar. Esta lección equipa tu taller: el editor de código, la conexión con el agente y la suscripción adecuada. Lo configuras una vez y de ahí en adelante solo trabajas.

Conceptos clave

• VS Code (un editor de código popular de Microsoft): por qué este editor y cómo está organizado
• Claude Code como extensión dentro de VS Code
• Elegir la suscripción: qué incluye Pro y cuándo hace falta Max
• La estructura del espacio de trabajo: carpeta = proyecto

Teoría

VS Code: un IDE (Integrated Development Environment, entorno de desarrollo) gratuito y de primer nivel

🎨 Imagínalo así: VS Code es como el banco de trabajo de un carpintero. No es la herramienta en sí: es el lugar de trabajo donde tienes todas las herramientas a la mano: las sierras (la terminal, un programa para trabajar con la línea de comandos), las reglas (la búsqueda), el archivero de planos (el explorador de archivos). Claude Code es el ayudante inteligente que pusiste junto al banco.

Visual Studio Code es un editor de código de Microsoft. Es gratuito. Funciona en Mac, Windows y Linux. Es uno de los editores de código más populares del mundo.

¿Por qué VS Code y no Cursor, Devin Desktop (así se llama desde junio de 2026 el antiguo Windsurf) u otros editores con IA?

• Gratuito: no pagas suscripciones extra por el editor
• Estándar: todos los ejemplos y tutoriales están escritos para VS Code
• Extensible: Claude Code se integra como extensión sin perder funciones
• Estable: una herramienta probada durante años, no una startup que podría cerrar

Descárgalo en code.visualstudio.com → botón Download para tu sistema operativo.

💡 El editor no es obligatorio. A octubre de 2026, Claude Code no funciona solo en VS Code: está la terminal, extensiones para VS Code, Cursor y JetBrains, la app de Claude para computadora (pestaña Code, sin terminal), el navegador en claude.ai/code y el celular. Esta lección usa VS Code porque es visual para quien empieza. La app sin terminal está en la lección Claude Code Desktop.

La estructura de la interfaz de VS Code

Después de instalarlo verás varias zonas clave:

Barra lateral (izquierda):

• Ícono de hoja de papel: el explorador de archivos. Muestra todos los archivos de la carpeta abierta
• Ícono de lupa: búsqueda en todos los archivos
• Ícono de rompecabezas: extensiones (aquí instalarás Claude Code)
• Ícono de Git (un sistema de control de versiones del código): manejo de versiones (te servirá más adelante)

Área principal (centro): El editor de código y de archivos. Cuando abras cualquier archivo, aparecerá aquí.

Panel (abajo): La terminal: la línea de comandos dentro de VS Code. Muy práctico: no tienes que abrir una terminal aparte.

Panel de Claude Code (derecha): Después de instalar la extensión aparecerá un chat con el agente (un agente es un programa que ejecuta tareas de forma autónoma). Aquí le darás tareas a Claude Code.

Instalar Claude Code

1. Abre VS Code
2. Haz clic en el ícono de rompecabezas de la barra izquierda (Extensions), o presiona Ctrl+Shift+X (Win) / Cmd+Shift+X (Mac)
3. En la barra de búsqueda escribe: Claude Code
4. Busca la extensión de Anthropic, con el logo de Anthropic (necesitas VS Code 1.94 o más reciente)
5. Haz clic en Install
6. Después de instalarla, aparecerá un ícono nuevo en la barra izquierda: el botón de Claude Code

Autenticación: conectarte a Claude

La primera vez que abras Claude Code, te pedirá iniciar sesión con tu cuenta de Anthropic.

1. Haz clic en Sign In
2. Se abrirá el navegador en claude.ai
3. Inicia sesión en tu cuenta (o crea una nueva)
4. Confirma el permiso: Claude Code se conectará a tu cuenta
5. Regresa a VS Code: el agente está listo para trabajar

Para entrar necesitas un plan de pago de Claude (Pro, Max, Team o Enterprise) o una cuenta en Anthropic Console con pago por tokens. En el plan gratuito, Claude Code no está disponible. Un recordatorio: los servicios de Anthropic no funcionan en todos los países; revisa que el tuyo esté en la lista oficial de países soportados (más detalles en la lección Tus primeros 30 minutos con la IA).

Suscripción: Pro vs. Max, cuál elegir

🎨 Imagínalo así: Pro vs. Max es como elegir entre una motoneta y una moto para trabajar de repartidor. Con la motoneta llegas, pero si manejas de la mañana a la noche, la moto es más cómoda. Si trabajas con el agente varias horas al día, los límites de Pro pueden cortarte en el peor momento.

Es una decisión importante, porque influye directamente en cuánto tiempo podrás trabajar sin pausas.

El modelo Fable 5.1, para las tareas más difíciles, se activa a mano con el comando /model fable; en las suscripciones puede descontarse de los usage credits (Claude Code te pedirá permiso). La lista vigente de modelos y precios: Lo vigente y claude.com/pricing.

Recomendación para este curso:

Para hacer las lecciones, empieza con Pro. Max tiene sentido cuando chocas seguido con los límites y eso te estorba para trabajar.

Una aclaración honesta: la suscripción es un gasto, no una garantía de recuperarlo. Antes de pagar más, revisa con /usage cuánto usas en realidad.

Abrir un proyecto: carpeta = proyecto

🎨 Imagínalo así: la carpeta del proyecto es para el agente como un cuarto para un trabajador. Ve todo lo que hay en el cuarto y puede trabajar con todo lo que está ahí. No sale por la puerta (eso es seguridad). No mezcles proyectos en una carpeta: sería como meter a dos clientes distintos en el mismo cuarto. Un caos.

En Claude Code (y en VS Code en general), una carpeta = un proyecto. El agente trabaja en el contexto (el contenido de la conversación que la IA ve) de la carpeta que abriste.

Cómo abrir una carpeta:

1. File → Open Folder (o Cmd+O en Mac)
2. Elige la carpeta donde vivirá tu proyecto
3. VS Code la abrirá como espacio de trabajo

Por qué importa:

• El agente ve todos los archivos de esa carpeta
• El agente entiende la estructura del proyecto
• El agente no ve los archivos fuera de la carpeta (eso es bueno: seguridad)
• El archivo CLAUDE.md (lo veremos en la lección CLAUDE.md: el prompt de sistema del proyecto) vive en la raíz de esa carpeta

Un consejo para organizarte: Crea una carpeta ~/Projects/ (o ~/Proyectos/) y dentro de ella una carpeta aparte para cada proyecto. No mezcles proyectos distintos en una sola carpeta.

Ejemplo de estructura:

~/Projects/
  ├── newsletter-automation/    ← un proyecto
  ├── lead-qualifier/           ← otro proyecto
  └── client-reporting/         ← uno más

🎨 Imagínalo así: la primera conversación con el agente es como el primer día de un empleado nuevo en la oficina. Déjalo que mire alrededor: "revisa qué hay aquí". Luego dale una primera tarea pequeña. Luego una más difícil. No lo avientes de entrada con "ordena la base de datos de clientes".

La primera conversación con el agente

Después de configurarlo, abre el panel de Claude Code (el ícono de la barra izquierda o el botón de la barra inferior).

Verás un campo de texto. Escribe algo sencillo:

Hola. Acabo de abrir esta carpeta. ¿Qué ves en ella?

El agente revisará el contenido de la carpeta y te dirá qué hay. Si la carpeta está vacía, te lo dirá.

Prueba otra solicitud:

Crea un archivo README.md que describa que este es un proyecto de prueba para aprender.

El agente creará el archivo. Lo verás en el explorador de archivos de la izquierda.

Esta es tu primera interacción con el agente como una herramienta real.

Atajos de teclado importantes (apréndelos desde el primer día)

Práctica

Tarea: instalar VS Code + Claude Code y hacer la primera prueba.

Paso 1. Instalación (10 min):

1. Descarga VS Code de code.visualstudio.com
2. Instálalo (instalación estándar, sin cambiar nada)
3. Instala la extensión Claude Code desde la tienda de extensiones

Paso 2. Configurar la cuenta (5 min):

1. Inicia sesión en Claude Code con tu cuenta de Anthropic
2. Comprueba que el agente responde (escribe "Hola")

Paso 3. Primer proyecto (15 min):

1. Crea una carpeta my-first-agent en un lugar cómodo
2. Ábrela en VS Code con File → Open Folder
3. Dale al agente tres tareas, una por una:
   • "Crea un archivo hello.md con el título «Mi primer proyecto con agentes» y tres puntos sobre lo que quiero aprender"
   • "Crea una carpeta docs y mueve hello.md ahí"
   • "¿Qué hay ahora en esta carpeta?"
4. Revisa el explorador de archivos: confirma que todo se hizo bien

Errores comunes

❌ Error: abrir toda tu carpeta personal (~/) como proyecto en VS Code. ✅ Lo correcto: una carpeta = un proyecto. Crea una carpeta aparte para cada proyecto. El agente ve todos los archivos de la carpeta abierta: si abres la raíz, se pierde entre miles de archivos.

❌ Error: contratar el plan más caro "para crecer", sin comprobar si Pro te alcanza. ✅ Lo correcto: empieza con Pro. Si chocas seguido con los límites trabajando varias horas al día, entonces mira Max. Los límites dependen del modelo y de la carga; puedes revisarlos con el comando /usage.

❌ Error: no usar la terminal dentro de VS Code (abrir una terminal aparte). ✅ Lo correcto: la terminal integrada (Ctrl+`) trabaja en el contexto de la carpeta abierta. Claude Code también trabaja en ese contexto. Todo en una ventana = menos confusión.

Otra forma de instalarlo: por la terminal (CLI, interfaz de línea de comandos)

Claude Code también se puede instalar como herramienta CLI directamente en la terminal, sin VS Code. A octubre de 2026, la forma principal es el instalador nativo, que no necesita Node.js:

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

Después de instalarlo, entra a la carpeta del proyecto y ejecuta el comando claude. Hay otras formas: Homebrew (brew install --cask claude-code), WinGet (winget install Anthropic.ClaudeCode) y npm (npm install -g @anthropic-ai/claude-code, necesita Node.js 22+). El instalador nativo se actualiza solo; Homebrew y WinGet hay que actualizarlos a mano. Requisitos de la computadora: macOS 13+, Windows 10 versión 1809+, 4 GB de memoria.

Instrucciones detalladas: code.claude.com/docs/en/setup

Esta forma es para quienes prefieren trabajar en la terminal. Para quien empieza, se recomienda VS Code o la app de escritorio: son más visuales.

Herramientas y recursos

• VS Code: el sitio oficial para descargarlo
• Claude.ai: crear la cuenta de Anthropic (la necesitas antes de autenticarte en la extensión)
• VS Code Marketplace: la tienda de extensiones (busca: Claude Code)
• Anthropic Pricing: comparación de planes de suscripción
• Claude Code: instalación: la guía oficial de instalación
• Claude Code: Getting Started: inicio rápido
• Claude Code GitHub: issues (reportes de errores), el registro de cambios (CHANGELOG), plugins y ejemplos; el código fuente del CLI no está en este repositorio
• Node.js: solo lo necesitas para instalar por npm (versión 22+)

→ Ve la lección Fundamentos del prompting: cómo darle tareas al agente → Ve la lección CLAUDE.md: el prompt de sistema del proyecto: el primer archivo que conviene crear → Ve la lección Planes y niveles de acceso: el mapa detallado de planes

Conclusiones clave

VS Code es un IDE gratuito y estable. Una carpeta = un proyecto. El agente trabaja en el contexto de la carpeta abierta.

Empieza con Pro. Max hace falta cuando chocas seguido con los límites, no "por si acaso".

La primera conversación con el agente no requiere código: solo explica en español lo que quieres.

Siguiente lección

→ Claude Code Desktop: trabajar sin terminal (o directo a → Fundamentos del prompting: cómo darle tareas al agente para obtener un buen resultado)