Instalación

Instalar AI Diff Review es simple y toma solo unos minutos. El plugin está disponible directamente desde el JetBrains Marketplace, y la instalación se maneja a través del administrador de plugins integrado de IntelliJ IDEA.

Paso 1: Abrir el administrador de plugins

En IntelliJ IDEA, navega a Archivo → Configuración → Plugins (o IntelliJ IDEA → Preferencias → Plugins en macOS). Haz clic en la pestaña "Marketplace" para explorar los plugins disponibles.

Paso 2: Buscar e instalar

Busca "AI Diff Review" en el cuadro de búsqueda del marketplace. Verás el plugin listado con su descripción y calificaciones. Haz clic en el botón "Instalar" para comenzar el proceso de instalación. IntelliJ IDEA descargará e instalará el plugin, luego te pedirá que reinicies el IDE.

Paso 3: Reiniciar IntelliJ IDEA

Después de la instalación, reinicia IntelliJ IDEA para activar el plugin. Cuando el IDE se reinicie, verás un diálogo de bienvenida agradeciéndote por instalar AI Diff Review y guiándote a través de la configuración inicial.

Configuración inicial

En el primer lanzamiento después de la instalación, AI Diff Review presenta un diálogo de bienvenida amigable que te ayuda a comenzar rápidamente. Este proceso de configuración único te guía a través de elegir tu proveedor de IA y configurar los ajustes básicos.

Elegir tu proveedor de IA

AI Diff Review soporta múltiples proveedores de IA, dándote flexibilidad basada en tus requisitos de privacidad y preferencias:

  • Ollama (Local): Ejecutar análisis completamente en tu máquina. No se requieren claves API.
  • LM Studio (Local): Usar la API compatible con OpenAI de LM Studio para análisis local.
  • OpenAI (Cloud): Usar GPT-5 o GPT-5-mini para análisis basado en la nube.
  • Claude (Cloud): Usar los modelos Claude Sonnet o Claude Opus.
  • Gemini (Cloud): Usar los modelos Gemini 2.5 Pro o Flash de Google.
  • Grok (Cloud): Usar los modelos Grok de xAI para análisis.

Configurar proveedores en la nube

Si eliges un proveedor en la nube, necesitarás ingresar tu clave API. El plugin proporciona enlaces útiles para obtener claves API para cada proveedor:

  • OpenAI: Abre la página de configuración de claves API
  • Claude: Abre la consola de Anthropic
  • Gemini: Abre Google AI Studio
  • Grok: Abre la consola de xAI

Las claves API se almacenan de forma segura usando el sistema PasswordSafe de IntelliJ, por lo que no necesitas preocuparte de que se expongan en tus archivos de proyecto.

Configurar proveedores locales

Para proveedores locales como Ollama o LM Studio, necesitarás:

  1. Instalar y ejecutar Ollama o LM Studio en tu máquina
  2. Descargar o seleccionar un modelo (para Ollama, puedes explorar modelos en ollama.com)
  3. Ingresar la dirección del host (el predeterminado para LM Studio es http://127.0.0.1:1234/v1)
  4. Actualizar la lista de modelos y seleccionar tu modelo preferido

Ejecutar tu primera análisis

Una vez que la configuración esté completa, puedes comenzar a usar AI Diff Review inmediatamente. Hay varias formas de activar un análisis:

Método 1: Menú Herramientas

La forma más directa es a través de la opción de menú Herramientas → AI Diff Review. Esto analiza todos los archivos modificados desde tu último commit.

Método 2: Menús contextuales

Haz clic derecho en el editor o árbol del proyecto y selecciona AI Diff Review. Esto te da acceso rápido al análisis desde cualquier lugar en tu IDE.

Método 3: Registro VCS

Abre la ventana de herramientas Registro VCS, haz clic derecho en cualquier commit y elige AI Diff Review This Commit. Esto es perfecto para analizar cambios pasados o entender qué pasó en un commit específico.

Entender los resultados

Después de ejecutar un análisis, los resultados aparecen en la ventana de herramientas "AI Diff Review" en la parte inferior de tu IDE. Los resultados están organizados en varias secciones:

Tabla de hallazgos

La tabla principal de hallazgos muestra todos los problemas y sugerencias, con columnas para:

  • Archivo: El archivo donde se encontró el problema
  • Tipo: La categoría (Problemas críticos, Preocupaciones de seguridad, etc.)
  • Severidad: CRÍTICO, ADVERTENCIA o INFO
  • Línea: El número de línea (si aplica)
  • Descripción: Explicación detallada del hallazgo

Filtrado y ordenamiento

Puedes filtrar resultados por severidad usando chips de alternancia, filtrar por tipo, o buscar términos específicos. La tabla es ordenable haciendo clic en los encabezados de columna, facilitando enfocarse en los hallazgos más importantes primero.

Navegación

Haz doble clic en cualquier hallazgo para abrir el archivo en la línea específica. Esto facilita revisar y corregir problemas directamente desde los resultados del análisis.

Próximos pasos

Ahora que has ejecutado tu primera análisis, puedes explorar características más avanzadas:

  • Configurar la puerta de commit para revisar automáticamente antes de los commits
  • Personalizar patrones de redacción de secretos para tu base de código
  • Ajustar controles de alcance de diff para más o menos contexto
  • Configurar el modo "Think harder" para análisis complejos

Para información más detallada sobre estas características, consulta nuestros otros artículos del blog que cubren cada tema en profundidad.

Conclusión

Empezar con AI Diff Review es rápido y directo. El proceso de configuración intuitivo del plugin y sus múltiples puntos de entrada facilitan la integración en tu flujo de trabajo. Con tu primera análisis completa, estás listo para comenzar a mejorar la calidad de tu código con insights asistidos por IA.

Recuerda, tienes una prueba gratuita de 14 días para explorar todas las características. Si necesitas ayuda o tienes preguntas, el panel de configuración del plugin proporciona tooltips detallados y enlaces a la documentación.

¿Listo para profundizar? Instala el plugin y comienza tu viaje hacia una mejor calidad de código hoy.