> ## Documentation Index
> Fetch the complete documentation index at: https://cli.fuxicode.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# JetBrains IDEs

> Utiliza Fuxi Code con JetBrains IDEs incluyendo IntelliJ, PyCharm, WebStorm y más

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

<h2 id="supported-ides">
  IDEs Compatibles
</h2>

El plugin de Fuxi Code funciona con la mayoría de JetBrains IDEs, incluyendo:

* IntelliJ IDEA
* PyCharm
* Android Studio
* WebStorm
* PhpStorm
* GoLand

<h2 id="features">
  Características
</h2>

* **Lanzamiento rápido**: utiliza `Cmd+Esc` (Mac) o `Ctrl+Esc` (Windows/Linux) para abrir Fuxi Code directamente desde tu editor, o haz clic en el botón de Fuxi 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 actual o pestaña en el IDE se comparte automáticamente con Fuxi Code. Las [reglas de denegación de `Read`](/es/permissions#read-and-edit) bloquean este intercambio para los archivos coincidentes
* **Atajos de referencia de archivos**: utiliza `Cmd+Option+K` (Mac) o `Alt+Ctrl+K` (Linux/Windows) para insertar referencias de archivos como `@src/auth.ts#L1-99`
* **Compartición de diagnósticos**: los errores de diagnóstico del IDE, como errores de lint y sintaxis, se comparten automáticamente con Fuxi mientras trabajas

<h2 id="installation">
  Instalación
</h2>

El plugin ejecuta el comando `fuxi` en la terminal integrada de su IDE y se conecta a él. No incluye su propia copia de la CLI, así que instale ambos componentes:

<Steps>
  <Step title="Instalar Fuxi Code CLI">
    Siga la [guía de inicio rápido](/es/quickstart) para instalar la CLI si aún no lo ha hecho. El plugin muestra una notificación "No se puede iniciar Fuxi Code" cuando `fuxi` no está en su PATH.
  </Step>

  <Step title="Instalar el plugin de JetBrains">
    Instale el [plugin de Fuxi Code](https://plugins.jetbrains.com/plugin/27310-fuxi-code-beta-) desde el Marketplace de JetBrains y reinicie su IDE.
  </Step>
</Steps>

Si `fuxi` está instalado en algún lugar que su IDE no puede encontrar, establezca la ruta completa en la [configuración del comando Fuxi](#general-settings) del plugin.

Fuxi Code funciona con cualquier suscripción de Fuxi de pago (Pro, Max, Team o Enterprise) o una cuenta de Fuxi Console, y no se requiere ninguna clave API. Se le pedirá que [inicie sesión](/es/authentication#log-in-to-fuxi-code) la primera vez que ejecute `fuxi`.

<Note>
  Después de instalar el plugin, es posible que necesite reiniciar completamente su IDE para que surta efecto.
</Note>

<h2 id="usage">
  Uso
</h2>

<h3 id="from-your-ide">
  Desde tu IDE
</h3>

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

<h3 id="from-external-terminals">
  Desde terminales externos
</h3>

Utiliza el comando `/ide` en cualquier terminal externo para conectar Fuxi Code a tu JetBrains IDE y activar todas las características:

```bash theme={null}
fuxi
```

```text theme={null}
/ide
```

Si deseas que Fuxi tenga acceso a los mismos archivos que tu IDE, inicia Fuxi Code desde el mismo directorio que la raíz del proyecto de tu IDE.

<h2 id="configuration">
  Configuración
</h2>

<h3 id="fuxi-code-settings">
  Configuración de Fuxi Code
</h3>

Configura la integración del IDE a través de la configuración de Fuxi Code:

1. Ejecuta `fuxi`
2. Ingresa el comando `/config`
3. Establece la herramienta de diferencias en `auto` para mostrar diferencias en el IDE, o `terminal` para mantenerlas en la terminal

<h3 id="plugin-settings">
  Ajustes de plugins
</h3>

Configura el plugin de Fuxi Code yendo a **Settings → Tools → Fuxi Code \[Beta]**:

<h4 id="general-settings">
  Configuración general
</h4>

* **Comando Fuxi**: especifica un comando personalizado para ejecutar Fuxi, por ejemplo `fuxi`, `/usr/local/bin/fuxi`, o `npx @anthropic-ai/fuxi-code`
* **Suprimir notificación para comando Fuxi no encontrado**: omite notificaciones sobre no encontrar el comando Fuxi
* **Habilitar usar Option+Enter para indicadores de varias líneas**: solo en macOS. Cuando está habilitado, Option+Enter inserta nuevas líneas en los indicadores de Fuxi Code. Desactívalo si la tecla Option se captura inesperadamente. Requiere reinicio de terminal.
* **Habilitar actualizaciones automáticas**: verifica automáticamente e instala actualizaciones del plugin, aplicadas al reiniciar

<Tip>
  Para usuarios de WSL: establece `wsl -d Ubuntu -- bash -lic "fuxi"` como tu comando Fuxi (reemplaza `Ubuntu` con el nombre de tu distribución WSL)
</Tip>

<h4 id="esc-key-configuration">
  Configuración de la tecla ESC
</h4>

Si la tecla ESC no interrumpe las operaciones de Fuxi 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 Fuxi Code.

<h2 id="special-configurations">
  Configuraciones especiales
</h2>

<h3 id="remote-development">
  Desarrollo remoto
</h3>

<Warning>
  Cuando utilices JetBrains Remote Development, debes instalar el plugin en el host remoto a través de **Settings → Plugin (Host)**.
</Warning>

El plugin debe instalarse en el host remoto, no en tu máquina cliente local.

<h3 id="wsl-configuration">
  Configuración de WSL
</h3>

Si estás utilizando Fuxi Code en WSL2 con un JetBrains IDE y ves "No available IDEs detected", la causa generalmente es el enrutamiento NAT de WSL2 o el Firewall de Windows bloqueando la conexión entre WSL2 y el IDE ejecutándose en el host de Windows. WSL1 utiliza la red del host directamente y no se ve afectado.

<h4 id="allow-wsl2-traffic-through-windows-firewall">
  Permitir tráfico de WSL2 a través del Firewall de Windows
</h4>

Esta es la solución recomendada porque mantiene tu modo de red WSL2 existente.

<Steps>
  <Step title="Encuentra tu dirección IP de WSL2">
    Desde dentro de tu shell de WSL, ejecuta:

    ```bash theme={null}
    hostname -I
    ```

    Anota la subred, por ejemplo `172.21.123.45` está en `172.21.0.0/16`.
  </Step>

  <Step title="Crea una regla de firewall">
    Abre PowerShell como Administrador y ejecuta lo siguiente, ajustando el rango de IP para que coincida con tu subred:

    ```powershell theme={null}
    New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16
    ```
  </Step>

  <Step title="Reinicia tu IDE y Fuxi Code">
    Cierra y reabre ambos para que la nueva regla surta efecto.
  </Step>
</Steps>

<h4 id="switch-wsl2-to-mirrored-networking">
  Cambiar WSL2 a redes espejadas
</h4>

Las redes espejadas requieren Windows 11 22H2 o posterior. Si estás en Windows 10, utiliza la regla de firewall anterior.

Añade esto a `.wslconfig` en tu directorio de usuario de Windows:

```ini theme={null}
[wsl2]
networkingMode=mirrored
```

Luego reinicia WSL con `wsl --shutdown` desde PowerShell.

<h2 id="troubleshooting">
  Solución de problemas
</h2>

<h3 id="plugin-not-working">
  Plugin no funciona
</h3>

Si el plugin está instalado pero las características de Fuxi Code no aparecen en tu IDE:

* Asegúrate de que estés ejecutando Fuxi 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

<h3 id="ide-not-detected">
  IDE no detectado
</h3>

Si ejecutar `fuxi` muestra "No available IDEs detected":

* Verifica que el plugin esté instalado y habilitado
* Reinicia completamente el IDE
* Comprueba que estés ejecutando Fuxi Code desde la terminal integrada
* Para usuarios de WSL, consulta la [configuración de WSL](#wsl-configuration) anterior

<h3 id="command-not-found">
  Comando no encontrado
</h3>

Si hacer clic en el icono de Fuxi muestra "command not found":

1. Verifica que Fuxi Code esté instalado ejecutando `fuxi --version` en una terminal
2. Configura la ruta del comando Fuxi en la configuración del plugin
3. Para usuarios de WSL, utiliza el formato de comando WSL mencionado en la sección de configuración

<h2 id="security-considerations">
  Consideraciones de seguridad
</h2>

Cuando Fuxi Code se ejecuta en un JetBrains IDE en modo de permiso [`acceptEdits`](/es/permission-modes#auto-approve-file-edits-with-acceptedits-mode), puede ser capaz de modificar archivos de configuración del IDE que pueden ser ejecutados automáticamente por su IDE. Esto puede aumentar el riesgo de ejecutar Fuxi Code en modo `acceptEdits` y permitir eludir los indicadores de permiso de Fuxi Code para la ejecución de bash.

Cuando se ejecuta en JetBrains IDEs, considere:

* Usar el modo de aprobación manual para ediciones
* Tener especial cuidado para asegurar que Fuxi solo se use con indicadores de confianza
* Ser consciente de qué archivos Fuxi Code tiene acceso para modificar

Para problemas de instalación o inicio de sesión de Fuxi Code fuera del IDE, consulte [Solucionar problemas de instalación e inicio de sesión](/es/troubleshoot-install).