Cómo habilitar y configurar JetBrains AI Assistant en IDEs compatibles

JetBrains AI Assistant integra capacidades de codificación mediante IA generativa, agentes autónomos de múltiples pasos e inteligencia de código semántica profunda directamente en los entornos de desarrollo de JetBrains, incluidos IntelliJ IDEA, PyCharm, WebStorm, GoLand, CLion, Rider, PhpStorm, RubyMine, RustRover, DataGrip y DataSpell. En lugar de funcionar como una interfaz de chat aislada o un predictor de texto genérico, el asistente se conecta al índice de proyecto interno del IDE, a los árboles de sintaxis abstracta (AST) y a los sistemas de control de versiones para proporcionar generación de código con reconocimiento de contexto, autocompletados multilínea, sugerencias para la siguiente edición (Next Edit Suggestions), creación automatizada de pruebas y refactorización estructural. Implementar y configurar con éxito JetBrains AI Assistant requiere que los desarrolladores de software y líderes de ingeniería verifiquen los requisitos previos de versión del IDE, completen la instalación y la activación de licencias en planes individuales o empresariales, ajusten los parámetros de autocompletado en el editor, establezcan reglas de proyecto a nivel de repositorio y configuren límites de seguridad en torno a los proveedores de modelos y a las herramientas externas de Model Context Protocol (MCP).

Compatibilidad del IDE y requisitos previos de versión

Antes de habilitar JetBrains AI Assistant, los desarrolladores deben asegurarse de que su entorno local cumpla con criterios específicos de tiempo de ejecución, plataforma y directrices organizacionales.

Entornos compatibles y versiones base del IDE

JetBrains AI Assistant se distribuye como un plugin disponible en toda la suite de productos JetBrains. Los IDE compatibles requieren versiones base específicas:

• IDEs comerciales de JetBrains: Compatible con la versión 2023.3 o posterior en todos los IDE comerciales, incluidos IntelliJ IDEA Ultimate, PyCharm Professional, WebStorm, CLion, GoLand, Rider, PhpStorm, RubyMine, RustRover, DataGrip y DataSpell.
• IDEs Community Edition: Requiere la versión 2024.1.1 o posterior para las ediciones Community de código abierto (como IntelliJ IDEA Community Edition o PyCharm Community Edition). Para vincular una suscripción organizativa de JetBrains AI dentro de las ediciones Community, los equipos deben ejecutar la versión 2024.2.1 o más reciente.
• Soporte multiplataforma: Compatible con estaciones de trabajo de 64 bits en Windows, macOS (Intel y Apple Silicon) y Linux que cumplan con los requisitos estándar del sistema del IDE host.

Topologías de cómputo: LLMs en la nube frente a hardware local

De forma predeterminada, JetBrains AI Assistant ejecuta las inferencias a través de modelos de lenguaje grandes alojados en la nube y gestionados por el servicio JetBrains AI o por proveedores de API externos. En esta configuración, las estaciones de trabajo de los desarrolladores experimentan un impacto insignificante en el uso de CPU, GPU o batería.

Sin embargo, los equipos que utilicen modelos de pesos abiertos autohospedados (como Ollama o extremos de inferencia privados compatibles con OpenAI) deben asignar recursos de cómputo dedicados en la estación de trabajo, incluyendo suficiente VRAM dedicada (por lo general de 8 GB a 24 GB, según la cuantización de los parámetros) para permitir el streaming de tokens en tiempo real.

Requisitos previos de la organización

Para los desarrolladores que utilizan licencias de IDE proporcionadas por un empleador o institución educativa, el acceso a las funciones de IA se administra a nivel de la organización:

1. Un administrador de la organización debe habilitar el servicio JetBrains AI dentro de la consola de administración corporativa de JetBrains Account.
2. Si la organización aplica directivas estrictas de seguridad o gobernanza de propiedad intelectual, los administradores pueden asignar fondos comunes de créditos compartidos o designar proveedores externos aprobados antes de que los desarrolladores puedan iniciar la activación.

Instalación y activación de JetBrains AI Assistant

El plugin JetBrains AI Assistant no está habilitado de forma predeterminada en instalaciones personales y no accederá al código fuente propietario hasta que se instale y active de manera explícita.

Métodos de instalación

Los desarrolladores pueden instalar el plugin a través de tres puntos de entrada principales en los IDE compatibles:

1. JetBrains Marketplace (Settings):
   • Navegue a Settings (en Windows/Linux) o Preferences (en macOS) mediante Ctrl+Alt+S o Cmd+,.
   • Seleccione Plugins en la barra lateral izquierda y elija la pestaña Marketplace.
   • Busque AI Assistant en el campo de búsqueda.
   • Haga clic en Install en la entrada oficial del plugin de JetBrains y reinicie el IDE si se le solicita.
2. Ventana de herramientas AI Chat:
   • Haga clic en el icono de AI Chat en el panel lateral de ventanas de herramientas a la derecha.
   • Haga clic en el botón Install Plugin que se muestra en la ventana de herramientas vacía para iniciar la instalación en segundo plano.
3. Widget de encabezado de ventana JetBrains AI:
   • En el encabezado de la interfaz moderna del IDE, localice el widget de estado JetBrains AI.
   • Haga clic en Let's Go para descargar e inicializar el plugin automáticamente.

Niveles de licencia y escenarios de activación

Una vez instalado, los desarrolladores deben activar el plugin utilizando un modelo de licencia adecuado. JetBrains admite múltiples vías de autenticación bajo distintos escenarios de activación:

Desglose de los niveles de licencia

• AI Free: Proporciona acceso básico a modelos ligeros en la nube con créditos de IA mensuales limitados; se concede automáticamente a usuarios con suscripciones caducadas o del plan gratuito.
• AI Pro: La suscripción individual estándar que ofrece amplias cuotas mensuales, enrutamiento prioritario de modelos y soporte para LLMs de frontera (incluidos GPT-4o, Claude 3.5 Sonnet y Gemini 1.5 Pro). Los titulares de JetBrains All Products Pack o dotUltimate suelen recibir privilegios de AI Pro.
• Pro Trial: Licencia de evaluación con todas las funciones durante 30 días, vinculada automáticamente a nuevas cuentas JetBrains Account tras la primera activación.
• AI Business / Enterprise: Escalada para equipos con facturación centralizada, controles de asignación de usuarios, fondos comunes de créditos compartidos y opciones de despliegues híbridos locales mediante JetBrains AI Enterprise.

Consentimiento legal y aceptación de términos

Durante el protocolo inicial de activación, los desarrolladores deben revisar y aceptar los Términos de servicio de JetBrains AI y la Política de uso aceptable. Estos términos establecen formalmente que el código fuente transmitido para inferencia se procesa de forma efímera y no se retiene para entrenar modelos fundacionales públicos base.

Configuración básica del IDE y ajustes de comportamiento

Las opciones de configuración global del plugin están centralizadas en Settings | Tools | AI Assistant (o Preferences | Tools | AI Assistant en macOS). Consultar la referencia de configuración permite a los desarrolladores alinear la herramienta con sus hábitos de programación.

Settings / Preferences
  ├── Tools
  │     └── AI Assistant
  │           ├── General Features (Name suggestions, pasted code, PR summaries)
  │           ├── Providers & API keys (BYOK, OAuth, Model selection)
  │           ├── Rules (Project-specific instructions)
  │           ├── Prompt Library (Custom prompt templates)
  │           ├── Skills (Debugger and runtime tools)
  │           └── Agents (ACP agent registries)
  └── Editor
        └── General
              └── Code Completion
                    └── Inline (Cloud completion, Next Edit Suggestions)

Opciones de automatización

Los desarrolladores pueden activar o desactivar ayudas de comportamiento específicas para evitar sugerencias intrusivas:

• Provide AI-generated name suggestions: Sugiere identificadores de variables, funciones y clases contextualmente significativos durante la refactorización de símbolos in situ (Shift+F6).
• Suggest converting pasted code to target file language: Detecta automáticamente cuando se inserta en el editor código en un lenguaje distinto (como un fragmento de Python pegado en un archivo Java) y sugiere traducir la sintaxis al lenguaje del archivo de destino.
• Generate a title for the shelved changelist: Sintetiza automáticamente títulos descriptivos concisos para conjuntos de cambios de Git pospuestos (shelved) basándose en la inspección de diferencias.
• GitHub Plugin: Generate PR summaries: Inspecciona commits y archivos modificados para generar descripciones estructuradas de pull requests al crear o revisar PRs mediante la ventana de herramientas integrada de GitHub.

Personalización del lenguaje natural

De forma predeterminada, AI Assistant responde en el idioma regional del sistema o en inglés. Los equipos que trabajan en entornos multilingües pueden especificar un idioma natural preferido en Settings | Tools | AI Assistant | Natural Language para asegurar que las explicaciones, docstrings y mensajes de commit se redacten en el idioma de trabajo requerido.

Umbral de recorte de mensajes (Message Trimming Threshold)

