Vai al contenuto principale
Code Review è in anteprima di ricerca, disponibile per gli abbonamenti Teams e Enterprise. Non è disponibile per le organizzazioni con Zero Data Retention abilitato.
Code Review analizza i tuoi pull request su 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 dell’intero codebase, cercando errori logici, vulnerabilità di sicurezza, edge case interrotti e regressioni sottili. I risultati sono contrassegnati per gravità e non approvano o bloccano il tuo PR, quindi i flussi di lavoro di revisione esistenti rimangono intatti. Puoi regolare cosa Claude segnala aggiungendo un file CLAUDE.md o REVIEW.md al tuo repository. Per eseguire Claude nella tua infrastruttura CI invece di questo servizio gestito, vedi GitHub Actions o GitLab CI/CD. Questa pagina copre:

Come funzionano le revisioni

Una volta che un amministratore abilita Code Review per la tua organizzazione, le revisioni si attivano quando un PR si apre, ad ogni push, o quando richiesto manualmente, a seconda del comportamento configurato del repository. Commentando @claude review avvia le revisioni su un PR in qualsiasi modalità. Quando una revisione viene eseguita, più agenti analizzano il diff e il codice circostante in parallelo sull’infrastruttura Anthropic. Ogni agente cerca una classe diversa di problema, quindi un passaggio di verifica controlla i candidati 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 sul PR. Le revisioni si scalano in costo con la dimensione e la complessità del PR, completandosi in media in 20 minuti. Gli amministratori possono monitorare l’attività di revisione e la spesa tramite il dashboard di analisi.

Livelli di gravità

Ogni risultato è contrassegnato con un livello di gravità:
MarcatoreGravitàSignificato
🔴NormaleUn bug che dovrebbe essere corretto prima del merge
🟡NitUn problema minore, vale la pena correggerlo ma non bloccante
🟣Pre-esistenteUn bug che esiste nel codebase ma non è stato introdotto da questo PR
I risultati includono una sezione di ragionamento esteso comprimibile che puoi espandere per capire 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.

Configura Code Review

Un amministratore abilita Code Review una volta per l’organizzazione e seleziona quali repository includere.
1

Apri le impostazioni di amministrazione di Claude Code

Vai a claude.ai/admin-settings/claude-code e trova la sezione Code Review. Hai bisogno dell’accesso amministratore alla tua organizzazione Claude e del permesso di installare GitHub App nella tua organizzazione GitHub.
2

Avvia la configurazione

Fai clic su Setup. Questo inizia il flusso di installazione dell’app GitHub.
3

Installa l'app GitHub di Claude

Segui i prompt per installare l’app GitHub di Claude nella tua organizzazione GitHub. L’app richiede questi permessi del repository:
  • Contents: lettura e scrittura
  • Issues: lettura e scrittura
  • Pull requests: lettura e scrittura
Code Review utilizza l’accesso in lettura ai contenuti e l’accesso in scrittura ai pull request. L’insieme di permessi più ampio supporta anche GitHub Actions se lo abiliti in seguito.
4

Seleziona i repository

Scegli quali repository abilitare per Code Review. Se non vedi un repository, assicurati di aver dato all’app GitHub di Claude l’accesso durante l’installazione. Puoi aggiungere altri repository in seguito.
5

Imposta i trigger di revisione per repository

Dopo il completamento della configurazione, la sezione Code Review mostra i tuoi repository in una tabella. Per ogni repository, utilizza il dropdown Review Behavior per scegliere quando vengono eseguite le revisioni:
  • Once after PR creation: la revisione viene eseguita una volta quando un PR viene aperto o contrassegnato come pronto per la revisione
  • After every push: la revisione viene eseguita ad ogni push al ramo PR, catturando nuovi problemi mentre il PR si evolve e risolvendo automaticamente i thread quando correggi i problemi segnalati
  • Manual: le revisioni iniziano solo quando qualcuno commenta @claude review su un PR; i push successivi a quel PR vengono quindi revisionati automaticamente
La revisione ad ogni push esegue il maggior numero di revisioni e costa di più. La modalità manuale è utile per i repository ad alto traffico dove vuoi optare per PR specifici nella revisione, o per iniziare a revisionare i tuoi PR solo quando sono pronti.
La tabella dei repository mostra anche il costo medio per revisione per ogni repository in base all’attività recente. Utilizza il menu delle azioni della riga per attivare o disattivare Code Review per repository, o per rimuovere completamente un repository. Per verificare la configurazione, apri un PR di test. Se hai scelto un trigger automatico, un check run denominato Claude Code Review appare entro pochi minuti. Se hai scelto Manual, commenta @claude review sul PR per avviare la prima revisione. Se non appare alcun check run, conferma che il repository è elencato nelle tue impostazioni di amministrazione e che l’app GitHub di Claude ha accesso ad esso.

Attiva manualmente le revisioni

Commenta @claude review su un pull request per avviare una revisione e optare quel PR nelle revisioni attivate da push da quel momento in poi. Questo funziona indipendentemente dal trigger configurato del repository: usalo per optare per PR specifici nella revisione in modalità Manual, o per ottenere una re-revisione immediata in altre modalità. In ogni caso, i push a quel PR attivano le revisioni da quel momento in poi. Affinché il commento attivi una revisione:
  • Postalo come commento PR di primo livello, non come commento inline su una riga diff
  • Metti @claude review all’inizio del commento
  • Devi avere accesso come proprietario, membro o collaboratore al repository
  • Il PR deve essere aperto e non una bozza
