Domingo, 15 de noviembre de 2026  ·  Español
Principiante 24 min en total 7 pasos

Cómo usar Claude Code en Visual Studio Code

Instala la extensión oficial de Anthropic, inicia sesión y revisa cada cambio que Claude propone sin salir del editor.

Daniel Puentes Prias
Consultor de IA · Actualizado el 23 de octubre de 2026
Imagen de portada editorial · Cómo usar Claude Code en Visual Studio Code · Educación · Claude Builders
Requisitos
  • Visual Studio Code 1.94.0 o superior
  • Un plan de pago de Claude (Pro, Max, Team o Enterprise) o una cuenta de la consola de Anthropic
  • Conexión a internet
Lo que vas a aprender
  • Instalar la extensión oficial de Claude Code en VS Code
  • Abrir el panel e iniciar sesión con tu cuenta
  • Pedirle tareas citando archivos y líneas
  • Revisar y aceptar los cambios uno a uno
  • Usar la CLI en la terminal integrada y resolver los errores comunes
PASO 1 · ~2 min

Comprobar la versión de VS Code y tu cuenta

La extensión pide Visual Studio Code 1.94.0 o superior; la versión está en Ayuda, Acerca de. Para iniciar sesión sirve cualquier plan de pago de Claude (Pro, Max, Team o Enterprise) o una cuenta de la consola de Anthropic que paga por uso. El plan gratuito de claude.ai no incluye Claude Code. No hace falta instalar Node.js ni crear una API key: la extensión trae su propia copia de Claude Code para el panel de chat.

Error comúnVisual Studio, el IDE de Microsoft (por ejemplo Visual Studio 2026), es un programa distinto de Visual Studio Code y la extensión no se instala ahí. En ese caso instala la CLI (paso 6) y ejecuta claude en su terminal.
PASO 2 · ~2 min

Instalar la extensión oficial

En VS Code abre la vista de Extensiones con Ctrl+Shift+X en Windows y Linux o Cmd+Shift+X en Mac, busca Claude Code y pulsa Install en la que publica Anthropic. La misma extensión se instala en Cursor y en otros editores basados en VS Code. Si después de instalarla no aparece, reinicia VS Code o ejecuta Developer: Reload Window desde la paleta de comandos.

ConsejoSi la instalación falla, comprueba que VS Code tiene permiso para instalar extensiones o instálala desde la página de la extensión en el Marketplace de Visual Studio.
PASO 3 · ~3 min

Abrir el panel e iniciar sesión

Claude Code se reconoce en todo VS Code por un icono de destello (Spark). Lo más rápido es pulsarlo en la barra de herramientas del editor, arriba a la derecha, que solo aparece con un archivo abierto. También está en la barra de actividad de la izquierda, en la barra de estado de abajo a la derecha como Claude Code, y en la paleta de comandos (Ctrl+Shift+P o Cmd+Shift+P) escribiendo Claude Code. La primera vez sale una pantalla de inicio de sesión: pulsa Sign in y autoriza en el navegador. Después aparece una lista de primeros pasos que puedes seguir o cerrar.

ConsejoSi tienes ANTHROPIC_API_KEY en tu terminal y aun así te pide iniciar sesión, abre VS Code desde la terminal con code . para que herede tus variables de entorno.
PASO 4 · ~5 min

Pedirle tu primera tarea

Escribe en la caja del panel lo que necesitas: que te explique un archivo, que encuentre un error o que haga un cambio. Claude ve automáticamente el texto que tengas seleccionado en el editor. Para citar un archivo y unas líneas concretas, selecciónalas y pulsa Alt+K (Option+K en Mac): se inserta una referencia como @app.py#5-10. Shift+Enter añade una línea sin enviar el mensaje, y Ctrl+Esc (Cmd+Esc en Mac) lleva el foco del editor a Claude y de vuelta.

text
Explica qué hace la función seleccionada y
si ves algún caso que no esté controlado.

Añade validación del correo en @forms.py#12-30
y escribe un test para el caso vacío.
PASO 5 · ~5 min

Revisar los cambios antes de aceptarlos

Debajo de la caja de texto se ve el modo de permisos, y se cambia pulsándolo. En Manual, cuando Claude quiere editar un archivo te muestra el original y la propuesta lado a lado y te pide permiso: aceptas, rechazas o le dices qué hacer en su lugar. Con los botones de cada cambio puedes aceptarlos o rechazarlos uno a uno. En Plan, Claude describe lo que va a hacer y espera tu aprobación antes de tocar nada. En Auto o editar automáticamente, edita la mayoría de archivos sin preguntar.

ConsejoPara tus primeras sesiones usa Manual o Plan, y haz un commit antes de cada tarea: si algo sale mal, vuelves atrás con git.
PASO 6 · ~4 min

Usar también la CLI en la terminal integrada

Algunas funciones solo están en la versión de terminal, como todos los comandos y el atajo ! para ejecutar comandos de shell. La extensión no añade claude a tu terminal: para usarlo instala la CLI una vez con el instalador oficial, abre la terminal integrada desde el menú Terminal, Nueva terminal, y escribe claude. La extensión y la CLI comparten el historial: con claude --resume retomas en la terminal una conversación que empezaste en el panel.

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

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

# En una terminal nueva
claude --version
PASO 7 · ~3 min

Resolver los problemas más comunes

Si no ves el icono de Claude, abre un archivo (con solo una carpeta abierta no sale), comprueba que tienes la versión 1.94.0 o superior, recarga la ventana y desactiva un momento otras extensiones de IA como Cline o Continue. La extensión tampoco funciona en el modo restringido de VS Code: confía en la carpeta del proyecto. En macOS Tahoe, Cmd+Esc puede no hacer nada porque el sistema lo usa para el panel de juegos: desactívalo en Ajustes del Sistema, Teclado, Atajos de teclado, Mandos de juego, o asigna otra tecla en los atajos de VS Code. Si Claude no responde, prueba claude en la terminal para ver el error completo.

Error comúnInstala solo la extensión que publica Anthropic: hay otras con nombres parecidos que no son oficiales.
Resultado

Ya tienes Claude Code dentro de Visual Studio Code: sabes instalar la extensión oficial, iniciar sesión, pedirle tareas citando archivos y líneas, revisar cada cambio antes de aceptarlo y pasar a la terminal cuando necesitas la CLI. Si quieres sacarle todo el partido a este flujo de trabajo, el siguiente paso natural es profundizar en el desarrollo asistido con IA para developers y construir proyectos más ambiciosos con buenas prácticas.

PRÓXIMOS PASOS
TÉRMINOS DE ESTE TUTORIAL
MÁS DE CLAUDE CODE