Revisione del codice con Claude Code: i plugin ufficiali

Per far rivedere il codice a Claude Code prima di unirlo al progetto principale hai tre plugin ufficiali di Anthropic: code-review, che analizza una pull request con quattro agenti in parallelo e tiene solo i problemi più probabili, pr-review-toolkit, che offre revisori specializzati su commenti, test, gestione degli errori e tipi, e code-simplifier, che rende più leggibile il codice appena scritto senza cambiarne il comportamento. A questi si affiancano i comandi già integrati in Claude Code, come /code-review e la revisione approfondita nel cloud.

Se non programmi, pensa alla revisione del codice come alla rilettura di un contratto da parte di un collega prima della firma: qualcuno controlla che non ci siano errori, che le regole interne siano rispettate e che il testo sia comprensibile anche tra un anno. Un plugin è un pacchetto che aggiunge a Claude Code comandi e agenti con un solo comando di installazione; la serie completa è nella guida ai plugin di Claude Code.

Perché usare plugin di revisione se Claude Code ha già /code-review?

Nelle versioni recenti Claude Code include di serie un comando /code-review che cerca bug nelle modifiche del ramo corrente, con livelli di impegno, l'opzione --fix per applicare le correzioni e --comment per pubblicarle sulla pull request. Esiste anche /simplify, che cerca solo opportunità di pulizia e applica le modifiche. Per molti progetti questi comandi integrati bastano.

I plugin ufficiali hanno un ruolo diverso: sono istruzioni scritte in file Markdown che puoi leggere, copiare nel tuo marketplace privato e adattare. Il README di code-review, per esempio, spiega come cambiare la soglia di confidenza o aggiungere agenti dedicati a prestazioni o accessibilità modificando il file del comando. pr-review-toolkit, invece, ti permette di chiedere solo la revisione dei test o solo quella della gestione degli errori. In più i comandi dei plugin hanno sempre il prefisso del plugin, quindi convivono con quelli integrati senza sostituirli.

Come funziona il plugin code-review?

Il plugin code-review aggiunge un comando che, su un ramo con una pull request aperta su GitHub, esegue una sequenza precisa descritta nel suo README:

1. controlla se la revisione serve davvero e salta le pull request chiuse, in bozza, banali o già revisionate;
2. raccoglie i file CLAUDE.md del repository, cioè le istruzioni di progetto (le trovi spiegate in CLAUDE.md: istruzioni di progetto);
3. riassume le modifiche;
4. avvia quattro agenti in parallelo: due verificano il rispetto delle regole di CLAUDE.md, uno cerca bug evidenti nelle modifiche, uno usa la cronologia di git per trovare problemi legati al contesto;
5. assegna a ogni problema un punteggio di confidenza da 0 a 100 e scarta quelli sotto 80;
6. mostra il risultato nel terminale oppure, con --comment, lo pubblica come commento sulla pull request.

Il filtro è la parte più interessante: il plugin scarta i problemi già presenti prima della pull request, le pignolerie, ciò che un linter troverebbe comunque e le questioni di qualità generica non previste da CLAUDE.md. Ogni segnalazione rimanda al codice con l'hash completo del commit e l'intervallo di righe. Per funzionare servono un repository collegato a GitHub e la GitHub CLI gh installata e autenticata.

/plugin install code-review@claude-plugins-official
/code-review:code-review
/code-review:code-review --comment

Il primo comando di revisione mostra il risultato solo a te; il secondo lo pubblica sulla pull request, quindi usalo quando sei sicuro che i commenti siano utili al team. Il README e i dettagli sono nella pagina del plugin code-review.

Che cosa aggiunge pr-review-toolkit?

pr-review-toolkit è una raccolta di sei agenti revisori, ciascuno concentrato su un aspetto. Gli agenti sono istanze separate di Claude con un compito preciso.

Gli agenti si attivano chiedendo in linguaggio naturale, per esempio "controlla la gestione degli errori nel client API", oppure con il comando /pr-review-toolkit:review-pr, che accetta gli aspetti da rivedere: comments, tests, errors, types, code, simplify o all. A differenza di code-review, non pubblica nulla su GitHub: lavora sulle modifiche locali e ti restituisce i risultati in sessione.

