Skip to main content
El plugin de Windsurf JetBrains está en modo de mantenimiento y Cascade se está discontinuando. Las versiones más recientes de los IDE de JetBrains pueden romper el plugin heredado. Si Cascade o el plugin dejaron de funcionar, cambia a Devin mediante ACP: consulta la guía de configuración de ACP para JetBrains.

​
Versiones compatibles

Versión 2022.3 o posterior.
  • JetBrains Fleet o ReSharper no son compatibles
  • Remote SSH no es compatible.

​
Recopilación de registros de la extensión

A partir de la versión 1.10.0 de la extensión, el panel de chat incluye un botón de diagnóstico de la extensión en la página de Settings. Este botón recopila automáticamente los registros y parámetros relevantes en un archivo de texto que se puede descargar. Para versiones anteriores de la extensión:
  1. Los registros se escriben en el archivo idea.log. Para localizar este archivo, ve a la opción de menú Help > Show Log in Finder/Explorer
  2. Exporta o copia los registros

​
Problemas conocidos del IDE y sus soluciones

​
Cascade no aparece

Normalmente, verás el siguiente error en los logs:
o
JCEF es un navegador necesario para mostrar Cascade. Para solucionarlo, ve a Help > Find Actions > Choose Java Boot Runtime y elige un entorno de ejecución que incluya JCEF. Si JCEF ya viene incluido como parte de tu entorno de ejecución, es posible que esté deshabilitado en tu registro o en las propiedades. Edita tus propiedades personalizadas: Help > Edit Custom Properties, agrega la siguiente flag y reinicia tu IDE:

​
Problemas con los certificados

Si aparece alguno de los siguientes errores:
Esto sugiere que la extensión de Codeium no puede confiar en la conexión TLS a tu portal de Enterprise / servidor de API porque no confía en el certificado presentado. Esto puede significar que el certificado presentado por el despliegue de Codeium no es de confianza, o que no es de confianza un certificado presentado por un proxy corporativo que intercepta la solicitud. En cualquiera de los casos, la solución más recomendable es asegurarse de que el certificado raíz que firmó este certificado esté correctamente instalado en las máquinas de los usuarios finales, en la ubicación adecuada. Los IDE de JetBrains y la mayoría de los demás IDE cargan los certificados desde la ubicación predeterminada del sistema operativo. Tu certificado lo emite y gestiona tu equipo local de TI o Admin. Ponte en contacto con ellos para obtener ayuda con la instalación de los certificados necesarios en tu sistema. Es importante que se presente la cadena completa de certificados allí donde se termine TLS. A menudo, si solo se presenta el certificado de servidor, JetBrains IDE y otros IDE no pueden verificar su autenticidad porque no conocen el certificado intermedio que valida el certificado de servidor y que, a su vez, es validado por el certificado raíz. Los navegadores suelen poder sortear este problema, ya que es probable que los usuarios hayan visitado otro sitio web que sí presenta la cadena completa de certificados, por lo que el certificado intermedio se detecta y se almacena en caché, pero aplicaciones como los IDE de JetBrains no tienen esa ventaja. Nota: En los productos de la familia JetBrains 2024.3, se introdujo un bug por el cual el IDE no acepta los certificados del sistema operativo (reporte del issue de JetBrains). Para resolverlo, los usuarios pueden hacer cualquiera de las siguientes acciones:
  • Volver a versiones anteriores de los productos de JB
  • Usar la versión preliminar 2024.3.1 (versión beta)
  • Agregar -Djavax.net.ssl.trustStoreType=Windows-ROOT como una opción personalizada de JVM

​
Espacios de trabajo personalizados

Si ves el siguiente error al usar Cascade:
Esto indica que Cascade necesita acceso a un espacio de trabajo personalizado para funcionar correctamente. Para resolverlo:
  1. Abre Settings de tu IDE de JetBrains desde File > Settings (o IntelliJ IDEA > Preferences en macOS)
  2. Ve a Tools > Windsurf Settings
  3. En el panel de Windsurf Settings, localiza la sección “Custom Workspaces” en la parte inferior
  4. Haz clic en el botón “Add Workspace” para agregar el espacio de trabajo de tu proyecto
  5. Selecciona el directorio del espacio de trabajo correspondiente a tu proyecto
  6. Haz clic en “OK” para aplicar la configuración
  7. Reinicia tu IDE para que los cambios surtan efecto

​
Comportamiento en Enterprise vs. no Enterprise

El comportamiento de los espacios de trabajo personalizados varía según tu tipo de usuario:

​
Usuarios Enterprise

Los usuarios Enterprise tienen control selectivo sobre la indexación de los espacios de trabajo:
  • Al agregar espacios de trabajo, verás una casilla de verificación para habilitar la indexación de cada uno
  • Solo se indexarán los espacios de trabajo con la casilla activada y estarán disponibles para Cascade
  • Esto te permite controlar qué espacios de trabajo consumen recursos de indexación
  • Por seguridad, las invocaciones de herramientas se limitan al espacio de trabajo activo

​
Usuarios que no son Enterprise

Los usuarios que no son Enterprise cuentan con indexación automática del espacio de trabajo:
  • Cualquier espacio de trabajo que agregues se indexa automáticamente sin necesidad de marcar una casilla
  • Todos los espacios de trabajo agregados están disponibles de inmediato para Cascade
  • Las llamadas a herramientas nunca se bloquean fuera del espacio de trabajo activo
  • La función de indexación selectiva no aplica en este modelo
Después de completar los pasos de configuración anteriores, Cascade debería poder acceder a tu espacio de trabajo y funcionar con normalidad.

​
Atajos de teclado que no funcionan en Rider en Windows

Si estás usando JetBrains Rider en Windows y tienes problemas porque Shift+Enter no crea una nueva línea en Cascade o la tecla Delete no funciona, esto se debe a un conflicto de combinaciones de teclas con la ventana de herramientas Unit Test de Rider. Este es un problema conocido que afecta a los complementos de IA en Rider. Para resolverlo:
  1. Abre Settings de tu IDE de JetBrains y ve a File > Settings
  2. Ve a Keymap
  3. Busca “Unit Test Tool Window Action”
  4. Desactiva o reasigna las combinaciones de teclas en conflicto (Shift+Enter y Delete)
  5. Reinicia tu IDE para que los cambios surtan efecto