Skip to main content
In qualità di Owner della tua organizzazione Claude, attivi Code Review in Admin settings > Claude Code su claude.ai. Le revisioni vengono eseguite sull’infrastruttura di Anthropic, quindi non devi aggiungere file di workflow ai tuoi repository. Dopo la configurazione, scegli quanto sono approfondite le revisioni e quando vengono eseguite in ciascun repository. Spendi di più con un livello di revisione più alto e quando le revisioni vengono eseguite più spesso. Consulta Costi di Code Review.

Cosa ti serve per attivare Code Review

Per prima cosa verifica che la tua organizzazione abbia i requisiti per Code Review. Poi assicurati di avere questi accessi, o di avere qualcuno che li abbia:

Attivare Code Review

1

Fai clic sull'interruttore Allow code review

Vai alla sezione Code review di Admin settings > Claude Code e fai clic sull’interruttore Allow code review.Se Code Review si attiva subito senza alcuna finestra di dialogo, la tua organizzazione ha già la Claude GitHub App collegata o dei repository aggiunti. Vai a Aggiungere altri repository, poi torna qui per l’ultimo passaggio.
2

Connetti il tuo account GitHub

Se si apre una finestra di dialogo Connect GitHub, fai clic su Connect. Se la tua organizzazione usa GitHub Enterprise Server, seleziona prima la tua istanza nella finestra di dialogo. GitHub ti chiede di autorizzare Claude, poi ti riporta alla pagina di amministrazione con la finestra di dialogo Add a repository aperta.Se Add a repository si è aperta subito, il tuo account è già connesso, quindi passa al passaggio successivo.
3

Installa la Claude GitHub App

Se i repository che vuoi sono elencati nella finestra di dialogo Add a repository, o li trovi cercandoli lì, passa al passaggio successivo. La finestra di dialogo elenca un repository solo se la Claude GitHub App può accedervi, quindi se non ci sono, installa l’app:
  • Fai clic su Install GitHub App. Quando non ci sono repository elencati, è un pulsante nella finestra di dialogo. Altrimenti, si trova in fondo al menu del filtro per organizzazione GitHub della finestra di dialogo. La pagina di installazione di GitHub si apre in una nuova scheda.
  • Scegli l’organizzazione GitHub proprietaria dei repository.
  • Scegli a quali repository l’app può accedere.
  • Approva i permessi richiesti. L’insieme è più ampio di quello usato da una revisione ed è condiviso da altre funzionalità di Claude, come GitHub Actions. Consulta a cosa può accedere una revisione e l’elenco completo dei permessi.
  • Al termine dell’installazione, la scheda torna a Claude. Se mostra un pulsante Finish connecting GitHub, fai clic su di esso per collegare l’installazione alla tua organizzazione Claude.
  • Torna alla scheda della pagina di amministrazione, dove l’elenco nella finestra di dialogo si aggiorna.
4

Scegli i repository

Seleziona i repository che vuoi sottoporre a revisione, poi fai clic su Continue. Per aggiungere un repository serve l’accesso in scrittura a esso dall’account GitHub che hai connesso. Puoi aggiungere altri repository in seguito.
5

Fai clic su Finish

Segue una finestra di dialogo Code review is set up. Fai clic su Finish per attivare Code Review. Se chiudi la finestra di dialogo in qualsiasi altro modo, i tuoi repository restano aggiunti ma Allow code review resta disattivato, e lo attivi dall’interruttore.Ogni repository parte impostato per la revisione dopo ogni push, l’opzione che esegue il maggior numero di revisioni. Per eseguirne meno, stabilisci quando vengono eseguite le revisioni.
6

Verifica con una pull request di prova

Apri una pull request di prova in uno dei repository che hai aggiunto, e non contrassegnarla come bozza. Entro pochi minuti compare un check run chiamato Claude Code Review. Se hai già impostato il repository su Manual (@claude review), commenta @claude review sulla pull request per avviare la prima revisione.Se non compare alcun check run, consulta Nessun check run compare sulla pull request di prova.Una volta arrivata la revisione, invia ai tuoi sviluppatori Leggere e richiedere revisioni su una pull request, che tratta i livelli di gravità, i comandi nei commenti e come rispondere ai risultati.