Il README suggerisce anche un ordine pratico: revisione generale dopo aver scritto il codice, controllo degli errori se hai toccato i blocchi try/catch, verifica dei test, poi dei commenti e infine la semplificazione. Il consiglio di fondo è non abusarne e concentrarsi sul codice modificato, non sull'intero progetto.

Quando serve code-simplifier?

code-simplifier è un plugin con un solo agente che rifinisce il codice per chiarezza, coerenza e manutenibilità mantenendo identico il comportamento. Secondo le sue istruzioni lavora sul codice modificato di recente, salvo richiesta diversa, segue gli standard scritti in CLAUDE.md, preferisce codice esplicito a soluzioni compatte e, per esempio, evita gli operatori ternari annidati.

È utile dopo una sessione lunga in cui Claude Code ha scritto molto codice funzionante ma prolisso. Le sue istruzioni lo descrivono come proattivo, cioè può intervenire subito dopo una modifica senza una richiesta esplicita: se preferisci decidere tu quando semplificare, tienine conto. Lo stesso agente è incluso anche in pr-review-toolkit, quindi se installi quello non ti serve anche questo.

E ultrareview a che cosa serve?

Ultrareview non è un plugin ma una funzione di Claude Code, al momento in anteprima di ricerca: con /code-review ultra una flotta di agenti revisori lavora in una sandbox nel cloud di Anthropic, e ogni problema segnalato viene riprodotto e verificato in modo indipendente. Il terminale resta libero e i risultati arrivano come notifica a revisione finita.

Ci sono però condizioni precise, descritte nella documentazione di ultrareview: serve l'accesso con un account claude.ai, non è disponibile con Amazon Bedrock, Google Cloud o Microsoft Foundry né per le organizzazioni con Zero Data Retention, e per la revisione di un ramo il codice viene caricato in una sandbox remota. Si paga a parte rispetto all'uso incluso nel piano: prima di ogni esecuzione Claude Code mostra una stima, ma controlla sempre la pagina ufficiale per le condizioni aggiornate.

Quale strumento usare e quando?

• Revisione quotidiana del tuo ramo: il /code-review integrato, descritto in Review locally with /code-review.
• Revisione di una pull request con regole del team e commento pubblicato: il plugin code-review, soprattutto se vuoi personalizzare soglia e agenti.
• Controlli mirati su test, errori, commenti o tipi: pr-review-toolkit.
• Codice funzionante ma difficile da leggere: code-simplifier o il /simplify integrato.
• Modifiche critiche prima del rilascio: ultrareview, se il tuo account e le policy aziendali lo consentono.
• Revisione automatica su ogni pull request in GitHub: non qui, ma nell'articolo sulle GitHub Actions di Claude Code.

Quali limiti e cautele considerare?

Nessuno di questi strumenti sostituisce la revisione di una persona: il README di code-review stesso invita a considerare le segnalazioni un punto di partenza. Gli agenti leggono il codice e le istruzioni di progetto, e i comandi di code-review possono eseguire comandi gh per leggere la pull request e pubblicare commenti con il tuo account: verifica i permessi prima di usarlo su repository di clienti. Se lavori su repository di terzi, ricorda che le istruzioni nascoste nei file possono influenzare un agente; per gli aspetti di sicurezza vera e propria vedi il confronto tra Claude Security e security-guidance.

Ogni agente in più consuma uso del piano o credito API, quindi su pull request piccole un solo controllo è spesso sufficiente. Infine, scrivi bene CLAUDE.md: tutti e tre i plugin lo usano come metro di giudizio, e regole vaghe producono segnalazioni vaghe.

Cosa fare adesso

Prova prima il /code-review integrato sul tuo ramo, poi installa pr-review-toolkit e chiedi una sola revisione mirata, per esempio sugli errori silenziosi. Se ti serve pubblicare commenti con regole condivise dal team, aggiungi il plugin code-review e adatta la soglia al tuo progetto. Se stai modernizzando un vecchio applicativo, questi controlli sono il complemento naturale di code-modernization.