Cómo usar Claude Code en Visual Studio Code

Claude Code es una herramienta de línea de comandos de Anthropic que también se integra con VS Code. Antes de usar la extensión conviene instalar el CLI, porque la extensión se apoya en él. Abre una terminal (en Windows usa PowerShell, en macOS o Linux tu terminal habitual) y ejecuta el comando de instalación con npm. Necesitas Node.js 18 o superior; comprueba tu versión con node --version. Si trabajas desde España o LATAM no hay restricciones regionales para instalar el paquete. Tras la instalación, el comando claude quedará disponible globalmente en tu sistema. Verifícalo ejecutando claude --version: deberías ver un número de versión impreso en la terminal.

npm install -g @anthropic-ai/claude-code
claude --version

Abre Visual Studio Code y ve al panel de Extensiones con el atajo Ctrl+Shift+X (Cmd+Shift+X en Mac). En el buscador escribe "Claude Code" y localiza la extensión oficial publicada por Anthropic. Pulsa Install. Una forma alternativa y más rápida es, con el CLI ya instalado, ejecutar el comando claude desde la terminal integrada de VS Code dentro de la carpeta de tu proyecto: la primera vez te ofrecerá instalar la integración del editor automáticamente. Una vez instalada verás un icono de Claude en la barra lateral y podrás abrir el panel con Cmd+Esc (Mac) o Ctrl+Esc (Windows/Linux). La extensión detecta el archivo que tienes abierto y la selección de código actual, lo que le da contexto para responder mejor.

La primera vez que lances Claude Code se abrirá un flujo de autenticación. Ejecuta claude en la terminal integrada o pulsa el icono de Claude en la barra lateral; te pedirá iniciar sesión. Se abrirá tu navegador para autorizar el acceso con tu cuenta de Anthropic (la misma de claude.ai o de la consola). Tras aceptar, vuelve a VS Code: la sesión queda guardada de forma segura en tu sistema. Si prefieres usar una API key de la consola de Anthropic en lugar de la cuenta de suscripción, puedes configurar la variable de entorno ANTHROPIC_API_KEY. El modelo por defecto es claude-opus-4-8, que ofrece la mejor capacidad de razonamiento para tareas de código; no necesitas especificarlo manualmente.

export ANTHROPIC_API_KEY="tu-api-key-aqui"

Con la sesión iniciada, abre el panel de Claude Code y escribe una instrucción en lenguaje natural. Puedes pedir cosas concretas sobre tu proyecto: "Crea una función en Python que valide un email", "Explica qué hace el archivo abierto" o "Añade manejo de errores a esta función". Claude lee el contexto de tu proyecto, propone los cambios y te muestra un diff antes de aplicar nada. Para una primera prueba segura, crea un archivo nuevo y pídele algo sencillo. Observa cómo Claude no solo escribe el código sino que explica sus decisiones. Puedes seguir conversando para refinar el resultado: "añade tests", "usa type hints", etc.

# Prompt de ejemplo para escribir en el panel de Claude Code:
# "Crea un archivo saludo.py con una función que reciba un nombre
#  y devuelva un saludo en español. Añade un test básico."

La ventaja de usar Claude Code dentro de VS Code es que cada cambio aparece como un diff visual: líneas verdes para lo añadido y rojas para lo eliminado. Antes de que nada toque tus archivos reales, decides si aceptas, rechazas o pides modificaciones. Revisa la lógica, no solo la sintaxis: comprueba que la solución encaja con las convenciones de tu proyecto. Si algo no te convence, responde en el mismo chat ("usa async/await en lugar de promesas") y Claude regenerará el diff. Cuando estés conforme, acepta los cambios y se guardarán en los archivos. Como siempre tienes el control de versiones, haz un commit tras cada tarea completada para poder revertir con facilidad si hace falta.

git add .
git commit -m "feat: función de saludo generada con Claude Code"

Si el comando claude no se reconoce, es casi siempre un problema de PATH: reinicia la terminal o comprueba que la carpeta global de npm esté en tu PATH. Si la extensión no detecta el CLI, cierra y reabre VS Code por completo. En caso de error de autenticación, ejecuta claude logout seguido de claude login para renovar la sesión. Si recibes un error de límite de uso (rate limit), espera unos minutos o revisa tu plan en la consola de Anthropic. Por último, si Claude parece no ver tus archivos, confirma que abriste VS Code desde la raíz del proyecto y no desde un archivo suelto. Estos cuatro problemas cubren la gran mayoría de incidencias de los primeros días.

claude logout
claude login