Cómo usar Claude Code con VS Code

Nicolas, Apr 10, 2026

---

Claude Code es el asistente de IA de Anthropic diseñado para desarrolladores. Disponible directamente en VS Code a través de una extensión oficial, permite generar, modificar, analizar y depurar código sin salir del editor. Desde 2025, la extensión nativa es el método recomendado para usar Claude Code en VS Code — aquí te explicamos cómo instalarla y sacarle el máximo partido.

Requisitos previos a la instalación

Antes de instalar la extensión Claude Code, comprueba lo siguiente:

• VS Code 1.98.0 o superior — las versiones anteriores no son compatibles con la extensión
• Una cuenta de Anthropic — iniciarás sesión cuando abras la extensión por primera vez. Claude Code requiere una suscripción Claude Pro, Max, Team o Enterprise
• Si usas Amazon Bedrock o Google Vertex AI como proveedor, se necesita una configuración específica en settings.json

Instalar la extensión Claude Code

La instalación se realiza directamente desde VS Code en unos pocos segundos:

• Abre VS Code y pulsa Ctrl+Shift+X (Windows/Linux) o Cmd+Shift+X (Mac) para abrir el panel de Extensiones
• Busca "Claude Code" en la barra de búsqueda
• Instala la extensión publicada por Anthropic — verifica bien el editor para evitar extensiones de terceros no oficiales
• Si el icono Spark no aparece tras la instalación, reinicia VS Code o ejecuta "Developer: Reload Window" desde la paleta de comandos

Bueno saber: la extensión incluye automáticamente el CLI (interfaz de línea de comandos) de Claude Code. No necesitas instalar el CLI por separado — es accesible directamente desde el terminal integrado de VS Code para las funciones avanzadas.

Abrir Claude Code en VS Code

Una vez instalada la extensión, el icono Spark (⚡) identifica Claude Code en toda la interfaz de VS Code. Varias formas de acceder:

• Barra de herramientas del editor: haz clic en el icono Spark en la esquina superior derecha del editor — solo visible cuando hay un archivo abierto
• Barra de actividad: haz clic en el icono Spark en la barra lateral izquierda para abrir la lista de sesiones. Siempre visible incluso sin archivo abierto
• Paleta de comandos: Cmd+Shift+P / Ctrl+Shift+P, escribe "Claude Code" y selecciona "Open in New Tab"
• Barra de estado: haz clic en ✱ Claude Code en la esquina inferior derecha de la ventana

Al abrir el panel por primera vez aparece una lista de verificación de inicio guiado. Recorre cada paso haciendo clic en "Show me" o ignórala con la X.

Enviar la primera solicitud

Claude Code ve automáticamente el archivo abierto en tu editor. Para interactuar:

• Selecciona código en tu archivo — Claude Code incluye automáticamente esa selección en el contexto de tu solicitud
• Pulsa Option+K (Mac) / Alt+K (Windows/Linux) para insertar una referencia @archivo.ts#5-10 a tu selección en el prompt
• Escribe tu petición en lenguaje natural: "Explica esta función", "Corrige este error", "Añade pruebas unitarias para esta clase"…

Cuando Claude Code propone modificar un archivo, muestra una comparación diff lado a lado de los cambios propuestos antes de aplicarlos. Puedes aceptar, rechazar o pedir ajustes.

Modos de permiso

Claude Code ofrece tres modos de permiso accesibles desde la parte inferior del cuadro de prompt:

El modo Plan es especialmente útil para cambios importantes: Claude abre el plan como documento Markdown en el que puedes añadir comentarios inline antes de que empiece a modificar tu código.

Referenciar archivos con @-menciones

Para dar más contexto a Claude Code, usa las @-menciones en el prompt:

• Escribe @ seguido del nombre del archivo para mencionarlo: @auth.ts
• Añade un rango de líneas para apuntar a una sección concreta: @auth.ts#10-25
• Menciona una carpeta entera: @src/components/
• Usa Option+K / Alt+K desde una selección para insertar la referencia automáticamente

Gestionar varias conversaciones

VS Code permite abrir múltiples sesiones de Claude Code simultáneamente — útil para trabajar en paralelo en varias funcionalidades o carpetas de workspace:

• Cada sesión mantiene su propio contexto independiente
• Abre una nueva conversación con Cmd+N (Mac) / Ctrl+N (Windows/Linux) desde el panel de Claude
• Accede al historial de conversaciones desde el icono Spark de la barra de actividad
• Las sesiones pueden abrirse como pestañas o ventanas separadas según tus preferencias

Bueno saber: si trabajas en un proyecto monorepo o de microservicios, cada carpeta de workspace puede tener su propia sesión de Claude Code con su propio contexto. Para personalizar el comportamiento de Claude en tu proyecto, crea un archivo CLAUDE.md en la raíz de tu repositorio — Claude Code lo leerá automáticamente para adaptar sus respuestas a tu proyecto, tus convenciones e instrucciones específicas.

Usar el CLI desde el terminal integrado

La extensión de VS Code incluye el CLI de Claude Code, accesible desde el terminal integrado de VS Code. El CLI ofrece funciones avanzadas no disponibles en la interfaz gráfica:

• Ejecuta claude en el terminal integrado para iniciar una sesión CLI
• Usa claude -p "tu prompt" para solicitudes no interactivas (modo print)
• El comando /terminal-setup en una sesión configura automáticamente el atajo Shift+Enter para prompts multilínea
• Cambia entre la interfaz gráfica y el CLI a través del menú de configuración de la extensión

Atajos de teclado esenciales

Bueno saber: Claude Code para VS Code también funciona con Cursor, Windsurf y VSCodium — el procedimiento de instalación es idéntico. Para equipos que usan Amazon Bedrock o Google Vertex AI, añade las variables de entorno correspondientes en el archivo settings.json de VS Code para configurar el proveedor alternativo.