Extensión para VS Code y Cursor

Claude Code en el IDE

Claude Code es un agente que opera desde la terminal. Sin embargo, Anthropic ofrece también una extensión oficial que integra Claude Code directamente en editores basados en VS Code. Esta extensión funciona tanto en VS Code como en Cursor, ya que Cursor está construido sobre la misma base tecnológica.

La extensión no sustituye al CLI, sino que proporciona una interfaz gráfica alternativa para interactuar con el mismo agente. Internamente, utiliza el mismo motor, las mismas herramientas y las mismas capacidades que el CLI. La diferencia radica en la forma de interactuar: en lugar de escribir en la terminal, se trabaja desde un panel visual dentro del propio editor.

La extensión de Claude Code para VS Code y Cursor es una interfaz gráfica sobre el mismo agente que se usa desde la terminal. Comparte configuración, historial de sesiones y capacidades.

Algunas ventajas de utilizar la extensión en el IDE:

• Diffs visuales: las propuestas de cambio se muestran en una comparativa lado a lado, con botones para aceptar o rechazar cada modificación.
• Referencias con @-mentions: se pueden mencionar archivos y carpetas directamente en el prompt con @nombre-archivo, e insertar automáticamente la selección activa del editor.
• Conversaciones en pestañas: es posible abrir varias conversaciones simultáneas en pestañas independientes, cada una con su propio contexto e historial.
• Selección de texto automática: Claude detecta el texto seleccionado en el editor y lo incorpora como contexto del prompt sin necesidad de copiarlo.

Instalar la extensión

En VS Code

La instalación en VS Code se realiza desde el Marketplace de extensiones integrado en el editor:

• 1. Abrir el panel de extensiones: pulsar Ctrl+Shift+X en Windows/Linux o Cmd+Shift+X en macOS.
• 2. Buscar "Claude Code": en el campo de búsqueda, escribir "Claude Code". La extensión oficial es la publicada por Anthropic.
• 3. Instalar: hacer clic en el botón Install.

Si la extensión no aparece tras la instalación, reiniciar VS Code o ejecutar "Developer: Reload Window" desde la paleta de comandos (Ctrl+Shift+P / Cmd+Shift+P).

Requisito: VS Code 1.98.0 o superior. Se puede comprobar la versión desde Help > About.

En Cursor

Cursor está construido sobre VS Code, por lo que la extensión de Claude Code es compatible de forma nativa. El proceso de instalación es el mismo que en VS Code:

Abrir el panel de extensiones (Ctrl+Shift+X / Cmd+Shift+X), buscar "Claude Code" e instalar la extensión publicada por Anthropic.

Si la extensión no aparece en el Marketplace de Cursor o la instalación falla, se puede recurrir a una instalación manual mediante archivo VSIX. Para ello, abrir la paleta de comandos (Ctrl+Shift+P / Cmd+Shift+P), escribir "Extensions: Install from VSIX" y seleccionar el archivo .vsix de la extensión. Este archivo se puede obtener de dos formas:

• Desde la instalación local del CLI: si Claude Code ya está instalado en el sistema, el archivo VSIX se encuentra en ~/.claude/local/node_modules/@anthropic-ai/claude-code/vendor/claude-code.vsix (en Windows, dentro de %USERPROFILE%\.claude\local\...).
• Desde Open VSX: la extensión oficial de Anthropic está publicada en Open VSX Registry, desde donde se puede descargar el archivo .vsix directamente.

Tras instalar desde VSIX, es necesario reiniciar Cursor completamente para que la extensión se active.

Abrir y usar la extensión

Una vez instalada, la extensión se integra en la interfaz del IDE mediante un icono de chispa (Spark) que aparece en varias ubicaciones:

• Barra de herramientas del editor (esquina superior derecha): visible cuando hay un archivo abierto. Es la forma más rápida de abrir el panel de Claude Code.
• Barra de estado (esquina inferior derecha): muestra "Claude Code" y funciona incluso sin archivos abiertos.
• Paleta de comandos: con Ctrl+Shift+P / Cmd+Shift+P, escribir "Claude Code" para ver todas las opciones disponibles.

El atajo de teclado principal es Ctrl+Esc en Windows/Linux o Cmd+Esc en macOS, que alterna el foco entre el editor y el panel de Claude.

flowchart LR
    A["Abrir extensión"] --> B["Panel de chat"]
    B --> C["Escribir prompt"]
    C --> D["Claude propone cambios"]
    D --> E{"Aceptar o rechazar"}
    E -->|Aceptar| F["Cambios aplicados"]
    E -->|Rechazar| C

El panel de chat

El panel de chat es la interfaz principal de la extensión. Funciona de forma conversacional, igual que el CLI, pero con elementos gráficos adicionales:

• Campo de entrada multilinea: Shift+Enter para añadir líneas sin enviar el mensaje.
• Indicador de contexto: muestra cuánto de la ventana de contexto se está utilizando.
• Menú de comandos: escribir / para acceder a opciones como cambiar de modelo, activar extended thinking o gestionar plugins.
• Modos de permisos: en la parte inferior del campo de entrada se puede alternar entre modo normal (pide permiso antes de cada acción), modo plan (describe lo que hará antes de ejecutar) y modo auto-accept (aplica cambios sin preguntar).

Insertar referencias a archivos

Una de las funcionalidades más útiles de la extensión es la capacidad de referenciar archivos y selecciones directamente en el prompt:

• Escribir @ seguido del nombre de un archivo para que Claude lo lea como contexto.
• Seleccionar texto en el editor y pulsar Alt+K (Windows/Linux) u Option+K (macOS) para insertar una referencia con el archivo y las líneas exactas, por ejemplo @app.ts#5-10.
• Arrastrar archivos al campo de entrada manteniendo Shift pulsado para adjuntarlos.

CLI y extensión: uso complementario

La extensión y el CLI comparten la misma configuración y el mismo historial de sesiones. Una conversación iniciada en la extensión se puede continuar desde el CLI con claude --resume, y viceversa. Los archivos CLAUDE.md, las skills, los hooks y los servidores MCP configurados desde el CLI están disponibles automáticamente en la extensión.

| Aspecto | CLI (terminal) | Extensión (IDE) | |---|---|---| | Interfaz | Texto en terminal | Panel gráfico en el editor | | Diffs de código | Texto plano | Vista lado a lado con botones | | Configuración MCP | Configura y usa | Solo usa (configurar desde CLI) | | Múltiples sesiones | Varias terminales | Pestañas en el editor | | Checkpoints y rewind | Disponible | Disponible | | Atajos Bash (!) | Disponible | No disponible | | Tab completion | Disponible | No disponible |

Algunas funcionalidades avanzadas, como la configuración de servidores MCP o los atajos de Bash, solo están disponibles en el CLI. Por eso, la recomendación general es usar la extensión como complemento del CLI, no como sustituto. El CLI sigue siendo la interfaz con mayor control y flexibilidad.

Si se necesita acceder a funcionalidades exclusivas del CLI desde el IDE, basta con abrir la terminal integrada del editor (Ctrl+ñ en Windows/Linux o Cmd+ñ en macOS) y ejecutar claude directamente. El CLI detecta automáticamente el IDE y se integra con él para mostrar diffs y compartir diagnósticos.

Este curso se centra en el CLI como interfaz principal de trabajo con Claude Code. La extensión es una alternativa gráfica que facilita la adopción inicial y resulta cómoda para tareas puntuales, pero el dominio del CLI proporciona un mayor control sobre el agente y acceso completo a todas sus capacidades.