Skip to main content
Puoi cambiare ciò che Code Review segnala nel tuo repository eseguendo il commit di istruzioni al suo interno. È così che riduci il volume dei nit, interrompi i commenti sui file generati o aggiungi una regola a cui il tuo team tiene. Inseriscile in uno di questi due file:
  • CLAUDE.md: istruzioni di progetto che Claude Code legge per ogni attività, revisioni incluse. Code Review le legge come contesto di progetto e segnala le modifiche che le violano.
  • REVIEW.md: istruzioni solo per le revisioni. Usalo per indicare cosa il tuo team vuole che venga segnalato, con quale gravità e cosa saltare.
Aggiungi REVIEW.md alla root del tuo repository ed esegui il merge. Poi proteggi il tuo branch predefinito.
Per cambiare quanto sono approfondite le revisioni o quando vengono eseguite, chiedi a un Owner di modificare il livello di revisione o l’impostazione Review runs.

​
Usa CLAUDE.md per le regole valide per l’intero progetto

Code Review legge i file CLAUDE.md del tuo repository come contesto di progetto. Una modifica che viola una delle loro regole diventa un rilevamento al livello di gravità adatto al problema. Una revisione legge il CLAUDE.md nella root del tuo repository e i file CLAUDE.md nelle directory padre di ciascun file modificato. Il CLAUDE.md di una sottodirectory viene letto quando la pull request modifica un file in quel percorso.

​
Usa REVIEW.md per le regole specifiche della revisione

REVIEW.md è un file nella root del tuo repository che adatta Code Review al tuo repository. Puoi anche aggiungere un REVIEW.md in una sottodirectory per aggiungere controlli sulle modifiche in quel percorso, in aggiunta al file root. Gli agenti che individuano i problemi e gli agenti che li verificano ricevono il suo contenuto come istruzioni di revisione del tuo repository, insieme alle indicazioni di revisione predefinite di Code Review. Il passaggio che scrive la revisione finale lo consulta prima di stabilire la gravità e scrivere il riepilogo. Questo layout di esempio ha un file root e un file in una sottodirectory:
Prima di fare affidamento su un file in una sottodirectory, proteggi il tuo branch predefinito e verifica cosa legge una revisione per la tua configurazione dei branch.
Il servizio Code Review e il comando /code-review locale sono due strumenti separati e leggono file diversi. Il servizio legge sia CLAUDE.md sia REVIEW.md. Il comando /code-review, che esegui all’interno di una sessione di Claude Code sulla tua macchina, legge i tuoi file CLAUDE.md e non REVIEW.md. Inserisci in CLAUDE.md le indicazioni che vuoi applicare in entrambi i contesti e riserva REVIEW.md alle regole specifiche della revisione delle pull request.

​
Esempio di REVIEW.md

Questo REVIEW.md ricalibra la gravità per un servizio backend, limita i nit, salta i file generati e aggiunge controlli specifici del repository.

​
Scegli cosa scrivere in REVIEW.md

REVIEW.md è Markdown in formato libero che cambia ciò che una revisione individua e riporta. Non cambia il formato della revisione. Trova il problema che stai riscontrando, quindi aggiungi un’istruzione come quella mostrata. L’esempio usa le prime quattro.
  • Vengono contrassegnate come Important le cose sbagliate: ridefinisci cosa significa 🔴 Important per il tuo repository. La calibrazione predefinita è pensata per il codice di produzione, e un repository di documentazione, un repository di configurazione o un prototipo potrebbero richiedere una definizione molto più ristretta. Indica quali classi di rilevamenti sono Important e quali sono al massimo Nit. Puoi anche alzare la gravità, ad esempio trattando qualsiasi violazione di CLAUDE.md come Important.
  • Troppi nit: limita quanti commenti 🟡 Nit pubblica una singola revisione. Un limite come “riporta al massimo cinque nit” mantiene le revisioni utilizzabili.
  • Commenti sui file generati o su ciò che la CI controlla già: elenca i percorsi e le categorie di rilevamenti per cui Claude deve saltare le segnalazioni. I candidati comuni sono il codice generato, i lockfile e le dipendenze vendorizzate, oltre a tutto ciò che la tua CI già applica, come il linting o il controllo ortografico. Per i percorsi che meritano una certa revisione ma non un esame completo, imposta invece una soglia più alta: “in scripts/, segnala solo se quasi certo e grave.”
  • Una regola del team non viene controllata: aggiungi le regole che vuoi vengano segnalate in ogni pull request, come “le nuove route API devono avere un test di integrazione.”
  • Rilevamenti che si rivelano errati: richiedi prove prima che una classe di rilevamenti venga pubblicata. Ad esempio, “le affermazioni sul comportamento richiedono una citazione file:line nel sorgente, non un’inferenza basata sui nomi” riduce i falsi positivi che altrimenti costerebbero all’autore un ulteriore scambio.
Alcune di queste istruzioni richiedono il file root su un branch predefinito protetto. Limita REVIEW.md alle istruzioni che cambiano il comportamento della revisione e lascia il contesto generale del progetto in CLAUDE.md.

​
Da quale branch viene letto REVIEW.md

Code Review legge REVIEW.md dal branch di base della pull request o dal branch predefinito, mai dalle modifiche della pull request stessa. Per cambiare il comportamento della revisione, esegui prima il merge della modifica a REVIEW.md. Mantieni REVIEW.md sul tuo branch predefinito e proteggi quel branch. Quando una revisione legge la copia su un branch predefinito protetto, la prima riga della tabella seguente, rispetta queste istruzioni del file root:
  • Abbassare la gravità di un rilevamento
  • Escludere percorsi, file o classi di problemi
  • Limitare i commenti nit

​
Cosa conta come protezione del branch

Code Review considera come protezione queste impostazioni:
  • Branch predefinito: una regola classica di protezione del branch o un ruleset
  • Qualsiasi altro branch: solo un ruleset
Un ruleset conta quando limita gli aggiornamenti o richiede pull request con almeno un’approvazione. Se richiede pull request, deve anche annullare quell’approvazione a ogni nuovo push oppure richiedere che l’approvazione arrivi dopo l’ultimo push.

​
Cosa legge una revisione per ciascuna configurazione dei branch

Trova la situazione del tuo repository nella prima colonna della tabella seguente. Se il check run menziona REVIEW.md, consulta Il check run menziona REVIEW.md.