Saltar al contenido principal
Claude Code se integra con JetBrains IDEs a través de un plugin dedicado, proporcionando características como visualización de diff interactiva, intercambio de contexto de selección y más.

​
IDEs Soportados

El plugin de Claude Code funciona con la mayoría de JetBrains IDEs, incluyendo:
  • IntelliJ IDEA
  • PyCharm
  • Android Studio
  • WebStorm
  • PhpStorm
  • GoLand

​
Características

  • Lanzamiento rápido: Usa Cmd+Esc (Mac) o Ctrl+Esc (Windows/Linux) para abrir Claude Code directamente desde tu editor, o haz clic en el botón de Claude Code en la interfaz
  • Visualización de diff: Los cambios de código se pueden mostrar directamente en el visor de diff del IDE en lugar de la terminal
  • Contexto de selección: La selección/pestaña actual en el IDE se comparte automáticamente con Claude Code
  • Atajos de referencia de archivo: Usa Cmd+Option+K (Mac) o Alt+Ctrl+K (Linux/Windows) para insertar referencias de archivo (por ejemplo, @File#L1-99)
  • Intercambio de diagnósticos: Los errores de diagnóstico (lint, sintaxis, etc.) del IDE se comparten automáticamente con Claude mientras trabajas

​
Instalación

​
Instalación desde Marketplace

Encuentra e instala el plugin de Claude Code desde el marketplace de JetBrains y reinicia tu IDE.

​
Instalación Automática

El plugin también puede instalarse automáticamente cuando ejecutas claude en la terminal integrada. El IDE debe reiniciarse completamente para que surta efecto.
Después de instalar el plugin, debes reiniciar tu IDE completamente para que surta efecto. Es posible que necesites reiniciar varias veces.

​
Uso

​
Desde Tu IDE

Ejecuta claude desde la terminal integrada de tu IDE, y todas las características de integración estarán activas.

​
Desde Terminales Externos

Usa el comando /ide en cualquier terminal externo para conectar Claude Code a tu JetBrains IDE y activar todas las características: 
claude
> /ide
Si deseas que Claude tenga acceso a los mismos archivos que tu IDE, inicia Claude Code desde el mismo directorio que la raíz del proyecto de tu IDE.

​
Configuración

​
Configuración de Claude Code

Configura la integración del IDE a través de la configuración de Claude Code:
  1. Ejecuta claude
  2. Ingresa el comando /config
  3. Establece la herramienta de diff en auto para la detección automática del IDE

​
Configuración del Plugin

Configura el plugin de Claude Code yendo a Settings → Tools → Claude Code [Beta]:

​
Configuración General

  • Claude command: Especifica un comando personalizado para ejecutar Claude (por ejemplo, claude, /usr/local/bin/claude, o npx @anthropic/claude)
  • Suppress notification for Claude command not found: Omite notificaciones sobre no encontrar el comando de Claude
  • Enable using Option+Enter for multi-line prompts (solo macOS): Cuando está habilitado, Option+Enter inserta nuevas líneas en los prompts de Claude Code. Deshabilita si experimentas problemas con la tecla Option siendo capturada inesperadamente (requiere reinicio de terminal)
  • Enable automatic updates: Verifica automáticamente e instala actualizaciones del plugin (se aplica al reiniciar)
Para usuarios de WSL: Establece wsl -d Ubuntu -- bash -lic "claude" como tu comando de Claude (reemplaza Ubuntu con el nombre de tu distribución WSL)

​
Configuración de la Tecla ESC

Si la tecla ESC no interrumpe las operaciones de Claude Code en terminales de JetBrains:
  1. Ve a Settings → Tools → Terminal
  2. Cualquiera de:
    • Desmarca “Move focus to the editor with Escape”, o
    • Haz clic en “Configure terminal keybindings” y elimina el atajo “Switch focus to Editor”
  3. Aplica los cambios
Esto permite que la tecla ESC interrumpa correctamente las operaciones de Claude Code.

​
Configuraciones Especiales

​
Desarrollo Remoto

Cuando uses JetBrains Remote Development, debes instalar el plugin en el host remoto a través de Settings → Plugin (Host).
El plugin debe instalarse en el host remoto, no en tu máquina cliente local.

​
Configuración de WSL

Los usuarios de WSL pueden necesitar configuración adicional para que la detección del IDE funcione correctamente. Consulta nuestra guía de solución de problemas de WSL para obtener instrucciones de configuración detalladas.
La configuración de WSL puede requerir:
  • Configuración adecuada de terminal
  • Ajustes del modo de red
  • Actualizaciones de configuración del firewall

​
Solución de Problemas

​
Plugin 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 (es posible que necesites hacerlo varias veces)
  • Para Desarrollo Remoto, asegúrate de que el plugin esté instalado en el host remoto

​
IDE No Detectado

  • Verifica que el plugin esté instalado y habilitado
  • Reinicia el IDE completamente
  • Comprueba que estés ejecutando Claude Code desde la terminal integrada
  • Para usuarios de WSL, consulta la guía de solución de problemas de WSL

​
Comando No Encontrado

Si hacer clic en el icono de Claude muestra “command not found”:
  1. Verifica que Claude Code esté instalado: npm list -g @anthropic-ai/claude-code
  2. Configura la ruta del comando de Claude en la configuración del plugin
  3. Para usuarios de WSL, usa el formato de comando WSL mencionado en la sección de configuración

​
Consideraciones de Seguridad

Cuando Claude Code se ejecuta en un JetBrains IDE 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 de auto-edición y permitir eludir los prompts de permiso de Claude Code para la ejecución de bash. Cuando se ejecuta en JetBrains IDEs, considera:
  • Usar modo de aprobación manual para ediciones
  • Tener cuidado adicional para asegurar que Claude solo se use con prompts de confianza
  • Ser consciente de qué archivos Claude Code tiene acceso para modificar
Para obtener ayuda adicional, consulta nuestra guía de solución de problemas.