Luca Di Domenico

AI Development

Code review con Claude Code: 5 righe nel CLAUDE.md per fermare le revisioni infinite, dalle regole del team di Anthropic

Per fermare la code review infinita di Claude Code bastano 5 righe nel CLAUDE.md: cosa è un errore, 3 note di stile, file e riga, il conteggio, 3 giri.

Luca Di Domenico

Luca Di Domenico

· 6 min di lettura

In breve

Nel team di Claude Code una pull request ha fatto più di 50 giri di revisione e correzione in una notte, e circa il 59% delle segnalazioni riguardava codice già presente al primo controllo. Dopo il tetto di 3 giri, le pull request interne che richiedono 5 giri o più sono scese dall’8,9% all’1,5%. Le stesse idee stanno in 5 righe da copiare nel CLAUDE.md prima di lanciare /code-review: cosa vuol dire errore, al massimo 3 osservazioni di stile, file e riga per ogni problema, riepilogo che parte dal conteggio, massimo 3 giri.

Per fermare le revisioni infinite di Claude Code bastano 5 righe nel CLAUDE.md: cosa vuol dire errore nel tuo progetto, al massimo 3 osservazioni di stile, file e riga per ogni problema, un riepilogo che parte dal numero di problemi e un tetto di 3 giri. Poi, prima di pubblicare, lanci /code-review. Le regole vengono da quello che il team di Claude Code ha imparato dopo una notte in cui un revisore AI ha continuato a ripescare gli stessi problemi.

Cosa è successo nel team di Claude Code?

Una pull request della CLI di Claude Code ha fatto più di 50 giri di revisione e correzione in una sola notte, prima che chi l’aveva aperta la fermasse. Un agente correggeva, l’agente revisore trovava altre segnalazioni, e nessuno dei due si fermava. Lo raccontano Addy Osmani, Morgan Westlee Lunt e Qing Wang nel post How the Claude Code team does code review, pubblicato il 15 ottobre 2026 sul blog per sviluppatori di Anthropic.

Gli ingegneri hanno passato a git blame quello che il revisore continuava a segnalare. Circa il 59% riguardava codice che c’era già al primo controllo. Il revisore di Claude Code trovava raramente errori nuovi: a ogni giro ripescava qualche problema vecchio in più.

Perché può succedere anche a te?

Se chiedi a Claude di ricontrollare il codice finché tutto è perfetto, crei la stessa situazione: un autore e un revisore che si tengono occupati a vicenda. Il post di Anthropic spiega il meccanismo: una persona ignora un’osservazione di stile in pochi secondi, un agente invece la corregge. Ogni correzione vuol dire un altro commit e un altro giro di revisione.

Ogni giro ha un costo. Il comando /code-review gira nella tua sessione e consuma l’abbonamento o il credito API come il resto del lavoro. Il risultato è che spendi la quota e il progetto non migliora.

Cosa è cambiato con le nuove regole?

Dopo quell’episodio il team di Claude Code ha messo un tetto ai giri: dopo il terzo, il revisore chiede all’autore di fermarsi e ripensare l’approccio. Ha anche limitato le revisioni successive alle sole modifiche nuove e ha vietato di ripetere segnalazioni già fatte. Sulle pull request interne i numeri sono questi:

  • passano dopo un solo giro di revisione e correzione: dal 65% al 78%;
  • richiedono 5 giri o più: dall’8,9% all’1,5%;
  • revisioni medie prima di passare: da 2,08 a 1,32.

Da giugno a settembre, poi, le pull request portate in produzione nel codice di Claude Code sono più che raddoppiate, e la quota di modifiche da annullare perché rompevano qualcosa è scesa di oltre il 40%. Questo dato riguarda tutto il sistema di revisione che il team ha costruito, regole sui giri comprese: più codice pubblicato e meno passi indietro.

Quali sono le 5 righe da copiare nel CLAUDE.md?

/code-review è il comando con cui Claude Code rilegge il tuo codice come farebbe un collega. Cosa controllare però glielo scrivi tu, nel file CLAUDE.md del progetto. Queste sono le mie 5 righe, costruite sui consigli del post di Anthropic:

