Tutoriales · Principiante
Cómo conectar Claude a Visual Studio Code
Guía paso a paso para principiantes: instala Node.js, VS Code y Claude Code, inicia sesión y haz tu primera prueba. Incluye el atajo más rápido y los precios actuales.
- Claude Code
- VS Code
- Node.js
En esta guía vas a aprender a usar Claude Code dentro de Visual Studio Code (VS Code): un asistente que vive en tu editor y te ayuda a escribir y entender código, crear archivos y construir proyectos.
Elige tu sistema (Windows o Mac) con los botones de arriba y toca cada paso para abrirlo y seguirlo.
Antes de empezar: Claude Code necesita una cuenta de pago de Claude (Pro o Max), no hay versión 100 % gratis. Mira los precios en la columna de la derecha.
1 Instalar Node.js
Node.js es el motor que Claude Code necesita para funcionar.
- Entra a https://nodejs.org
- Descarga la versión que dice “LTS” (la más estable).
- Abre el archivo
.msiy dale “Siguiente” hasta “Finalizar”.
- Abre el archivo
.pkgy sigue los pasos.
Para comprobar que funcionó: abre PowerShellla Terminal, escribe esto y aprieta Enter:
node --version
Si aparece un número con puntos como v22.11.0, ¡listo!
2 Instalar Visual Studio Code
- Entra a https://code.visualstudio.com
- Aprieta el botón azul de descarga (detecta tu sistema solo).
- Abre el instalador, acepta los términos y dale “Siguiente”.
- Descomprime el archivo y arrastra VS Code a tu carpeta de Aplicaciones.
- Abre VS Code para confirmar que funciona.
3 Instalar la extensión de Claude Code
- Abre VS Code.
- Abre el panel de extensiones (4 cuadritos en la barra izquierda) o usa
Ctrl + Shift + XCmd + Shift + X. - Busca Claude Code y elige la del creador Anthropic (la oficial). Aprieta Install.
- La primera vez puede pedirte instalar el motor de Claude Code. Acepta. (Si te lo pide en la terminal, ejecuta
npm install -g @anthropic-ai/claude-code.) - Al terminar, verás el ícono de Claude (✳) en la barra lateral.
¿No aparece el ícono? Cierra y vuelve a abrir VS Code.
4 Iniciar sesión
- Abre Claude Code con su ícono (✳) (o en la terminal de VS Code escribe
claude). - Te pedirá iniciar sesión; se abrirá tu navegador.
- Inicia sesión con tu cuenta de Claude (la del plan de pago).
- ¡Listo! Ya puedes pedirle ayuda a Claude.
No necesitas una “API key”. Solo inicia sesión con tu cuenta.
Atajo: instálalo en 3 comandos
Si te animas con la terminal, esta es la forma más rápida (también instala la integración de VS Code por ti):
- Instala Node.js (Paso 1).
- En la terminal de VS Code (Terminal → Nueva terminal) ejecuta:
npm install -g @anthropic-ai/claude-code
- En la carpeta de tu proyecto, ejecuta:
claude
La primera vez te ofrecerá instalar la extensión de VS Code (acepta) y te pedirá iniciar sesión.
Probar que todo funcione
- En VS Code abre una carpeta con Archivo → Abrir carpeta.
- Abre Claude Code con su ícono (✳).
- Escríbele: “Crea un archivo que diga Hola Mundo en Python”.
- Claude te muestra lo que va a hacer y tú aceptas o rechazas con un clic.
Si algo sale mal
| Problema | Solución |
|---|---|
| No aparece el ícono de Claude ✳ | Cierra y vuelve a abrir VS Code |
| Dice que no encuentra “node” | Vuelve al Paso 1 e instala Node.js |
| No me deja usar Claude | Revisa que tu cuenta tenga plan de pago (Pro o Max) |
| Instalé la extensión equivocada | Asegúrate de que el creador sea Anthropic |
Preguntas frecuentes
¿Claude Code es gratis?
La extensión es gratis de instalar, pero para usarla necesitas un plan de pago de Claude (Pro desde $20/mes). No hay versión 100% gratis.
¿Necesito saber programar para usar Claude Code?
No. Le describes lo que quieres en palabras y Claude escribe el código por ti; tú revisas y apruebas. Es ideal para principiantes.
¿Funciona en Windows y en Mac?
Sí, funciona igual en ambos. Esta guía marca los pasos que cambian entre Windows y Mac con el selector de arriba.
¿Necesito una API key?
No. Solo inicias sesión con tu cuenta de Claude; no hace falta configurar ninguna API key.