Impostare i valori predefiniti per la tua organizzazione

In qualità di Owner, decidi quanto sono approfondite le revisioni e con quale frequenza vengono eseguite. Entrambe le impostazioni si trovano nella sezione Code review di Admin settings > Claude Code.

Impostare il livello di revisione predefinito

Il livello di revisione stabilisce quanto è approfondita ciascuna revisione, e una revisione più approfondita costa di più. Imposti un valore predefinito per l’organizzazione e puoi sovrascriverlo per singoli repository.
  • Predefinito dell’organizzazione: seleziona un livello in Review level e conferma con Change level. Ogni repository lo usa, a meno che tu non assegni a quel repository un livello proprio.
  • Un singolo repository: fai clic su Edit nella riga del repository, poi seleziona un Review level lì. La prima opzione, Default, segue l’organizzazione. Il livello viene salvato non appena lo selezioni.
Un nuovo livello si applica alle revisioni che iniziano dopo la modifica. Per gli altri fattori che determinano il costo di ciascuna revisione, consulta Costi e utilizzo di Code Review.

Stabilire quando vengono eseguite le revisioni

Ogni repository ha la propria impostazione Review runs, che decide quando le sue pull request vengono sottoposte a revisione.
  • Once after PR creation: una revisione viene eseguita quando una pull request viene aperta, riaperta o contrassegnata come pronta per la revisione
  • After every push: una revisione viene eseguita ai push sul branch della pull request, individuando nuovi problemi man mano che la pull request evolve e risolvendo automaticamente i thread quando correggi i problemi segnalati
  • Manual (@claude review): aprire una pull request o fare push su di essa non avvia una revisione. Commenta @claude review per richiederne una, oppure @claude review always per iscrivere anche la pull request alle revisioni sui push successivi.
Manual è utile per i repository con molto traffico in cui vuoi includere nella revisione specifiche pull request, oppure per iniziare a revisionare le pull request solo quando sono pronte. Per confrontare l’effetto di ciascuna opzione sulla spesa, consulta Frequenza di esecuzione delle revisioni. Per modificare l’impostazione, fai clic su Edit nella riga del repository nella tabella Repositories e seleziona un’opzione Review runs. La scelta viene salvata non appena la selezioni, e la colonna Review runs della tabella la mostra abbreviata in Once per PR, Every push o Manual.
  • Bozze e pull request da fork: qualunque opzione tu scelga, le revisioni automatiche le saltano entrambe
  • Nuovi repository: un repository che aggiungi dalla finestra di dialogo Add a repository parte da After every push. Se la sua organizzazione GitHub è coperta nel suo insieme, assume invece l’impostazione della riga di quell’organizzazione.

Attivare o disattivare i commenti di suggerimento

Un commento di suggerimento è un breve commento che Claude pubblica su una pull request quando non viene avviata alcuna revisione, indicando il motivo e cosa fare dopo. Show tips on pull requests è attivo per impostazione predefinita. Quando è attivo, Claude pubblica un suggerimento in ciascuno di questi casi, spiegando:
  • Il repository è impostato su Manual: come richiedere una revisione con un commento
  • La pull request proviene da un fork: che un maintainer può richiedere la revisione
  • Un bot, o qualcuno senza accesso in scrittura, commenta @claude review: che non è stata avviata alcuna revisione, e chi può richiederne una
  • L’organizzazione GitHub non è collegata alla tua organizzazione Claude: che le revisioni sono in pausa, e come collegarla
Disattiva l’impostazione per interrompere questi commenti.

Cosa possono modificare gli sviluppatori

