Skip to main content
Quando Code Review non fa ciò che ti aspetti su una pull request, inizia dal check run Claude Code Review. Il suo titolo indica fin dove è arrivata la revisione.

​
Verifica fin dove è arrivata la revisione

Trova il check run Claude Code Review sulla tua pull request, quindi confronta il suo titolo con uno di questi titoli comuni:

​
Una revisione non è partita

Verifica questi casi quando non compare alcun check run Claude Code Review, o quando Claude pubblica un commento che indica che la revisione è stata saltata.

​
Un comando nei commenti non ha avviato una revisione

Dopo aver commentato @claude review, cerca sulla pull request un check run Claude Code Review intitolato Code review queued… o Code review in progress…. Una reazione 👀 sul tuo commento non conferma che una revisione sia in arrivo. Se non compare alcun check run, verifica ciascuna di queste cause:
  • Code Review non è attivo per questo repository: Claude non pubblica alcun commento né alcun check run in risposta al comando. Chiedi a un Owner di aggiungere il repository.
  • Il commento non soddisfa una condizione: era un commento inline o il corpo di una revisione anziché un nuovo commento di primo livello, oppure il comando non si trovava all’inizio del commento. Anche modificare un commento precedente invece di pubblicarne uno nuovo non conta, e la pull request deve essere aperta. Consulta le condizioni per i comandi nei commenti e pubblica un nuovo commento che le soddisfi.
  • Non hai accesso in scrittura: ti serve il permesso write, maintain o admin sul repository e, su una pull request proveniente da un fork, il permesso che conta è quello sul repository di base. Se la tua organizzazione ha attivato i suggerimenti, Claude risponde “No review was started: manual reviews can only be requested by someone with write access to this repository.” Chiedi invece a qualcuno con accesso in scrittura di commentare.
  • Il budget è esaurito: Claude pubblica un commento che inizia con “⚠️ Code review skipped”. Consulta La revisione non è stata eseguita e la PR mostra un messaggio sul budget.

​
La revisione non è stata eseguita e la PR mostra un messaggio sul budget

Quando il budget della tua organizzazione non può coprire una revisione, Code Review salta la revisione e Claude pubblica sulla pull request un commento che inizia con “⚠️ Code review skipped”. In alcuni di questi casi compare anche un check run intitolato Code review declined. Il commento rimanda a claude.ai/admin-settings/usage, dove un amministratore ripristina il budget. La sua formulazione ti dice quale limite è stato raggiunto:
  • “has reached its monthly code review spending cap”: è stato raggiunto il limite di spesa mensile per Code Review. Le revisioni riprendono all’inizio del periodo di fatturazione successivo. Per riaverle prima, chiedi a un amministratore di aumentare il limite.
  • “has no extra usage available to pay for this review”: il saldo dei crediti di utilizzo della tua organizzazione è esaurito, oppure è stato raggiunto il suo limite di spesa mensile complessivo. Chiedi a un amministratore di aggiungere crediti di utilizzo o di aumentare quel limite.
  • “is too low to start another review”: ciò che resta del budget o del saldo è inferiore al costo previsto di una revisione. Chiedi a un amministratore di aumentare il limite o di aggiungere crediti di utilizzo.
Dopo che il budget è stato ripristinato, commenta @claude review sulla pull request per ottenere la revisione che è stata saltata. Si applicano le condizioni per i comandi nei commenti, quindi chi commenta deve avere accesso in scrittura.

​
Riavvia una revisione non riuscita o scaduta

Se il riepilogo del check run dice “The review session was interrupted before it could finish. A new review of this commit has been queued automatically.”, non devi fare nulla. Quella revisione viene ritentata automaticamente una volta. Altrimenti, quando il titolo del check run è Code review failed o Code review timed out, esegui di nuovo la revisione con un commento o con una riesecuzione:
  • Commenta @claude review: pubblicalo come commento di primo livello sulla pull request. Questo avvia una nuova revisione senza iscrivere la pull request ai push futuri.
  • Fai clic su Re-run: se la pull request non proviene da un fork, fai clic su Re-run sul check Claude Code Review nella scheda Checks di GitHub. La riesecuzione copre il commit di testa corrente della pull request e anch’essa non iscrive la pull request.

​
Trova i problemi che non vengono mostrati come commenti inline

Se il titolo del check run indica che sono stati trovati problemi ma non vedi commenti di revisione inline nel diff, cerca in queste altre posizioni in cui vengono mostrati i risultati:
  • Details del check run: fai clic su Details accanto al check Claude Code Review nella scheda Checks. La tabella della gravità elenca i risultati con il relativo file, la riga e il riepilogo, indipendentemente dal fatto che il commento inline sia stato accettato.
  • Annotazioni in Files changed: apri la scheda Files changed nella PR. Un risultato che ha una riga ma non è stato pubblicato come commento inline compare lì come annotazione sulle righe interessate.
  • Corpo della revisione: i risultati che non hanno una posizione inline, o che ricadono al di fuori del diff corrente, compaiono sotto l’intestazione Additional findings nel corpo della revisione.

​
Il check run menziona REVIEW.md

Due dei messaggi che un check run può riportare su REVIEW.md riguardano la protezione del branch:
  • “This review applied the repository’s review instructions (REVIEW.md) from its default branch, which is not protected against direct pushes.”: la revisione ha letto solo il file nella radice. Consulta Da quale branch viene letto REVIEW.md per sapere cosa cambia proteggendo il branch.
  • “were not applied to this review: branch protection could not be confirmed”: la revisione non ha letto alcun REVIEW.md.

​
Problemi di configurazione

Questi casi si presentano a un Owner durante la configurazione di Code Review.

​
Un repository non è elencato in Add a repository

Cerca prima il repository per nome, perché la finestra di dialogo non carica per intero un elenco lungo. La finestra di dialogo elenca un repository solo se la Claude GitHub App può accedervi. Fai clic su Install GitHub App e concedi all’app l’accesso al repository. Quando non è elencato alcun repository, Install GitHub App è un pulsante nella finestra di dialogo. Altrimenti, si trova in fondo al menu del filtro per organizzazione GitHub della finestra di dialogo.

​
Nessun check run compare sulla pull request di test

Conferma che Allow code review sia attivo, che il repository sia elencato sotto Repositories nella sezione Code review e che la Claude GitHub App abbia accesso a esso. Le revisioni automatiche saltano le pull request in bozza, e un repository impostato su Manual (@claude review) richiede un commento @claude review per avviare la prima revisione.