Agregar Claude Code a tu IDE
Aprende cómo agregar Claude Code a tu IDE favorito
Claude Code se integra perfectamente con los Entornos de Desarrollo Integrados (IDEs) populares para mejorar tu flujo de trabajo de codificación. Esta integración te permite aprovechar las capacidades de Claude directamente dentro de tu entorno de desarrollo preferido.
IDEs Compatibles
Claude Code actualmente soporta dos familias principales de IDE:
- Visual Studio Code (incluyendo forks populares como Cursor y Windsurf)
- IDEs de JetBrains (incluyendo PyCharm, WebStorm, IntelliJ y GoLand)
Características
- Lanzamiento rápido: Usa
Cmd+Esc
(Mac) oCtrl+Esc
(Windows/Linux) para abrir Claude Code directamente desde tu editor, o haz clic en el botón de Claude Code en la interfaz de usuario - Visualización de diferencias: Los cambios de código pueden mostrarse directamente en el visor de diferencias del IDE en lugar de en la terminal. Puedes configurar esto en
/config
- Contexto de selección: La selección/pestaña actual en el IDE se comparte automáticamente con Claude Code
- Atajos de referencia de archivos: Usa
Cmd+Option+K
(Mac) oAlt+Ctrl+K
(Linux/Windows) para insertar referencias de archivos (ej., @File#L1-99) - Compartir diagnósticos: Los errores de diagnóstico (lint, sintaxis, etc.) del IDE se comparten automáticamente con Claude mientras trabajas
Instalación
VS Code
- Abre VSCode
- Abre la terminal integrada
- Ejecuta
claude
- la extensión se instalará automáticamente
En adelante también puedes usar el comando /ide
en cualquier terminal externa para conectarte al IDE.
Estas instrucciones de instalación también se aplican a forks de VS Code como Cursor y Windsurf.
IDEs de JetBrains
Instala el plugin de Claude Code desde el marketplace y reinicia tu IDE.
El plugin también puede instalarse automáticamente cuando ejecutes claude
en la terminal integrada. El IDE debe reiniciarse completamente para que surta efecto.
Limitaciones del Desarrollo Remoto: Cuando uses JetBrains Remote Development, debes instalar el plugin en el host remoto a través de Settings > Plugin (Host)
.
Configuración
Ambas integraciones funcionan con el sistema de configuración de Claude Code. Para habilitar características específicas del IDE:
- Conecta Claude Code a tu IDE ejecutando
claude
en la terminal integrada - Ejecuta el comando
/config
- Establece la herramienta de diferencias en
auto
para detección automática del IDE - Claude Code usará automáticamente el visor apropiado basado en tu IDE
Si estás usando una terminal externa (no la terminal integrada del IDE), aún puedes conectarte a tu IDE usando el comando /ide
después de lanzar Claude Code. Esto te permite beneficiarte de las características de integración del IDE incluso cuando ejecutes Claude desde una aplicación de terminal separada. Esto funciona tanto para VS Code como para IDEs de JetBrains.
Cuando uses una terminal externa, para asegurar que Claude tenga acceso predeterminado a los mismos archivos que tu IDE, inicia Claude desde el mismo directorio que la raíz del proyecto de tu IDE.
Solución de Problemas
La extensión de VS Code no se instala
- Asegúrate de estar ejecutando Claude Code desde la terminal integrada de VS Code
- Asegúrate de que el CLI correspondiente a tu IDE esté instalado:
- Para VS Code: el comando
code
debe estar disponible - Para Cursor: el comando
cursor
debe estar disponible - Para Windsurf: el comando
windsurf
debe estar disponible - Si no está instalado, usa
Cmd+Shift+P
(Mac) oCtrl+Shift+P
(Windows/Linux) y busca “Shell Command: Install ‘code’ command in PATH” (o el equivalente para tu IDE)
- Para VS Code: el comando
- Verifica que VS Code tenga permisos para instalar extensiones
El plugin de JetBrains no funciona
- Asegúrate de estar ejecutando Claude Code desde el directorio raíz del proyecto
- Verifica que el plugin de JetBrains esté habilitado en la configuración del IDE
- Reinicia completamente el IDE. Puede que necesites hacer esto múltiples veces
- Para JetBrains Remote Development, asegúrate de que el plugin de Claude Code esté instalado en el host remoto y no localmente en el cliente
Para ayuda adicional, consulta nuestra guía de solución de problemas o contacta al soporte.