Gli sviluppatori si rivolgono a te per modificare il livello di revisione, l’impostazione Review runs o quali repository ricevono revisioni. Da GitHub, senza il ruolo Owner, possono fare quanto segue:
  • Richiedere una revisione: commentare @claude review su una pull request. Serve l’accesso in scrittura al repository, e funziona su bozze e pull request da fork, che le revisioni automatiche saltano.
  • Iscrivere una pull request a una revisione a ogni push: commentare @claude review always su una pull request che non sia una bozza o proveniente da un fork, ad esempio in un repository impostato su Manual
  • Modificare ciò che le revisioni segnalano: fare il commit di file REVIEW.md e CLAUDE.md nel repository, ad esempio per aggiungere un controllo
Le revisioni richieste dagli sviluppatori vengono addebitate alla tua organizzazione. Per limitare la spesa mensile di Code Review, consulta Limitare la spesa.

Gestire i repository

Puoi aggiungere i repository uno alla volta o coprire un’intera organizzazione GitHub in una volta sola, e interrompere le revisioni ovunque non le desideri.

Aggiungere altri repository

Per aggiungere repository dopo la configurazione, fai clic su Add sopra la tabella Repositories nella sezione Code review. Si apre la finestra di dialogo Add a repository. Seleziona i repository e fai clic su Continue.

Coprire un’intera organizzazione GitHub

Per attivare Code Review per ogni repository di un’organizzazione GitHub, imposta Review runs nella riga dell’organizzazione nella tabella Repositories. In questo modo copri ogni repository di quell’organizzazione a cui la Claude GitHub App può accedere, inclusi i repository aggiunti in seguito. Questo può aumentare notevolmente la spesa. Richiede tutti questi requisiti:
  • L’account GitHub che hai connesso a Claude è un owner di quell’organizzazione GitHub.
  • L’organizzazione si trova su github.com. Le istanze di GitHub Enterprise Server e gli account GitHub personali non sono idonei.
  • È impostato un limite di spesa mensile, per la tua organizzazione Claude o per Code Review.
Per coprire l’organizzazione, fai clic su Edit nella sua riga, seleziona un’opzione Review runs e conferma. Le opzioni sono le tre di Stabilire quando vengono eseguite le revisioni più Off. Dopo la conferma, entrano in vigore queste modifiche:
  • Copertura: ogni repository viene coperto a partire dalla sua prossima pull request. Se la Claude GitHub App è stata installata su repository selezionati anziché su tutti, Claude revisiona quei repository; modifica l’accesso ai repository dell’app su GitHub per coprire i restanti.
  • Impostazioni esistenti: ogni repository di quell’organizzazione GitHub assume l’opzione che selezioni, inclusi i repository che avevi impostato singolarmente. Impostare di nuovo la riga ha lo stesso effetto. I repository che hai disattivato nelle loro righe restano disattivati.
  • Modifiche individuali successive: un repository che in seguito imposti in modo diverso dalla sua organizzazione viene contrassegnato come Custom nella tabella.
  • Livello di revisione: la riga di un’organizzazione non ha un livello di revisione proprio.

Disattivare Code Review o rimuovere un repository

Nella sezione Code review di Admin settings > Claude Code, scegli il controllo corrispondente a ciò che vuoi interrompere:
  • Un repository, mantenendolo nell’elenco: fai clic su Edit nella sua riga e disattiva Code review. La tabella mostra il repository come Off.
  • Un repository, rimuovendolo: fai clic su Edit nella sua riga, poi su Remove repository in fondo alla finestra di dialogo. Le revisioni si interrompono lì, e un’altra organizzazione Claude potrà poi configurare quel repository. Finché l’organizzazione GitHub del repository è coperta nel suo insieme, non puoi rimuoverlo; disattiva invece il suo interruttore Code review.
  • Un’intera organizzazione GitHub: fai clic su Edit nella riga dell’organizzazione e seleziona Off. Questo disattiva anche i repository di quell’organizzazione che hai aggiunto uno alla volta.
  • Tutto: disattiva Allow code review. Nessuna nuova revisione viene avviata in alcun repository, e il tuo elenco di repository resta, così puoi riattivarlo in seguito.