Se una revisione è già in esecuzione su quel PR, la richiesta viene messa in coda fino al completamento della revisione in corso. Puoi monitorare l’avanzamento tramite il check run sul PR.

Personalizza le revisioni

Code Review legge due file dal tuo repository per guidare cosa segnala. Entrambi sono additivi oltre ai controlli di correttezza predefiniti:
  • CLAUDE.md: istruzioni di progetto condivise che Claude Code utilizza per tutti i compiti, non solo le revisioni. Usalo quando la guida si applica anche alle sessioni interattive di Claude Code.
  • REVIEW.md: guida solo per la revisione, letta esclusivamente durante le revisioni del codice. Usalo per regole che riguardano strettamente cosa segnalare o saltare durante la revisione e che ingombrerebbero il tuo CLAUDE.md generale.

CLAUDE.md

Code Review legge i file CLAUDE.md del tuo repository e tratta le violazioni appena introdotte come risultati a livello di nit. Questo funziona bidirezionalmente: se il tuo PR cambia il codice in un modo che rende una dichiarazione CLAUDE.md obsoleta, Claude segnala che i documenti devono essere aggiornati anche loro. 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 sotto quel percorso. Vedi la documentazione della memoria per ulteriori informazioni su come funziona CLAUDE.md. Per una guida specifica della revisione che non vuoi applicata alle sessioni generali di Claude Code, usa REVIEW.md invece.

REVIEW.md

Aggiungi un file REVIEW.md alla radice del tuo repository per regole specifiche della revisione. Usalo per codificare:
  • Linee guida di stile aziendali o di team: “preferisci i ritorni anticipati ai condizionali annidati”
  • Convenzioni specifiche del linguaggio o del framework non coperte dai linter
  • Cose che Claude dovrebbe sempre segnalare: “qualsiasi nuova rotta API deve avere un test di integrazione”
  • Cose che Claude dovrebbe saltare: “non commentare la formattazione nel codice generato sotto /gen/
Esempio di REVIEW.md:
# Linee guida per la revisione del codice

## Controlla sempre
- I nuovi endpoint API hanno test di integrazione corrispondenti
- Le migrazioni del database sono retrocompatibili
- I messaggi di errore non perdono dettagli interni agli utenti

## Stile
- Preferisci le istruzioni `match` ai controlli `isinstance` concatenati
- Usa la registrazione strutturata, non l'interpolazione di stringhe f nelle chiamate di log

## Salta
- File generati sotto `src/gen/`
- Modifiche solo di formattazione nei file `*.lock`
Claude scopre automaticamente REVIEW.md alla radice del repository. Nessuna configurazione necessaria.

Visualizza l’utilizzo

Vai a claude.ai/analytics/code-review per vedere l’attività di Code Review in tutta la tua organizzazione. Il dashboard mostra:
SezioneCosa mostra
PRs reviewedConteggio giornaliero dei pull request revisionati nell’intervallo di tempo selezionato
Cost weeklySpesa settimanale su Code Review
FeedbackConteggio dei commenti di revisione che sono stati risolti automaticamente perché uno sviluppatore ha affrontato il problema
Repository breakdownConteggi per repository dei PR revisionati e dei commenti risolti
La tabella dei repository nelle impostazioni di amministrazione mostra anche il costo medio per revisione per ogni repository.

Prezzi

Code Review viene fatturato in base all’utilizzo dei token. Le revisioni costano in media $15-25, scalando con la dimensione del PR, la complessità del codebase e quanti problemi richiedono verifica. L’utilizzo di Code Review viene fatturato separatamente tramite extra usage e non conta rispetto all’utilizzo incluso nel tuo piano. Il trigger di revisione che scegli influisce sul costo totale:
  • Once after PR creation: viene eseguito una volta per PR
  • After every push: viene eseguito ad ogni push, moltiplicando il costo per il numero di push
  • Manual: nessuna revisione fino a quando qualcuno non commenta @claude review su un PR
In qualsiasi modalità, commentando @claude review opta il PR nelle revisioni attivate da push, quindi il costo aggiuntivo si accumula per push dopo quel commento. I costi appaiono sulla tua fattura Anthropic indipendentemente dal fatto che la tua organizzazione utilizzi AWS Bedrock o Google Vertex AI per altre funzionalità di Claude Code. Per impostare un limite di spesa mensile per Code Review, vai a claude.ai/admin-settings/usage e configura il limite per il servizio Claude Code Review. Monitora la spesa tramite il grafico dei costi settimanali in analytics o la colonna del costo medio per repository nelle impostazioni di amministrazione.

Risorse correlate

Code Review è progettato per funzionare insieme al resto di Claude Code. Se vuoi eseguire revisioni localmente prima di aprire un PR, hai bisogno di una configurazione self-hosted, o vuoi approfondire come CLAUDE.md modella il comportamento di Claude in tutti gli strumenti, queste pagine sono buoni prossimi passi:
  • Plugins: sfoglia il marketplace dei plugin, incluso un plugin code-review per eseguire revisioni on-demand localmente prima di fare push
  • GitHub Actions: esegui Claude nei tuoi flussi di lavoro GitHub Actions per l’automazione personalizzata oltre la revisione del codice
  • GitLab CI/CD: integrazione Claude self-hosted per le pipeline GitLab
  • Memory: come funzionano i file CLAUDE.md in Claude Code
  • Analytics: traccia l’utilizzo di Claude Code oltre la revisione del codice