​
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 accedido a través del icono Spark
  • Modo de planificación con edición: Revisa y edita los planes de Claude antes de aceptarlos
  • Modo de auto-aceptar ediciones: Aplica automáticamente los cambios de Claude mientras 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 del CLI
  • Historial de conversaciones: Fácil acceso a conversaciones pasadas
  • Múltiples sesiones: Ejecuta múltiples sesiones de Claude Code simultáneamente
  • Atajos de teclado: Soporte para la mayoría de atajos del CLI
  • Comandos slash: Accede a la mayoría de comandos slash del 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.

​
Actualización

Para actualizar la extensión de VS Code:
  1. Abre la paleta de comandos de VS Code con Cmd+Shift+P (Mac) o Ctrl+Shift+P (Windows/Linux)
  2. Busca “Claude Code: Update”
  3. Selecciona el comando para actualizar a la última versión

​
Cómo Funciona

Una vez instalado, 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 mientras 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 diferencias en línea, luego haz clic en ellas para expandir y ver detalles completos

​
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 del CLI primero, luego la extensión los usará
  • Configuración de subagentes: Configura subagentes a través del CLI para usarlos en VS Code
  • Puntos de control: Guarda y restaura el estado de conversación en puntos específicos
  • Atajos avanzados:
    • Atajo # para agregar a la memoria
    • Atajo ! para ejecutar comandos bash directamente
  • Completado con tab: Completado de rutas de archivos con la tecla tab
Estamos trabajando en agregar estas características en futuras actualizaciones.

​
Consideraciones de Seguridad

Cuando Claude Code se ejecuta en VS Code con permisos de auto-edición 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 auto-edición y permitir eludir las solicitudes de permisos de Claude Code para la ejecución de bash. Al ejecutar en VS Code, considera:
  • Habilitar el Modo Restringido de VS Code para espacios de trabajo no confiables
  • Usar modo de aprobación manual para ediciones
  • Tener cuidado extra para asegurar que Claude solo se use con solicitudes confiables

​
Integración CLI Heredada

La primera integración de VS Code que lanzamos permite que Claude Code ejecutándose en la terminal interactúe con tu IDE. Proporciona compartir contexto de selección (la selección/pestaña actual se comparte automáticamente con Claude Code), visualización de diferencias en el IDE en lugar de la terminal, atajos de referencia de archivos (Cmd+Option+K en Mac o Alt+Ctrl+K en Windows/Linux para insertar referencias de archivos como @File#L1-99), y compartir diagnósticos automáticos (errores de lint y sintaxis). La integración heredada se auto-instala 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 diferencias a 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 permisos 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 el CLI para tu variante de IDE esté instalado:
    • VS Code: el comando code debería estar disponible
    • Cursor: el comando cursor debería estar disponible
    • Windsurf: el comando windsurf debería estar disponible
    • VSCodium: el comando codium debería 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 ayuda adicional, consulta nuestra guía de solución de problemas.