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

​
IDEs Compatibles

El complemento 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 Claude Code en la interfaz
  • Visualización de diferencias: Los cambios de código se pueden mostrar 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 archivo: Usa Cmd+Option+K (Mac) o Alt+Ctrl+K (Linux/Windows) para insertar referencias de archivo (por ejemplo, @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 complemento Claude Code desde el marketplace de JetBrains y reinicia tu IDE. Si aún no has instalado Claude Code, consulta nuestra guía de inicio rápido para obtener instrucciones de instalación.
Después de instalar el complemento, es posible que necesites reiniciar completamente tu IDE para que surta efecto.

​
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 diferencias en auto para la detección automática del IDE

​
Configuración del Complemento

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

​
Configuración General

  • Comando Claude: Especifica un comando personalizado para ejecutar Claude (por ejemplo, claude, /usr/local/bin/claude, o npx @anthropic/claude)
  • Suprimir notificación para comando Claude no encontrado: Omite notificaciones sobre no encontrar el comando Claude
  • Habilitar usar Option+Enter para indicaciones multilínea (solo macOS): Cuando está habilitado, Option+Enter inserta nuevas líneas en las indicaciones de Claude Code. Desactívalo 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 complemento (se aplica al reiniciar)
Para usuarios de WSL: Establece wsl -d Ubuntu -- bash -lic "claude" como tu comando 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:
    • Desactiva “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 complemento en el host remoto a través de Settings → Plugin (Host).
El complemento 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 la terminal
  • Ajustes del modo de red
  • Actualizaciones de configuración del firewall

​
Solución de Problemas

​
El Complemento No Funciona

  • Asegúrate de estar ejecutando Claude Code desde el directorio raíz del proyecto
  • Verifica que el complemento 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 complemento esté instalado en el host remoto

​
IDE No Detectado

  • Verifica que el complemento 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 Claude en la configuración del complemento
  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 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 avisos de permisos de Claude Code para la ejecución de bash. Al ejecutar en JetBrains IDEs, considera:
  • Usar el modo de aprobación manual para ediciones
  • Tener especial cuidado para asegurar que Claude solo se use con indicaciones 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.