Al trabajar con bases de código extensas, adjuntar múltiples archivos fuente puede sobrepasar rápidamente ventanas de contexto amplias. En Settings | Tools | AI Assistant, los desarrolladores pueden configurar el Message Trimming Threshold (expresado como porcentaje de la ventana de contexto total del modelo). Si una carga útil adjunta excede este umbral, AI Assistant recorta automáticamente estructuras externas no críticas mientras preserva firmas de funciones y puntos de llamada relevantes, evitando excepciones por desbordamiento de tokens de contexto.

Configuración del autocompletado en el editor y de Next Edit Suggestions

Los IDEs de JetBrains implementan una arquitectura de doble motor para el autocompletado de código: autocompletado local en el dispositivo y autocompletado remoto en la nube.

Autocompletado local Full Line frente a multilínea en la nube

Comprender la distinción entre los mecanismos de autocompletado es esencial para una configuración óptima:

1. Full Line Code Completion: Se ejecuta íntegramente de manera local en la estación de trabajo del desarrollador mediante modelos de redes neuronales compactos y específicos para cada lenguaje integrados directamente en el IDE. Funciona sin conexión, con latencia de red cero, no consume créditos de IA ni envía código fuera de la máquina.
2. Cloud Code Completion: Impulsado por los LLMs en la nube de AI Assistant. Genera estructuras de código multilínea, cuerpos enteros de métodos, lógica algorítmica y comentarios de documentación complementarios basándose en un contexto de archivo más amplio.

Configuración de parámetros de autocompletado en línea

Para ajustar el autocompletado en línea, navegue a Settings | Editor | General | Code Completion | Inline:

• Enable Cloud-Based Multi-Line Completions: Marque esta opción para permitir que AI Assistant muestre texto fantasma atenuado en una o más líneas mientras escribe.
• Next Edit Suggestions (NES): Al habilitarse, AI Assistant analiza las modificaciones recientes y predice las ediciones subsiguientes, sugiriendo cambios posteriores y permitiendo a los desarrolladores saltar directamente a ubicaciones relacionadas (como actualizar la implementación de una interfaz tras modificar la firma de un método).
• Trigger Delay (Debounce): Configura el tiempo de pausa requerido antes de desencadenar una solicitud de autocompletado en la nube. Los desarrolladores en redes de alta latencia o conexiones móviles medidas pueden aumentar este retraso para reducir llamadas innecesarias a la API.

Atajos de teclado y controles de aceptación

Las sugerencias fantasma en línea se pueden aceptar o descartar mediante combinaciones de teclas estándar:

• Aceptar sugerencia completa: Presione Tab.
• Aceptar siguiente palabra: Presione Ctrl+Flecha derecha (Windows/Linux) u Option+Flecha derecha (macOS) para aceptar la sugerencia token por token de manera parcial.
• Aceptar siguiente línea: Presione Ctrl+Flecha abajo o la combinación personalizada asignada para incorporar sugerencias de forma incremental.
• Descartar sugerencia: Presione Esc o continúe escribiendo caracteres incompatibles.
• Disparo manual: Si las sugerencias en línea automáticas están deshabilitadas, active el autocompletado a petición presionando Alt+\ (Windows/Linux) u Option+\ (macOS).

AI Chat, gestión del contexto y reglas del proyecto

La ventana de herramientas AI Chat actúa como un entorno interactivo de programación en pareja capaz de razonar a través de archivos, trazas de pila (stack traces) e historial del proyecto.

Referencia de contexto mediante menciones

En lugar de copiar y pegar fragmentos de código fuente en el prompt del chat, los desarrolladores deben proporcionar contexto específico utilizando referencias con el símbolo @:

• @file:ruta/al/Archivo.java: Incrusta el contenido de un archivo de proyecto específico en la carga útil del prompt.
• @symbol:NombreClase#nombreMetodo: Inyecta la declaración, docstrings e implementación de una clase, interfaz o función concreta.
• @folder:src/main/services: Envía estructuras de directorios e interfaces de módulos.
• @commit:hash: Suministra diferencias de commits de Git y metadatos para revisión de código y análisis de regresión.

Búsqueda en documentación oficial con /docs

Los desarrolladores que necesiten asistencia sobre el IDE pueden consultar la documentación de JetBrains directamente desde el prompt del chat mediante el comando /docs. Por ejemplo, ingresar:

/docs how do I configure remote Docker debugging for GoLand?

desencadena una consulta RAG (generación aumentada por recuperación) contra la documentación oficial de productos JetBrains, devolviendo pasos prescriptivos con enlaces profundos directos a los diálogos de configuración del IDE.

