# Extensión de Claude Code para VS Code: guía y ajustes

URL: https://agentvera.dev/es/blog/claude-code-vs-code/ · Publicado: 2026-10-23

Instala la extensión de Claude Code para VS Code, usa el contexto de selección y la vista de diffs, elige los ajustes adecuados, resuelve fallos y úsala en JetBrains.

**En resumen:**

- La extensión oficial de Claude Code (anthropic.claude-code) requiere VS Code 1.94.0 o posterior y un plan Pro, Max, Team o Enterprise, o una cuenta de Console.
- Instalar la extensión no añade claude al PATH; instala el CLI independiente para usarlo en una terminal, y ambos comparten el historial de conversaciones.
- En los IDE de JetBrains, el plugin Claude Code [Beta] ejecuta el CLI claude en la terminal del IDE, así que primero hay que instalar el CLI.

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](https://code.claude.com/docs/en/vs-code "Claude Code en VS Code") y de la [documentación de JetBrains](https://code.claude.com/docs/en/jetbrains "Claude Code en los IDE de JetBrains").

## Instala la extensión

1. Abre VS Code y pulsa `Cmd+Shift+X` (Mac) o `Ctrl+Shift+X` (Windows/Linux).
2. Busca **Claude Code** e instala la extensión de Anthropic.
3. Si no aparece enseguida, reinicia VS Code o ejecuta **Developer: Reload Window** desde la paleta de comandos.
4. 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](https://code.claude.com/docs/en/setup "Instalar Claude Code").

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](/es/blog/claude-code-commands-cheat-sheet/ "Hoja de referencia de comandos de Claude Code").

## 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:name` hace referencia a la salida de una terminal.
- `Cmd+Esc` / `Ctrl+Esc` alterna 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+Esc` abre Claude Code desde el editor.
- `Cmd+Option+K` / `Alt+Ctrl+K` inserta 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 `auto` o `terminal` en `/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 `/ide` para 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](/es/blog/best-ai-coding-cli-tools/ "Las mejores herramientas CLI de programación con IA"), y pierdes la pista de cuál necesita una respuesta.

Para ese caso está hecho [AgentVera](/es/agents/claude-code/ "Claude Code en 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](/es/features/workspace/ "Workspace") distribuye los agentes en cuadrículas de hasta 5×4. La [vista de grupo](/es/features/group-view/ "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](/es/features/editor-and-terminal/ "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](/es/features/git-and-github/ "Git y GitHub") añade worktrees y PRs.
- **Una segunda lectura.** La [revisión de código automática](/es/features/code-review/ "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](/es/blog/git-worktree-parallel-agents/ "Git worktrees para agentes en paralelo").

Para probar AgentVera, empieza en la [página de inicio](/es/ "AgentVera").

## Preguntas frecuentes

**¿Cómo instalo la extensión de Claude Code en VS Code?** Abre la vista de Extensiones con Cmd+Shift+X o Ctrl+Shift+X, busca Claude Code e instala la extensión publicada por Anthropic (ID anthropic.claude-code). Requiere VS Code 1.94.0 o posterior y un plan Pro, Max, Team o Enterprise, o una cuenta de Console.

**¿La extensión de VS Code incluye el CLI de Claude Code?** Incluye una copia privada del CLI para su panel de chat, pero no añade claude al PATH. Para ejecutar claude en la terminal integrada, instala una vez el CLI independiente. Ambos comparten el mismo historial de conversaciones, así que claude --resume encuentra las sesiones de la extensión.

**¿La extensión de Claude Code funciona en Cursor?** Sí. La documentación de VS Code ofrece un enlace Install for Cursor, y otros forks de VS Code pueden instalarla desde el registro Open VSX. En un editor que no pueda instalar la extensión, ejecuta claude en la terminal integrada.

**¿Por qué no veo el icono Spark de Claude Code?** El icono solo aparece en la barra de herramientas del editor cuando hay un archivo abierto. Comprueba que VS Code sea 1.94.0 o posterior, que el espacio de trabajo sea de confianza y que no haya conflicto con otra extensión de IA, y ejecuta Developer: Reload Window. El elemento Claude Code de la barra de estado funciona sin archivo abierto.

**¿Hay un plugin de Claude Code para los IDE de JetBrains?** Sí. El plugin Claude Code [Beta] del JetBrains Marketplace funciona con IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm y Android Studio. Ejecuta el CLI en la terminal del IDE, así que el CLI debe estar instalado, y añade diffs en el IDE y el envío de la selección.

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito tiene agentes ilimitados. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/