# Regole per la revisione
- Errore qui vuol dire: il totale mostrato al cliente è sbagliato.
- Al massimo 3 osservazioni di stile: il resto lascialo stare.
- Per ogni segnalazione indica file e riga. Niente ipotesi senza prova.
- Il riepilogo inizia con il numero di problemi trovati. Se non c'è niente da sistemare, scrivilo.
- Revisione: massimo 3 giri. Dopo il terzo fermati e proponi di cambiare approccio.
  1. Cosa vuol dire errore. La prima riga dice a Claude Code cosa conta davvero nel tuo progetto. In un software per preventivi, un errore è un totale sbagliato mostrato al cliente. È la riga da adattare: il post di Anthropic cita la documentazione, dove l’errore è un’informazione falsa, e la configurazione, dove è un instradamento sbagliato.
  2. Al massimo 3 osservazioni di stile. Così la revisione non si riempie di dettagli inutili che l’agente poi corregge uno per uno.
  3. File e riga per ogni problema. Claude Code deve indicare dove sta il problema, con una prova reale. Niente ipotesi dedotte dal nome di una funzione.
  4. Il riepilogo parte dal numero di problemi. Se non c’è niente da sistemare, Claude Code lo scrive. Non deve per forza trovare qualcosa.
  5. Massimo 3 giri. Dopo il terzo Claude Code si ferma e, al massimo, ti propone di cambiare strada.

Ogni revisione carica il CLAUDE.md, quindi conviene tenerlo corto: ho spiegato qui perché va rivisto spesso. Queste 5 righe ci stanno senza appesantirlo.

Che differenza fanno le regole?

Ho lanciato la stessa revisione con e senza regole. Senza regole sono arrivate 3 segnalazioni in inglese, una delle quali fuori tema. Con le regole sono arrivati 2 problemi in italiano, con l’esempio concreto di cosa vede il cliente: un imponibile di 0 € invece di 450 €.

La differenza sta tutta nella prima riga. Quando Claude Code sa che un errore è un totale sbagliato, cerca proprio quello e lo descrive con le conseguenze per chi usa il software.

Cosa cambia con il piano Team o Enterprise?

Con il piano Team o Enterprise c’è anche Code Review, il servizio di Anthropic che rivede in automatico ogni pull request su GitHub. Le stesse regole le puoi mettere in un file REVIEW.md nella radice del repository. Il servizio legge sia il CLAUDE.md sia il REVIEW.md, e prende il REVIEW.md dal branch principale: va unito lì prima che abbia effetto.

Il comando /code-review sul tuo computer, invece, legge solo il CLAUDE.md e funziona con qualsiasi piano. Per questo le regole che vuoi valide in entrambi i posti vanno nel CLAUDE.md. Anche la manutenzione automatica delle app di Anthropic passa da Claude Code Review prima del controllo umano: ho raccontato qui come funziona.

Da dove partire?

Copia le 5 righe nel CLAUDE.md, cambia la prima con quello che per il tuo progetto è un errore vero e lancia /code-review prima di pubblicare. La tua prossima revisione avrà un obiettivo chiaro e una fine.

Fonti

  • How the Claude Code team does code review — Post di Addy Osmani, Morgan Westlee Lunt e Qing Wang del 15 ottobre 2026: una PR della CLI con più di 50 giri di revisione in una notte, circa il 59% delle segnalazioni su codice già presente al primo passaggio, tetto di 3 giri, pull request che passano al primo giro dal 65% al 78%, con 5+ giri dall’8,9% all’1,5%, revisioni medie da 2,08 a 1,32; da giugno a settembre PR mergiate più che raddoppiate e quota di revert scesa di oltre il 40%; Code Review disponibile sui piani Team ed Enterprise
  • Review locally with /code-review — Documentazione di Claude Code consultata il 10 novembre 2026: /code-review funziona con qualsiasi piano, consuma la quota della sessione, segue il CLAUDE.md e non legge il REVIEW.md
  • Customize Code Review — Documentazione di Claude Code consultata il 10 novembre 2026: il servizio Code Review su GitHub legge CLAUDE.md e REVIEW.md, e prende il REVIEW.md dal branch principale o di base, mai dalle modifiche della pull request

Vuoi capire cosa significa per il tuo prodotto?

Se stai costruendo software con l'AI e vuoi un confronto su come stai lavorando, raccontami il tuo progetto.

Raccontami il tuo progetto
Claude CodeCode reviewAgenti AISviluppo con AI

Segui il blog

Un'email per ogni nuovo articolo

Ti scrivo solo quando esce un articolo: titolo, riassunto e link. Ti disiscrivi con un clic da ogni email.

Feed RSS

Un feed RSS è l'elenco aggiornato degli articoli: lo aggiungi a un'app di lettura come Feedly o Inoreader e vedi i nuovi articoli lì, senza lasciare l'email.

lucadidomenico.studio/it/blog/rss.xml