Claude Code en Visual Studio Code es la forma de usarlo sin mirar una terminal y viendo cada cambio dentro del propio archivo, antes de aceptarlo. Casi todas las guías lo explican para programadores. Esta no: aquí va qué es cada cosa, cómo se instala la extensión oficial en cinco minutos, tres encargos con documentos de oficina, cómo se deshace un cambio y cuándo compensa frente a la terminal o la app de escritorio.
Claude Code y Visual Studio Code: qué es cada cosa
Son dos piezas distintas, y conviene separarlas antes de instalar nada.
Claude Code es Claude trabajando dentro de una carpeta de tu ordenador. Lee los archivos, crea otros y los modifica cuando se lo pides. Normalmente se usa desde la terminal, esa ventana negra donde se escribe en vez de hacer clic. Si partes de cero, antes: qué es Claude Code.
Visual Studio Code (VS Code para los amigos) es un editor gratuito de Microsoft. Lo usan sobre todo programadores, pero en realidad es una ventana con tus carpetas a la izquierda y el archivo abierto en el centro. Abre cualquier archivo de texto: notas, plantillas, listados, tablas en CSV.
¿Y qué pasa al juntarlos? Que Claude Code deja la terminal y se instala como un panel dentro del editor. Hace lo mismo, pero ves los cambios donde ocurren: en el archivo, con lo que quita y lo que pone marcado en colores.
Cómo instalar Claude Code en Visual Studio Code, paso a paso
Antes de nada, tres cosas que te van a pedir:
- Una cuenta de Claude de pago. Pro, Max, Team o Enterprise. El plan gratuito no incluye Claude Code, tampoco aquí. Cuál te conviene, en qué plan de Claude necesitas.
- VS Code actualizado. La documentación pide la versión 1.94 o posterior. Si lo instalas hoy desde la web de Visual Studio Code, ya la cumples.
- Una carpeta de prueba con copias. Diez o quince archivos duplicados de una carpeta real. Claude Code cambia archivos de verdad, y la primera semana nada debería depender de que acierte.
Lo que no te hace falta: instalar Claude Code por separado. La extensión trae su propia copia dentro. Solo necesitarías la instalación aparte si un día quieres escribir claude en la terminal que VS Code lleva integrada, y para empezar no es el caso.
Con eso listo, la instalación son cinco pasos:
- Abre el panel de extensiones con Ctrl+Mayús+X (Cmd+Mayús+X en Mac). Es la tienda de complementos del editor.
- Busca «Claude Code» e instala la que publica Anthropic, la empresa que hace Claude. Fíjate en el autor: hay extensiones de otros con nombres parecidos.
- Abre tu carpeta de prueba desde Archivo → Abrir carpeta. Esa carpeta es la que Claude va a poder leer y tocar, y ninguna otra.
- Abre un archivo cualquiera y pulsa el icono de la chispa que aparece arriba a la derecha. Es el icono de Claude Code; también está siempre en la barra lateral izquierda.
- Inicia sesión. Se abre el navegador, entras con tu cuenta de Claude y vuelves. Se hace una vez.
Si después de instalar no aparece la chispa, cierra y abre VS Code. Es el arreglo que da la propia guía oficial de la extensión, y suele bastar.
Tres encargos para la primera tarde
El panel de Claude es una caja de texto como la del chat. Le escribes en castellano normal. La diferencia es que ve la carpeta, el archivo que tienes abierto y lo que tengas seleccionado.
1 · Preguntar sin tocar nada. Empieza siempre por aquí, para ver cómo trabaja:
Mira los documentos de esta carpeta y dime cuáles mencionan plazos de entrega, con el plazo de cada uno. No cambies nada. Si un documento no lo dice claramente, ponlo aparte.
«Ponlo aparte» es la frase que importa. ¿Por qué? Porque sin ella, Claude tiende a rellenar el hueco con algo que suena bien. Con ella, las dudas quedan a la vista y las revisas tú (en dos minutos, normalmente).
2 · Cambiar un trozo concreto. Abre una plantilla de correo, selecciona un párrafo con el ratón y escribe en el panel:
Reescribe el párrafo seleccionado en tuteo, más corto y sin fórmulas de cortesía de carta antigua. Mantén los datos tal cual.
No tienes que copiar ni pegar: Claude ve la selección. Si además quieres que quede apuntado qué líneas eran, Alt+K mete una referencia al archivo y a esas líneas en tu mensaje.
3 · El mismo cambio en muchos archivos. Aquí se nota la diferencia con el chat. Escribe @ y el nombre de la carpeta para señalarla:
En todas las plantillas de @plantillas/ cambia el teléfono antiguo por el nuevo, 968 111 111. No toques nada más. Al terminar, dime en qué archivos lo has cambiado y si has visto algún otro teléfono distinto.
Te enseñará los cambios archivo por archivo. Y la última frase te devuelve lo que no le pediste pero conviene saber (ese tercer teléfono que nadie recordaba).
Ver el cambio antes de aceptarlo, y cómo deshacer
Esta es la razón de usar Claude Code en VS Code. Abajo de la caja de texto hay un indicador con el modo en que trabaja. En los planes Pro, Max y Team empieza en Auto: otro modelo revisa lo que hace y Claude edita la mayoría de archivos sin preguntarte.
Para aprender, cámbialo a Manual. En ese modo, cuando Claude quiere editar un archivo, te enseña el original y la propuesta uno al lado del otro. Puedes aceptar, rechazar o decirle qué hacer en su lugar. Si el cambio tiene varias partes, hay un botón para aceptar o rechazar cada una.
El tercer modo que conviene conocer es Plan. Claude te describe lo que va a hacer y espera. VS Code abre ese plan como un documento en el que puedes dejar comentarios, como harías con un borrador de un compañero. Úsalo en encargos que tocan muchos archivos.
¿Y si ya aceptaste algo que no querías? Pasa el ratón por encima de tu mensaje en la conversación y aparece un botón para volver atrás. La opción «Rewind code to here» deja los archivos como estaban en ese punto y conserva la conversación.
¿Te avisamos del próximo artículo?
Publicamos uno nuevo cada día, de lunes a sábado. Te mandamos el título, dos líneas y el enlace: en cuanto sale o en un resumen los lunes. Te das de baja con un clic.
VS Code, terminal o app de escritorio: cuál te conviene
Las tres son el mismo Claude Code. Cambia la ventana, y con ella lo cómodo que resulta cada tipo de trabajo:
| Si trabajas con… | Mejor en | Por qué |
|---|---|---|
| Archivos de texto: notas, plantillas, CSV, Markdown, páginas web | VS Code | Ves el archivo y el cambio a la vez, línea a línea |
| Word, Excel y PDF sobre todo | App de escritorio, con Cowork | VS Code no abre Word ni Excel para que los leas tú; Cowork trabaja con ellos y los crea, con botones |
| Encargos largos o repetidos que ya controlas | Terminal | Tiene todos los comandos; la extensión, solo una parte |
| Nunca has abierto ninguna de las tres | App de escritorio | Es la puerta con menos cosas nuevas a la vez |
La regla general: si ya usas VS Code para algo, o tus archivos son de texto, la extensión es la forma más cómoda de fiarte de lo que hace Claude. Si tu día es Word y Excel, la app de escritorio es más natural.
Cómo se instala está en Claude en el escritorio, y su modo con botones para carpetas, en Claude Cowork.
Lo que no cambia por usarlo dentro de un editor
Se equivoca igual. Un dato inventado sale con los mismos colores que uno correcto. Por eso los encargos llevan «si no lo sabes, dímelo», y por eso se revisa. De dónde sale ese vicio, en por qué la IA se inventa cosas.
Los datos de otras personas siguen sus reglas. Que el archivo esté en tu ordenador no significa que se quede ahí: lo que Claude lee pasa por sus servidores. Con nombres de clientes, cuenta de empresa y criterio (qué se puede meter en la IA y qué no).
Gasta igual. Leer una carpeta entera varias veces consume tu cuota del plan. Agrupa los encargos.
VS Code no hace a Claude Code más listo: hace visibles sus cambios antes de que pasen. Para quien no programa, es la diferencia entre fiarse y comprobar.
Por dónde empezar
Con la carpeta de copias y el primer encargo, el que no toca nada. Después, un archivo que le explique a Claude cómo se trabaja en esa carpeta, el CLAUDE.md. Los comandos y el resto de la primera hora están en el tutorial de Claude Code, y valen igual aquí.
Lo que decide si sale bien, en VS Code como en el chat, es cómo se pide: contexto, tarea, formato y límites. Es lo que se practica en Creación de prompts de Claude. Y si lo va a usar un equipo con carpetas compartidas, cuéntanoslo en la página de empresas.
Preguntas frecuentes
¿Cómo se usa Claude Code en Visual Studio Code?
Con la extensión oficial de Anthropic: se instala desde el panel de extensiones buscando «Claude Code», se abre una carpeta y se pulsa el icono de la chispa. Aparece un panel donde se le escribe como en el chat, y los cambios que propone se ven en el propio archivo antes de aceptarlos.
¿Hace falta instalar Node.js o Claude Code aparte para usar la extensión?
No. La extensión trae su propia copia de Claude Code para el panel, y no necesita Node.js. Muchas guías de 2025 lo piden porque entonces era así. Solo hace falta la instalación aparte si quieres escribir claude en la terminal integrada de VS Code.
¿La extensión de Claude Code para VS Code es gratis?
La extensión se instala gratis, pero para usarla hace falta una cuenta de Claude de pago (Pro, Max, Team o Enterprise) o una cuenta de la consola de Anthropic que se paga por consumo. El plan gratuito de Claude no incluye Claude Code.
¿Claude Code en VS Code pide permiso antes de cambiar archivos?
Depende del modo. En Manual enseña el original y la propuesta lado a lado y espera tu decisión. En Auto, que es el modo con el que empiezan los planes Pro, Max y Team, edita la mayoría de archivos sin preguntar. Se cambia en el indicador de modo, debajo de la caja de texto.
¿Funciona en Cursor y en otros editores?
Sí. La misma extensión se instala en Cursor y en otros editores derivados de VS Code. Para los de JetBrains hay un complemento propio. Y en cualquier editor que tenga terminal se puede usar la versión de terminal.