Visual Studio Code

​

Extensión de VS Code (Beta)

La extensión de VS Code, disponible en beta, te permite ver los cambios de Claude en tiempo real a través de una interfaz gráfica nativa integrada directamente en tu IDE. La extensión de VS Code facilita el acceso e interacción con Claude Code para usuarios que prefieren una interfaz visual sobre la terminal.

​

Características

La extensión de VS Code proporciona:

• Experiencia nativa del IDE: Panel lateral dedicado de Claude Code accesible a través del icono Spark
• Modo de plan con edición: Revisa y edita los planes de Claude antes de aceptarlos
• Modo de aceptación automática de ediciones: Aplica automáticamente los cambios de Claude a medida que se realizan
• Gestión de archivos: Menciona archivos con @ o adjunta archivos e imágenes usando el selector de archivos del sistema
• Uso de servidor MCP: Usa servidores del Protocolo de Contexto de Modelo configurados a través de la CLI
• Historial de conversaciones: Acceso fácil a conversaciones anteriores
• Múltiples sesiones: Ejecuta múltiples sesiones de Claude Code simultáneamente
• Atajos de teclado: Soporte para la mayoría de atajos de la CLI
• Comandos de barra: Accede a la mayoría de comandos de barra de la CLI directamente en la extensión

​

Requisitos

• VS Code 1.98.0 o superior

​

Instalación

Descarga e instala la extensión desde el Marketplace de Extensiones de Visual Studio Code.

​

Cómo funciona

Una vez instalada, puedes comenzar a usar Claude Code a través de la interfaz de VS Code:

1. Haz clic en el icono Spark en la barra lateral de tu editor para abrir el panel de Claude Code
2. Solicita a Claude Code de la misma manera que lo harías en la terminal
3. Observa cómo Claude analiza tu código y sugiere cambios
4. Revisa y acepta ediciones directamente en la interfaz
   • Consejo: Arrastra la barra lateral más ancha para ver diffs en línea, luego haz clic en ellos para expandir y ver todos los detalles

​

Uso de proveedores de terceros (Vertex y Bedrock)

La extensión de VS Code admite el uso de Claude Code con proveedores de terceros como Amazon Bedrock y Google Vertex AI. Cuando se configura con estos proveedores, la extensión no solicitará inicio de sesión. Para usar proveedores de terceros, configura variables de entorno en la configuración de la extensión de VS Code:

1. Abre la configuración de VS Code
2. Busca “Claude Code: Environment Variables”
3. Añade las variables de entorno requeridas

​

Variables de entorno

Para instrucciones de configuración detalladas y opciones de configuración adicionales, consulta:

• Claude Code en Amazon Bedrock
• Claude Code en Google Vertex AI

​

Aún no implementado

Las siguientes características aún no están disponibles en la extensión de VS Code:

• Configuración completa del servidor MCP: Necesitas configurar servidores MCP a través de la CLI primero, luego la extensión los usará
• Configuración de suagentes: Configura suagentes a través de la CLI para usarlos en VS Code
• Puntos de control: Guarda y restaura el estado de la conversación en puntos específicos
• Atajos avanzados:
  • Atajo # para añadir a la memoria
  • Atajo ! para ejecutar comandos bash directamente
• Finalización de pestañas: Finalización de ruta de archivo con tecla de tabulación

Estamos trabajando en añadir estas características en futuras actualizaciones.

​

Consideraciones de seguridad

Cuando Claude Code se ejecuta en VS Code con permisos de edición automática habilitados, puede ser capaz de modificar archivos de configuración del IDE que pueden ser ejecutados automáticamente por tu IDE. Esto puede aumentar el riesgo de ejecutar Claude Code en modo de edición automática y permitir eludir los mensajes de permiso de Claude Code para la ejecución de bash. Cuando se ejecuta en VS Code, considera:

• Habilitar Modo restringido de VS Code para espacios de trabajo no confiables
• Usar modo de aprobación manual para ediciones
• Tener especial cuidado para asegurar que Claude solo se use con solicitudes confiables

​

Integración heredada de CLI

La primera integración de VS Code que lanzamos permite que Claude Code ejecutándose en la terminal interactúe con tu IDE. Proporciona intercambio de contexto de selección (la selección actual/pestaña se comparte automáticamente con Claude Code), visualización de diffs en el IDE en lugar de la terminal, atajos de referencia de archivo (Cmd+Option+K en Mac o Alt+Ctrl+K en Windows/Linux para insertar referencias de archivo como @File#L1-99), y intercambio automático de diagnósticos (errores de lint y sintaxis). La integración heredada se instala automáticamente cuando ejecutas claude desde la terminal integrada de VS Code. Simplemente ejecuta claude desde la terminal y todas las características se activan. Para terminales externas, usa el comando /ide para conectar Claude Code a tu instancia de VS Code. Para configurar, ejecuta claude, ingresa /config, y establece la herramienta de diff en auto para detección automática del IDE. Tanto la extensión como la integración CLI funcionan con Visual Studio Code, Cursor, Windsurf y VSCodium.

​

Solución de problemas

​

La extensión no se instala

• Asegúrate de tener una versión compatible de VS Code (1.85.0 o posterior)
• Verifica que VS Code tenga permiso para instalar extensiones
• Intenta instalar directamente desde el sitio web del marketplace

​

La integración heredada no funciona

• Asegúrate de estar ejecutando Claude Code desde la terminal integrada de VS Code
• Asegúrate de que la CLI para tu variante de IDE esté instalada:
  • VS Code: el comando code debe estar disponible
  • Cursor: el comando cursor debe estar disponible
  • Windsurf: el comando windsurf debe estar disponible
  • VSCodium: el comando codium debe estar disponible
• Si el comando no está instalado:
  1. Abre la paleta de comandos con Cmd+Shift+P (Mac) o Ctrl+Shift+P (Windows/Linux)
  2. Busca “Shell Command: Install ‘code’ command in PATH” (o equivalente para tu IDE)

Para obtener ayuda adicional, consulta nuestra guía de solución de problemas.