Biblioteca de prompts personalizada (Prompt Library)

Los equipos a menudo ejecutan patrones arquitectónicos recurrentes, como crear clases de repositorio, simular clientes HTTP o migrar frameworks heredados. Los desarrolladores pueden estandarizar estos prompts a través de Settings | Tools | AI Assistant | Prompt Library:

1. Haga clic en Add (+) para crear una nueva plantilla de prompt personalizada.
2. Defina un título descriptivo (p. ej., Generate Spring Data JPA Repository).
3. Introduzca el texto de la plantilla utilizando marcadores dinámicos como $SELECTION para representar el código resaltado.
4. Asigne el prompt a los menús contextuales del editor para una ejecución rápida con un solo clic.

Aplicación de estándares mediante reglas del proyecto (ai-rules.md)

Para evitar que AI Assistant genere código que infrinja las convenciones del repositorio, los equipos pueden establecer reglas de proyecto persistentes en Settings | Tools | AI Assistant | Rules o confirmando un archivo markdown en la raíz del repositorio en .jetbrains/ai-rules.md.

Un archivo de reglas eficaz instruye al asistente sobre límites arquitectónicos, guías de estilo y patrones de prueba:

# Project Architectural Guidelines

## Technology Stack
- Java 21 LTS with Spring Boot 3.3
- Build Tool: Gradle with Kotlin DSL
- Testing: JUnit 5, AssertJ, and Testcontainers (avoid Mockito for integration tests)

## Code Conventions
- Prefer immutable records for Data Transfer Objects (DTOs).
- Enforce explicit constructor injection; do not use field-level `@Autowired`.
- All public REST controllers must return `ResponseEntity<T>` with OpenAPI 3 annotations.
- Handle database operations asynchronously via R2DBC where reactive pipelines are present.

## Security Constraints
- Never log raw authorization tokens, customer personally identifiable information (PII), or passwords.
- Enforce parameter binding on all SQL and JPQL queries to prevent injection vulnerabilities.

AI Assistant lee .jetbrains/ai-rules.md y anexa sus restricciones a los prompts emitidos dentro del repositorio, asegurando que las sugerencias se ajusten a los estándares del equipo.

Agentes de codificación, ACP y Model Context Protocol (MCP)

Las versiones modernas de JetBrains AI Assistant se extienden más allá de las sugerencias pasivas de código hacia flujos de trabajo con agentes autónomos y activos.

Agentes de codificación autónomos

En Settings | Tools | AI Assistant | Agents, los desarrolladores pueden configurar agentes de codificación especializados:

• Junie: Agente propietario de JetBrains diseñado para refactorizaciones en múltiples archivos, corrección autónoma de errores y generación de pruebas. Junie formula un plan de ejecución paso a paso, modifica archivos, ejecuta comandos de terminal local o ejecutores de pruebas y presenta diffs unificados para revisión del desarrollador.
• Claude Agent y OpenAI Codex: Integraciones que utilizan cuentas de proveedor o claves de API para ejecutar tareas de programación de extremo a extremo.
• Agent Client Protocol (ACP): Protocolo estandarizado que permite a los desarrolladores integrar agentes personalizados o propietarios de terceros directamente en el IDE sin necesidad de escribir plugins adicionales.

Integración de herramientas de Model Context Protocol (MCP)

A través de herramientas MCP, AI Assistant puede interactuar con entornos externos, bases de datos, motores de contenedores y gestores de incidencias empresariales.

Para preservar la seguridad, los desarrolladores deben configurar de forma explícita los permisos de base de datos en Settings | Tools | AI Assistant:

• Read database schemas: Permite a los agentes MCP inspeccionar tablas, tipos de columna e índices para construir consultas SQL precisas.
• Modify database schemas: Controla si los agentes pueden generar y ejecutar sentencias DDL de migración (CREATE, ALTER, DROP).
• Read database data: Permite a los agentes ejecutar consultas e inspeccionar resultados para depurar incidencias de datos.
• Modify database data: Requiere autorización explícita antes de que un agente pueda emitir sentencias INSERT, UPDATE o DELETE.

Proveedores externos y modelos personalizados (BYOK)

Las organizaciones que buscan centralizar el gasto en IA o aprovechar pasarelas de modelos internas pueden desvincular AI Assistant de las suscripciones en la nube gestionadas por JetBrains mediante la configuración Bring Your Own Key.

Configuración de proveedores externos

Navegue a Settings | Tools | AI Assistant | Providers & API keys:

1. Haga clic en Add Provider y elija entre los proveedores comerciales compatibles:
   • OpenAI: Requiere una clave de API de la plataforma OpenAI con acceso a modelos como gpt-4o u o1.
   • Anthropic: Requiere una clave de API de Anthropic compatible con claude-3-5-sonnet o claude-3-opus.
   • Google Cloud Vertex AI: Se autentica mediante credenciales predeterminadas de la aplicación (ADC) o claves de cuenta de servicio.
2. Ingrese la credencial y compruebe la latencia de la conexión.
3. Asigne modelos a roles funcionales (p. ej., modelos rápidos para autocompletado de código en línea frente a modelos de razonamiento más potentes para AI Chat y refactorización).

Conexión de extremos locales y personalizados

Para entornos aislados (air-gapped) o centros de datos privados, los desarrolladores pueden seleccionar modelos personalizados:

+-------------------------------------------------------------+
|                      Local Workstation                      |
|                                                             |
|  +------------------------+      +-----------------------+  |
|  |     JetBrains IDE      |      |     Ollama Server     |  |
|  |  (AI Assistant Plugin) | ---> | (http://localhost:    |  |
|  |                        | <--- |  11434/v1)            |  |
|  +------------------------+      +-----------------------+  |
+-------------------------------------------------------------+

1. Inicie un servidor de inferencia local que exponga una API compatible con OpenAI (como Ollama, vLLM o LM Studio).
2. En Providers & API keys, agregue un proveedor Custom OpenAI-Compatible.
3. Configure la URL base (por ejemplo, http://localhost:11434/v1 para Ollama) y especifique el identificador del modelo cargado (como qwen2.5-coder:32b o deepseek-coder-v2).
4. Valide que los autocompletados locales se transmitan correctamente al editor sin salida externa a la WAN.

Gobernanza de datos, privacidad y controles empresariales

Implementar asistentes de codificación con IA en entornos comerciales requiere salvaguardas transparentes de privacidad de datos y auditoría.

Transmisión de datos y límites del entrenamiento de modelos

JetBrains establece límites claros para el tratamiento de datos en su documentación y en el Trust Center:

• Cero entrenamiento de modelos base: El código fuente del cliente, las cargas útiles de contexto y los autocompletados generados nunca son retenidos ni utilizados por JetBrains ni por sus socios de modelos para entrenar modelos base fundacionales.
• Procesamiento efímero: Los prompts enrutados a través del servicio JetBrains AI se almacenan en búfer en la memoria exclusivamente para la ejecución de la inferencia y el cumplimiento de registros, tras lo cual se descartan.
• Opción de inclusión en el uso compartido de datos: El ajuste Send detailed code-related data está deshabilitado de forma predeterminada. Si se habilita manualmente, la telemetría se anonimiza y se utiliza exclusivamente para evaluar el rendimiento de las funciones del IDE de JetBrains.

Cortafuegos corporativos, proxies e inspección SSL

Las estaciones de trabajo de desarrollo que operan dentro de perímetros empresariales deben permitir la comunicación saliente segura:

• Puntos de enlace de la pasarela: Agregue a la lista de permitidos las conexiones salientes HTTPS (puerto 443) y WebSocket (WSS) a *.jetbrains.com y a los extremos de modelos de terceros designados.
• Inspección SSL empresarial: Si los dispositivos de seguridad corporativos interceptan conexiones TLS mediante autoridades de certificación (CA) internas, los desarrolladores deben asegurarse de añadir el certificado de la CA corporativa al almacén de certificados de confianza del IDE (Settings | Tools | Server Certificates) para evitar errores de enlace TLS.

Supervisión de cuotas y opciones de desactivación

El widget de estado JetBrains AI en el encabezado de la ventana proporciona visibilidad en tiempo real sobre las métricas de uso:

• Cuota de suscripción: Realiza un seguimiento de los créditos de IA mensuales restantes e indica la fecha de reinicio mensual.
• Créditos adicionales (Top-Up Credits): Permite a desarrolladores individuales o equipos comprar paquetes suplementarios de créditos cuando tareas intensivas de agentes agotan las cuotas base.
• Gestión de fondos compartidos: Muestra dinámicamente el consumo de créditos al conectarse a un servidor de licencias corporativo.

Si los desarrolladores necesitan suspender AI Assistant, existen opciones para deshabilitar las funciones temporalmente para un solo proyecto a través del menú del widget, deshabilitar el autocompletado en la nube manteniendo la asistencia local de línea completa, o desinstalar permanentemente el plugin en toda la instalación del IDE.