La extensión de Claude Code para VS Code es la extensión oficial de Anthropic (ID anthropic.claude-code) que pone Claude Code en un panel gráfico dentro de VS Code. La instalas desde la vista de Extensiones, inicias sesión y, a partir de ahí, Claude ve tu archivo abierto y tu selección, muestra las ediciones propuestas como diffs en paralelo que puedes aceptar o rechazar, y comparte el historial con el CLI. Requiere VS Code 1.94.0 o posterior y un plan de pago de Claude o una cuenta de Console. Si prefieres la terminal, también puedes ejecutar el CLI claude en la terminal integrada de VS Code y conservar los diffs del IDE.
Esta guía cubre la instalación, la extensión frente al CLI, la vista de diffs, el contexto de selección, los ajustes que merece la pena cambiar, los problemas habituales y una breve sección sobre JetBrains. Todo proviene de la documentación oficial de VS Code y de la documentación de JetBrains.
Instala la extensión
- Abre VS Code y pulsa
Cmd+Shift+X(Mac) oCtrl+Shift+X(Windows/Linux). - Busca Claude Code e instala la extensión de Anthropic.
- Si no aparece enseguida, reinicia VS Code o ejecuta Developer: Reload Window desde la paleta de comandos.
- Abre el panel e inicia sesión cuando te lo pida.
Requisitos:
| Requisito | Detalle |
|---|---|
| VS Code | 1.94.0 o posterior |
| Cuenta | Plan Pro, Max, Team o Enterprise, o una cuenta de Console |
| Espacio de trabajo | De confianza (la extensión no se ejecuta en Restricted Mode) |
Cursor y otros forks de VS Code
La documentación ofrece un enlace directo Install for Cursor, así que Cursor es compatible. Otros forks de VS Code pueden instalar la extensión desde el registro Open VSX. Si tu editor no puede instalarla en absoluto, abre su terminal integrada y ejecuta claude.
Abre Claude Code
Hay cuatro formas de entrar:
- Icono Spark en la barra de herramientas del editor, arriba a la derecha. Solo se muestra cuando hay un archivo abierto.
- Lista de sesiones en la Activity Bar, a la izquierda.
- Paleta de comandos (
Cmd+Shift+P/Ctrl+Shift+P): escribe «Claude Code» y elige Open in New Tab. - Barra de estado: haz clic en ✻ Claude Code en la esquina inferior derecha. Funciona sin archivo abierto.
Puedes arrastrar el panel a la barra lateral secundaria (derecha), a la primaria (izquierda) o a la zona del editor como pestaña. La documentación sugiere la barra lateral para tu sesión principal y las pestañas para tareas secundarias.
¿Extensión o CLI en la terminal integrada?
Los dos son el mismo Claude Code. La diferencia es la interfaz y un puñado de funciones.
| Función | CLI | Extensión de VS Code |
|---|---|---|
| Comandos y skills | Todos | Un subconjunto (escribe / para verlos) |
| Configuración de servidores MCP | Sí | Sí, con /mcp en el panel |
| Checkpoints | Sí | Sí |
Atajo de shell ! | Sí | No |
| Autocompletado con tabulador | Sí | No |
El detalle que confunde a mucha gente: instalar la extensión no añade claude al PATH. La extensión incluye una copia privada del CLI para su panel. Para escribir claude en una terminal necesitas la instalación del CLI independiente.
Una vez instalados los dos, comparten el historial de conversaciones. Ejecuta claude --resume en la terminal para retomar una conversación que empezaste en el panel.
Para ejecutar el CLI dentro de VS Code, pulsa Ctrl+` (o Cmd+` en Mac) y ejecuta claude. Se conecta al IDE automáticamente para los diffs y los diagnósticos. Desde una terminal externa, ejecuta /ide dentro de Claude Code para conectarlo a VS Code.
Si te gusta la interfaz de terminal pero la quieres en lugar del panel, activa el ajuste Use Terminal (claudeCode.useTerminal).
Regla práctica: usa el panel cuando quieras revisar diffs con clics y ver los planes como documentos. Usa el CLI cuando quieras todos los comandos slash, el modo shell ! y los atajos de teclado de nuestra hoja de referencia.
Contexto de selección y menciones con @
La extensión añade a tu mensaje el archivo abierto en el editor, y Claude ve el texto que tienes seleccionado. No necesitas pegar código en el prompt.
Option+K(Mac) /Alt+K(Windows/Linux) inserta una referencia al archivo y la selección actuales, como@auth.ts#5-10. El editor debe tener el foco.@en el cuadro del prompt menciona cualquier archivo o carpeta.@terminal:namehace referencia a la salida de una terminal.Cmd+Esc/Ctrl+Escalterna el foco entre el editor y Claude.
Nota de privacidad: el texto seleccionado no se envía desde archivos que coincidan con files.exclude o search.exclude, ni desde archivos ignorados por git mientras respectGitIgnore esté activado. Esto se aplica al panel de chat. Si solo quieres que se envíe tu selección y no todo el archivo abierto, desactiva attachOpenFile.
La vista de diffs
Cuando Claude quiere cambiar un archivo en modo Manual, VS Code muestra un diff en paralelo de la edición propuesta. Puedes aceptarla, rechazarla o editar el texto propuesto antes de aceptar. Las versiones recientes también permiten aceptar o rechazar cambios sueltos dentro de una misma edición, con Accept Change at Cursor y Reject Change at Cursor en la paleta de comandos. Las ediciones muy grandes (más de 100 cambios) no tienen botones por cambio.
La frecuencia con la que ves diffs depende del modo de permisos del cuadro del prompt:
| Modo | Qué ocurre |
|---|---|
| Manual | Claude pregunta antes de cada edición y muestra el diff |
| Edit automatically | Las ediciones se aplican sin preguntar |
| Plan | Claude escribe un plan como documento Markdown que puedes comentar y luego espera |
| Auto | Claude decide con una comprobación de seguridad; es el valor por defecto en las versiones recientes |
Los checkpoints se apoyan en esto. Pasa el cursor sobre un mensaje para ver el botón de rebobinar: Rewind code to here, Fork conversation from here, o ambos a la vez.
Ajustes que merece la pena cambiar
Abre los ajustes de VS Code (Cmd+, / Ctrl+,) y ve a Extensions > Claude Code. Los ajustes compartidos, como los comandos permitidos, los hooks y los servidores MCP, van en ~/.claude/settings.json, que el CLI también lee.
| Ajuste | Valor por defecto | Por qué cambiarlo |
|---|---|---|
useTerminal | false | Abrir la interfaz estilo CLI en lugar del panel de chat |
initialPermissionMode | sin definir | Empezar los chats nuevos en default, plan, acceptEdits o bypassPermissions |
preferredLocation | panel | sidebar mantiene Claude acoplado a la derecha |
attachOpenFile | true | Desactívalo para enviar solo tu selección |
autosave | true | Guarda los archivos antes de que Claude los lea o escriba |
useCtrlEnterToSend | false | Usar Ctrl/Cmd+Enter para enviar y Enter para saltos de línea |
respectGitIgnore | true | Mantiene los archivos ignorados por git fuera de la búsqueda y del contexto de selección |
environmentVariables | [] | Variables de entorno solo para el proceso de Claude |
allowDangerouslySkipPermissions | false | Añade Bypass permissions al menú de modos. Solo en sandboxes |
initialPermissionMode se lee solo de tus ajustes de usuario, no de los ajustes del espacio de trabajo. Añade "$schema": "https://json.schemastore.org/claude-code-settings.json" a settings.json para tener autocompletado.
Ejecuta varias conversaciones
Open in New Tab (Cmd+Shift+Esc / Ctrl+Shift+Esc) y Open in New Window inician conversaciones adicionales con su propio historial. Un punto de color en el icono spark de la pestaña indica el estado: azul para una solicitud de permiso pendiente, naranja cuando Claude terminó mientras la pestaña estaba oculta. La lista de sesiones puede agrupar sesiones y filtrar por Needs input, Working o Completed.
Soluciona los problemas habituales
| Problema | Solución |
|---|---|
| La extensión no se instala | Comprueba que VS Code sea 1.94.0+, que pueda instalar extensiones, o instálala desde la página del Marketplace |
| No aparece el icono Spark | Abre un archivo (una carpeta sola no basta), confía en el espacio de trabajo, desactiva las extensiones de IA en conflicto y recarga la ventana |
Cmd+Esc no hace nada en macOS | macOS Tahoe lo asigna a Game Overlay. Desactívalo en Keyboard Shortcuts → Game Controllers, o reasigna Claude Code: Focus input |
| «Not logged in · Please run /login» | Recarga la ventana e inicia sesión de nuevo |
ANTHROPIC_API_KEY no se detecta | Lanza VS Code desde una terminal con code . para que herede el entorno |
claude no se encuentra en la terminal | Instala el CLI independiente; la extensión no lo añade al PATH |
| Claude nunca responde | Comprueba la conexión, inicia una conversación nueva y prueba claude en una terminal para ver un error más claro |
| Necesitas los logs | Ejecuta Claude Code: Show Logs desde la paleta de comandos |
Claude Code en los IDE de JetBrains
El plugin Claude Code [Beta] del JetBrains Marketplace es compatible con IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm y GoLand. A diferencia de la extensión de VS Code, ejecuta el CLI claude en la terminal del IDE, así que instala el CLI primero. Si muestra «Cannot launch Claude Code», claude no está en tu PATH.
Qué obtienes:
Cmd+Esc/Ctrl+Escabre Claude Code desde el editor.Cmd+Option+K/Alt+Ctrl+Kinserta una referencia de archivo como@src/auth.ts#L1-99.- Los cambios propuestos se abren en el visor de diffs del IDE. Define Diff tool como
autooterminalen/config. - Tu selección y los diagnósticos del IDE (errores de lint y de tipos) se comparten con Claude.
- Desde una terminal externa, ejecuta
/idepara conectar.
Dos soluciones de la documentación: si Esc no interrumpe a Claude, ve a Settings → Tools → Terminal y desmarca «Move focus to the editor with Escape». En WSL, define el comando de Claude del plugin como wsl -d Ubuntu -- bash -lic "claude", y si ves «No available IDEs detected», añade una regla de firewall o cambia WSL a red en modo mirrored.
Cuándo tiene sentido una app aparte para muchos agentes
La extensión está pensada en torno a una ventana de editor y unas pocas conversaciones. Eso cubre la mayoría de los días. Se complica cuando ejecutas cuatro o cinco agentes a la vez en ramas distintas, o mezclas Claude Code con Codex u otros agentes CLI, y pierdes la pista de cuál necesita una respuesta.
Para ese caso está hecho AgentVera. Es una app de escritorio para macOS, Windows y Linux que ejecuta cada agente CLI en su propio panel, en una cuadrícula por proyecto. No es un editor y no sustituye a VS Code. Mucha gente mantiene ambos abiertos.
- Muchos agentes, una sola vista. El workspace distribuye los agentes en cuadrículas de hasta 5×4. La vista de grupo cuenta los agentes que están trabajando, esperando una respuesta o esperando aprobación, con Approve y Reject en cada tarjeta.
- Diffs sin cambiar de ventana. Las herramientas de editor y terminal incluyen un editor de archivos y una pestaña Changes que muestra el diff entre HEAD y el árbol de trabajo, unificado o en paralelo. Git y GitHub añade worktrees y PRs.
- Una segunda lectura. La revisión de código automática hace que un modelo de Claude que tú eliges revise el código de un agente cuando termina su turno, con enlaces archivo:línea.
Si estás montando trabajo en paralelo, el siguiente paso son los git worktrees para agentes en paralelo.
Para probar AgentVera, empieza en la página de inicio.