Code Review analizza le tue richieste pull di GitHub e pubblica i risultati come commenti inline sulle righe di codice dove ha trovato problemi. Una flotta di agenti specializzati esamina i cambiamenti del codice nel contesto della tua base di codice completa, cercando errori logici, vulnerabilità di sicurezza, casi limite non gestiti e regressioni.
Questo articolo spiega come abilitare Code Review, configurare i trigger di revisione, personalizzare cosa viene segnalato e risolvere i problemi comuni di configurazione.
Nota: Code Review è in anteprima di ricerca ed è disponibile nei piani Team ed Enterprise. Non è disponibile per le organizzazioni con conservazione dei dati pari a zero abilitata. L'utilizzo di Code Review viene fatturato separatamente tramite utilizzo aggiuntivo e non conta rispetto all'utilizzo incluso nel tuo piano.
Come funziona Code Review
Una volta che un'organizzazione abilita Code Review, può attivarsi automaticamente quando si apre una richiesta pull, ad ogni push, o solo quando qualcuno richiede manualmente una revisione. Quando viene eseguita una revisione, più agenti analizzano il diff e il codice circostante in parallelo. Ogni agente cerca una classe diversa di problema, quindi un passaggio di verifica controlla i risultati rispetto al comportamento effettivo del codice per filtrare i falsi positivi.
I risultati vengono deduplicati, classificati per gravità e pubblicati come commenti inline sulle righe specifiche dove sono stati trovati i problemi. Se non vengono trovati problemi, Claude pubblica un breve commento di conferma sulla PR. Le revisioni non approvano o bloccano la tua PR, quindi i flussi di lavoro di revisione esistenti rimangono intatti.
Le revisioni si adattano in costo alla dimensione e alla complessità della PR, completandosi in media in 20 minuti.
Livelli di gravità
Ogni risultato è contrassegnato con un livello di gravità:
Marcatore | Gravità | Significato |
🔴 | Normale | Un bug che dovrebbe essere corretto prima del merge |
🟡 | Osservazione | Un problema minore, vale la pena correggerlo ma non è bloccante |
🟣 | Preesistente | Un bug che esiste nella base di codice ma non è stato introdotto da questa PR |
I risultati includono una sezione di ragionamento esteso comprimibile che puoi espandere per vedere perché Claude ha segnalato il problema e come ha verificato il problema.
Cosa controlla Code Review
Per impostazione predefinita, Code Review si concentra sulla correttezza: bug che interromperebbero la produzione, non preferenze di formattazione o copertura di test mancante. Puoi espandere cosa controlla aggiungendo file di guida al tuo repository.
Configurare Code Review
I proprietari e i proprietari primari dei piani Team ed Enterprise possono abilitare Code Review una volta per l'organizzazione e selezionare quali repository includere. Oltre a un ruolo di proprietario all'interno della tua organizzazione Claude, avrai bisogno dell'autorizzazione per installare GitHub App nella tua organizzazione GitHub.
Vai a Impostazioni organizzazione > Claude Code e trova la sezione Code Review.
Fai clic su "Configura" per iniziare il flusso di installazione di GitHub App.
Segui i prompt per installare Claude GitHub App nella tua organizzazione GitHub. L'app richiede autorizzazioni di lettura e scrittura per contenuti, problemi e richieste pull.
Scegli quali repository abilitare per Code Review. Se non vedi un repository, conferma di aver concesso a Claude GitHub App l'accesso durante l'installazione.
Imposta un trigger di revisione per ogni repository utilizzando il menu a discesa Review Behavior (vedi la sezione successiva per i dettagli su ogni opzione).
Per verificare la configurazione, apri una PR di test. Se hai scelto un trigger automatico, un'esecuzione di controllo denominata Claude Code Review dovrebbe apparire entro pochi minuti. Se hai scelto Manuale, commenta "@claude review" sulla PR per avviare la prima revisione.
Scegli un trigger di revisione
Dopo la configurazione, la sezione Code Review mostra i tuoi repository in una tabella. Per ogni repository, scegli quando vengono eseguite le revisioni:
Una volta dopo la creazione della PR: La revisione viene eseguita una volta quando una PR viene aperta o contrassegnata come pronta per la revisione.
Dopo ogni push: La revisione viene eseguita ad ogni push nel ramo della PR, rilevando nuovi problemi man mano che la PR si evolve. Claude risolve automaticamente i thread quando correggi i problemi precedentemente segnalati. Questo esegue il maggior numero di revisioni e costa di più.
Manuale: Le revisioni iniziano solo quando qualcuno commenta "@claude review" su una PR. Utile per i repository ad alto traffico dove vuoi selezionare quali PR vengono revisionate.
La tabella dei repository mostra anche il costo medio per revisione per ogni repo in base all'attività recente.
Attiva manualmente le revisioni
Commenta "@claude review" su una richiesta pull per avviare una revisione e attivare quella PR per le revisioni attivate da push in futuro. Questo funziona indipendentemente dal trigger configurato del repository.
Affinché il commento attivi una revisione:
Pubblicalo come commento PR di primo livello, non come commento inline su una riga di diff.
Metti "@claude review" all'inizio del commento.
Devi avere accesso come proprietario, membro o collaboratore al repository.
La PR deve essere aperta e non una bozza.
Se una revisione è già in corso, la richiesta viene messa in coda fino al completamento della revisione in corso.
Personalizza le revisioni
Code Review legge due file dal tuo repository per guidare cosa segnala. Entrambi si aggiungono ai controlli di correttezza predefiniti.
CLAUDE.md
Code Review legge i file CLAUDE.md del tuo repository e tratta le violazioni appena introdotte come risultati a livello di osservazione. Se la tua PR modifica il codice in modo da rendere obsoleta un'affermazione CLAUDE.md, Claude segnala che anche la documentazione deve essere aggiornata.
Claude legge i file CLAUDE.md a ogni livello della gerarchia di directory, quindi le regole nel CLAUDE.md di una sottodirectory si applicano solo ai file in quel percorso.
REVIEW.md
Aggiungi un file REVIEW.md alla radice del tuo repository per le regole specifiche della revisione. Usalo per codificare:
Linee guida di stile dell'azienda o del team
Convenzioni specifiche del linguaggio o del framework non coperte dai linter
Cose che Claude dovrebbe sempre segnalare (ad esempio, "qualsiasi nuova rotta API deve avere un test di integrazione")
Cose che Claude dovrebbe saltare (ad esempio, "non commentare il codice generato")
Claude scopre automaticamente REVIEW.md alla radice del repository. Non è necessaria alcuna configurazione.
Prezzi e utilizzo
Code Review viene fatturato in base all'utilizzo dei token. Ogni revisione costa in media $15–25, scalando con la dimensione della PR, la complessità della base di codice e quanti problemi richiedono verifica.
L'utilizzo di Code Review viene fatturato separatamente tramite utilizzo aggiuntivo e non conta rispetto all'utilizzo incluso nel tuo piano. Il trigger di revisione che scegli influisce sul costo totale:
Una volta dopo la creazione della PR viene eseguito una volta per PR.
Dopo ogni push viene eseguito ad ogni push, moltiplicando il costo per il numero di push.
Manuale non comporta costi fino a quando qualcuno commenta "@claude review". Dopo quel commento, i push aggiuntivi alla PR attivano automaticamente le revisioni.
I costi vengono visualizzati sulla tua fattura Anthropic indipendentemente dal fatto che la tua organizzazione utilizzi AWS Bedrock o Google Vertex AI per altre funzioni di Claude Code.
Per impostare un limite di spesa mensile, vai a Impostazioni organizzazione > Utilizzo e configura il limite per il servizio Claude Code Review.
Monitora la spesa tramite il grafico dei costi settimanali nel dashboard di analisi o la colonna del costo medio per repo nelle impostazioni di amministrazione.
Visualizza utilizzo
Vai al dashboard di analisi di Code Review per vedere l'attività in tutta l'organizzazione. Il dashboard mostra:
PR revisionate: Conteggio giornaliero delle richieste pull revisionate nell'intervallo di tempo selezionato.
Costo settimanale: Spesa settimanale per Code Review.
Feedback: Conteggio dei commenti di revisione che sono stati risolti automaticamente perché qualcuno ha affrontato il problema.
Suddivisione per repository: Conteggi per repo di PR revisionate e commenti risolti.
Risoluzione dei problemi
I repository non vengono visualizzati dopo l'installazione di GitHub App
Se hai installato Claude GitHub App ma i tuoi repository non vengono visualizzati nel pannello di amministrazione:
Conferma che Claude GitHub App ha accesso ai repository che ti aspetti. Vai alle impostazioni della tua organizzazione GitHub, trova Claude GitHub App in GitHub App installate, e verifica se ha accesso a tutti i repository o solo a quelli selezionati.
Se la tua organizzazione utilizza GitHub Enterprise Cloud con Enterprise Managed Users (EMU), assicurati che Claude GitHub OAuth App sia autorizzata a livello aziendale. Le aziende EMU possono limitare quali app OAuth sono approvate e l'app Claude deve essere esplicitamente consentita.
Prova a disconnettere e riconnettere l'integrazione GitHub. Vai a Impostazioni organizzazione > Claude Code, rimuovi la configurazione del repository e ripeti la configurazione.
Se il problema persiste, contatta il nostro team di supporto con il nome della tua organizzazione e il nome della tua organizzazione GitHub in modo che possiamo indagare.
Code Review non si avvia su una nuova PR
Se nessuna esecuzione di controllo viene visualizzata dopo l'apertura di una PR:
Conferma che il repository sia elencato e abilitato nelle impostazioni di amministrazione.
Controlla l'impostazione del trigger di revisione. Se è impostato su Manuale, dovrai commentare "@claude review" sulla PR per avviare una revisione.
Assicurati che la PR non sia una bozza. Code Review non viene eseguito su PR in bozza.
Verifica che Claude GitHub App abbia ancora accesso al repository nelle impostazioni della tua organizzazione GitHub.
GitHub Enterprise Cloud con restrizioni IP
Se la tua organizzazione GitHub Enterprise Cloud limita l'accesso per indirizzo IP, Claude GitHub App potrebbe non essere in grado di accedere ai tuoi repository. Per risolvere questo problema, abilita l'ereditarietà della lista di indirizzi IP consentiti per le GitHub App installate nelle impostazioni dell'azienda GitHub. Claude GitHub App registra i suoi intervalli IP, quindi l'abilitazione di questa impostazione consente l'accesso senza configurazione manuale. Per aggiungere gli intervalli alla tua lista di indirizzi consentiti manualmente invece, o per configurare altri firewall, vedi Indirizzi IP dell'API Anthropic.
GitHub Enterprise Server (self-hosted)
Code Review attualmente richiede repository ospitati su github.com, quindi GitHub Enterprise Server self-hosted non è ancora supportato.
Domande frequenti
Code Review è disponibile come capacità quando si crea un ruolo personalizzato?
No, Code Review non è disponibile per essere aggiunto a un ruolo personalizzato al momento.
Risorse correlate
Plugin — Sfoglia il marketplace dei plugin, incluso un plugin di revisione del codice per eseguire revisioni on-demand localmente prima di eseguire il push.
GitHub Actions — Esegui Claude nei tuoi flussi di lavoro GitHub Actions per l'automazione personalizzata oltre Code Review.
GitLab CI/CD — Integrazione Claude self-hosted per pipeline GitLab.