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.

  1. Entra a https://nodejs.org
  2. Descarga la versión que dice “LTS” (la más estable).
  1. Abre el archivo .msi y dale “Siguiente” hasta “Finalizar”.
  1. Abre el archivo .pkg y 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
  1. Entra a https://code.visualstudio.com
  2. Aprieta el botón azul de descarga (detecta tu sistema solo).
  1. Abre el instalador, acepta los términos y dale “Siguiente”.
  1. Descomprime el archivo y arrastra VS Code a tu carpeta de Aplicaciones.
  1. Abre VS Code para confirmar que funciona.
3 Instalar la extensión de Claude Code
  1. Abre VS Code.
  2. Abre el panel de extensiones (4 cuadritos en la barra izquierda) o usa Ctrl + Shift + XCmd + Shift + X.
  3. Busca Claude Code y elige la del creador Anthropic (la oficial). Aprieta Install.
  4. 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.)
  5. 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
  1. Abre Claude Code con su ícono (✳) (o en la terminal de VS Code escribe claude).
  2. Te pedirá iniciar sesión; se abrirá tu navegador.
  3. Inicia sesión con tu cuenta de Claude (la del plan de pago).
  4. ¡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):

  1. Instala Node.js (Paso 1).
  2. En la terminal de VS Code (Terminal → Nueva terminal) ejecuta:
npm install -g @anthropic-ai/claude-code
  1. 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
  1. En VS Code abre una carpeta con Archivo → Abrir carpeta.
  2. Abre Claude Code con su ícono (✳).
  3. Escríbele: “Crea un archivo que diga Hola Mundo en Python”.
  4. Claude te muestra lo que va a hacer y tú aceptas o rechazas con un clic.
Si algo sale mal
ProblemaSolució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 ClaudeRevisa que tu cuenta tenga plan de pago (Pro o Max)
Instalé la extensión equivocadaAsegú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.