​
Versiones compatibles

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

​
Recolección de logs 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 Configuración. Este botón recopila automáticamente los logs y parámetros relevantes en un archivo de texto que se puede descargar. Para versiones anteriores de la extensión:
  1. Los logs 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 logs.

​
Cómo restablecer o cambiar la URL de tu Enterprise

  1. Ve a Tools → Codeium Enterprise → Reset Codeium Enterprise Updater.
  2. Introduce la nueva URL y asegúrate de que no tenga espacios en blanco al principio ni al final.
  3. Reinicia tu IDE.
  4. Tras reiniciar, se te solicitará iniciar sesión.

​
Problemas conocidos del IDE y sus soluciones

​
Cascade no funciona (o el plugin de Windsurf no funciona en absoluto)

Si el plugin de Windsurf para JetBrains no funciona, un buen primer paso es intentar restablecerlo yendo a Help > Find Action > Reset Windsurf Enterprise Updater. Si el problema afecta solo a algunos usuarios, es probable que se deba a que el certificado del Enterprise Domain URL no está cargado en tu IDE. El administrador de tu equipo debería saber cómo hacerlo.

​
Cascade no se muestra

Por lo general, verás el siguiente error en los logs: 
JCEF no es compatible con este entorno o no se pudo inicializar
o 
JCEF interno no compatible, probando JCEF externo
JCEF es el componente de navegador necesario para mostrar Cascade. Para solucionarlo, ve a Help > Find Actions > Choose Java Boot Runtime y elige un runtime con JCEF incluido. Si ya tienes JCEF incluido como parte de tu runtime, es posible que JCEF esté deshabilitado en tu registro/propiedades. Edita tus propiedades: Help > Edit Custom Properties, agrega la siguiente marca y reinicia tu IDE: 
ide.browser.jcef.enabled=true

​
Problemas de certificados

Si te encuentras con los siguientes errores: 
Error al obtener la URL base de la extensión en <YourDomainURL>

Falló la construcción de ruta PKIX: sun.security.provider.certpath.SunCertPathBuilderException: 
no se puede encontrar una ruta de certificación válida hacia el destino solicitado
Esto sugiere que la extensión de Codeium no puede confiar en la conexión TLS con su portal empresarial o servidor de API porque no confía en el certificado presentado. Esto significa que el certificado presentado por la implementación de Codeium no es de confianza, o que no lo es el certificado presentado por un proxy corporativo que intercepta la solicitud. En cualquier caso, 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. Su certificado es emitido y administrado por su equipo local de TI o de Administración. Comuníquese con ellos para obtener ayuda con la instalación de los certificados necesarios en su sistema. Es importante que se presente la cadena completa de certificados desde el punto en el que se termina TLS. A menudo, si solo se presenta el certificado de entidad final (leaf), JetBrains IDE y otros IDE no pueden verificar su autenticidad porque no conocen el certificado intermedio que valida el certificado de entidad final y que a su vez está 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; así, el certificado intermedio se ve y se almacena en caché, pero aplicaciones como los IDE de JetBrains no tienen esta ventaja. Nota: En los productos de la familia JetBrains 2024.3 se introdujo un error por el que el IDE no acepta los certificados del sistema operativo (informe de incidencia de JetBrains). Para solucionarlo, los usuarios pueden hacer cualquiera de lo siguiente:
  • Revertir los productos de JetBrains a versiones anteriores
  • Usar la versión preliminar 2024.3.1 (versión beta)
  • Agregar -Djavax.net.ssl.trustStoreType=Windows-ROOT como opción personalizada de la JVM

​
Workspaces personalizados

Si ves el siguiente error al usar Cascade: 
Cascade no puede acceder a rutas sin un workspace activo
Esto indica que Cascade necesita acceso a un workspace personalizado para funcionar correctamente. Para resolverlo:
  1. Abre la configuración de tu IDE de JetBrains yendo a File > Settings (o IntelliJ IDEA > Preferences en macOS)
  2. Ve a Tools > Windsurf Settings
  3. En el panel de Windsurf Settings, ubica la sección “Custom Workspaces” en la parte inferior
  4. Haz clic en el botón “Add Workspace” para agregar el workspace de tu proyecto
  5. Selecciona el directorio de workspace 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 workspaces personalizados varía según tu tipo de usuario:

​
Usuarios de Enterprise

Los usuarios de Enterprise tienen control selectivo sobre la indexación del workspace:
  • Al agregar workspaces, verás una casilla para habilitar la indexación de cada workspace
  • Solo los workspaces con la casilla habilitada se indexarán y estarán disponibles para Cascade
  • Esto te permite controlar qué workspaces consumen recursos de indexación
  • Por seguridad, las llamadas a herramientas están restringidas al workspace activo

​
Usuarios no Enterprise

Los usuarios no Enterprise obtienen indexación automática del workspace:
  • Cualquier workspace que añadas se indexa automáticamente sin requerir marcar ninguna casilla
  • Todos los workspaces añadidos están disponibles de inmediato para Cascade
  • Las llamadas a herramientas nunca se bloquean fuera del workspace activo
  • La función de indexación selectiva no es relevante en este modelo
Después de completar los pasos de configuración anteriores, Cascade debería poder acceder a tu workspace y funcionar con normalidad.