Claude Code se integra con IDEs de JetBrains a través de un plugin dedicado, proporcionando características como visualización interactiva de diferencias, compartición de contexto de selección, y más.

IDEs Compatibles

El plugin de Claude Code funciona con la mayoría de IDEs de JetBrains, 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 diferencias: Los cambios de código pueden mostrarse directamente en el visor de diferencias 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 archivos: Usa Cmd+Option+K (Mac) o Alt+Ctrl+K (Linux/Windows) para insertar referencias de archivos (ej., @File#L1-99)
  • Compartición 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.

Auto-Instalación

El plugin también puede auto-instalarse cuando ejecutas claude en la terminal integrada. El IDE debe reiniciarse completamente para que tome efecto.
Después de instalar el plugin, debes reiniciar tu IDE completamente para que tome efecto. Puede que necesites reiniciar múltiples 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 Externas

Usa el comando /ide en cualquier terminal externa para conectar Claude Code a tu IDE de JetBrains y activar todas las características:
claude
> /ide
Si quieres 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 diferencias en auto para 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

  • Comando de Claude: Especifica un comando personalizado para ejecutar Claude (ej., claude, /usr/local/bin/claude, o npx @anthropic/claude)
  • Suprimir notificación para comando de Claude no encontrado: Omite notificaciones sobre no encontrar el comando de Claude
  • Habilitar usar Option+Enter para prompts multilínea (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)
  • Habilitar actualizaciones automáticas: Verifica automáticamente e instala actualizaciones del plugin (aplicadas 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 Tecla ESC

Si la tecla ESC no interrumpe las operaciones de Claude Code en terminales de JetBrains:
  1. Ve a Settings → Tools → Terminal
  2. O bien:
    • 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 apropiadamente las operaciones de Claude Code.

Configuraciones Especiales

Desarrollo Remoto

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

Configuración WSL

Los usuarios de WSL pueden necesitar configuración adicional para que la detección del IDE funcione apropiadamente. Ve nuestra guía de solución de problemas de WSL para instrucciones detalladas de configuración.
La configuración de WSL puede requerir:
  • Configuración apropiada de terminal
  • Ajustes de modo de red
  • Actualizaciones de configuración de 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 (puede que necesites hacer esto múltiples 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
  • Verifica que estés ejecutando Claude Code desde la terminal integrada
  • Para usuarios de WSL, ve la guía de solución de problemas de WSL

Comando No Encontrado

Si hacer clic en el ícono 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 IDE de JetBrains 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 los prompts de permisos de Claude Code para ejecución de bash. Cuando se ejecute en IDEs de JetBrains, considera:
  • Usar modo de aprobación manual para ediciones
  • Tener cuidado extra para asegurar que Claude solo se use con prompts confiables
  • Estar consciente de qué archivos Claude Code tiene acceso para modificar
Para ayuda adicional, ve nuestra guía de solución de problemas.