Installazione

Installare AI Diff Review è semplice e richiede solo pochi minuti. Il plugin è disponibile direttamente dal JetBrains Marketplace, e l'installazione viene gestita tramite il gestore di plugin integrato di IntelliJ IDEA.

Passo 1: Aprire il gestore di plugin

In IntelliJ IDEA, naviga su File → Impostazioni → Plugin (o IntelliJ IDEA → Preferenze → Plugin su macOS). Fai clic sulla scheda "Marketplace" per sfogliare i plugin disponibili.

Passo 2: Cercare e installare

Cerca "AI Diff Review" nella casella di ricerca del marketplace. Vedrai il plugin elencato con la sua descrizione e valutazioni. Fai clic sul pulsante "Installa" per iniziare il processo di installazione. IntelliJ IDEA scaricherà e installerà il plugin, poi ti chiederà di riavviare l'IDE.

Passo 3: Riavviare IntelliJ IDEA

Dopo l'installazione, riavvia IntelliJ IDEA per attivare il plugin. Quando l'IDE si riavvia, vedrai una finestra di dialogo di benvenuto che ti ringrazia per aver installato AI Diff Review e ti guida attraverso la configurazione iniziale.

Configurazione iniziale

Al primo avvio dopo l'installazione, AI Diff Review presenta una finestra di dialogo di benvenuto amichevole che ti aiuta a iniziare rapidamente. Questo processo di configurazione una tantum ti guida attraverso la scelta del tuo provider di IA e la configurazione delle impostazioni di base.

Scegliere il tuo provider di IA

AI Diff Review supporta più provider di IA, dandoti flessibilità in base ai tuoi requisiti di privacy e preferenze:

  • Ollama (Locale): Eseguire analisi completamente sulla tua macchina. Nessuna chiave API richiesta.
  • LM Studio (Locale): Usare l'API compatibile con OpenAI di LM Studio per analisi locale.
  • OpenAI (Cloud): Usare GPT-5 o GPT-5-mini per analisi basate sul cloud.
  • Claude (Cloud): Usare i modelli Claude Sonnet o Claude Opus.
  • Gemini (Cloud): Usare i modelli Gemini 2.5 Pro o Flash di Google.
  • Grok (Cloud): Usare i modelli Grok di xAI per l'analisi.

Configurare provider cloud

Se scegli un provider cloud, dovrai inserire la tua chiave API. Il plugin fornisce link utili per ottenere chiavi API per ogni provider:

  • OpenAI: Apre la pagina delle impostazioni delle chiavi API
  • Claude: Apre la console Anthropic
  • Gemini: Apre Google AI Studio
  • Grok: Apre la console xAI

Le chiavi API sono memorizzate in modo sicuro usando il sistema PasswordSafe di IntelliJ, quindi non devi preoccuparti che vengano esposte nei tuoi file di progetto.

Configurare provider locali

Per provider locali come Ollama o LM Studio, dovrai:

  1. Installare ed eseguire Ollama o LM Studio sulla tua macchina
  2. Scaricare o selezionare un modello (per Ollama, puoi sfogliare i modelli su ollama.com)
  3. Inserire l'indirizzo host (il predefinito per LM Studio è http://127.0.0.1:1234/v1)
  4. Aggiornare l'elenco dei modelli e selezionare il tuo modello preferito

Eseguire la tua prima analisi

Una volta completata la configurazione, puoi iniziare a usare AI Diff Review immediatamente. Ci sono diversi modi per attivare un'analisi:

Metodo 1: Menu Strumenti

Il modo più diretto è tramite l'opzione di menu Strumenti → AI Diff Review. Questo analizza tutti i file modificati dal tuo ultimo commit.

Metodo 2: Menu contestuali

Fai clic destro nell'editor o nell'albero del progetto e seleziona AI Diff Review. Questo ti dà accesso rapido all'analisi da qualsiasi punto nel tuo IDE.

Metodo 3: Log VCS

Apri la finestra degli strumenti Log VCS, fai clic destro su qualsiasi commit e scegli AI Diff Review This Commit. Questo è perfetto per analizzare modifiche passate o capire cosa è successo in un commit specifico.

Comprendere i risultati

Dopo aver eseguito un'analisi, i risultati appaiono nella finestra degli strumenti "AI Diff Review" nella parte inferiore del tuo IDE. I risultati sono organizzati in diverse sezioni:

Tabella dei risultati

La tabella principale dei risultati mostra tutti i problemi e i suggerimenti, con colonne per:

  • File: Il file dove è stato trovato il problema
  • Tipo: La categoria (Problemi critici, Preoccupazioni di sicurezza, ecc.)
  • Severità: CRITICO, AVVERTENZA o INFO
  • Riga: Il numero di riga (se applicabile)
  • Descrizione: Spiegazione dettagliata del risultato

Filtraggio e ordinamento

Puoi filtrare i risultati per severità usando chip di toggle, filtrare per tipo, o cercare termini specifici. La tabella è ordinabile facendo clic sugli intestazioni delle colonne, rendendo facile concentrarsi prima sui risultati più importanti.

Navigazione

Fai doppio clic su qualsiasi risultato per aprire il file alla riga specifica. Questo rende facile rivedere e correggere problemi direttamente dai risultati dell'analisi.

Prossimi passi

Ora che hai eseguito la tua prima analisi, puoi esplorare funzionalità più avanzate:

  • Configurare il gate di commit per rivedere automaticamente prima dei commit
  • Personalizzare i pattern di redazione dei segreti per la tua codebase
  • Regolare i controlli dell'ambito diff per più o meno contesto
  • Impostare la modalità "Think harder" per analisi complesse

Per informazioni più dettagliate su queste funzionalità, consulta i nostri altri articoli del blog che coprono ogni argomento in profondità.

Conclusione

Iniziare con AI Diff Review è veloce e semplice. Il processo di configurazione intuitivo del plugin e i suoi molteplici punti di ingresso rendono facile l'integrazione nel tuo flusso di lavoro. Con la tua prima analisi completata, sei pronto per iniziare a migliorare la qualità del tuo codice con insights assistiti da IA.

Ricorda, hai una prova gratuita di 14 giorni per esplorare tutte le funzionalità. Se hai bisogno di aiuto o hai domande, il pannello delle impostazioni del plugin fornisce tooltip dettagliati e link alla documentazione.

Pronto per approfondire? Installa il plugin e inizia oggi il tuo viaggio verso una migliore qualità del codice.