Skip to main content
Quando o Code Review não faz o que você espera em um pull request, comece pela check run Claude Code Review. O título dela informa até onde a revisão chegou.

​
Verifique até onde a revisão chegou

Encontre a check run Claude Code Review no seu pull request e, em seguida, compare o título dela com um destes mais comuns:

​
Uma revisão não foi iniciada

Verifique estes casos quando nenhuma check run Claude Code Review aparecer, ou quando o Claude publicar um comentário dizendo que a revisão foi ignorada.

​
Um comando em comentário não iniciou uma revisão

Depois de comentar @claude review, procure no pull request uma check run Claude Code Review com o título Code review queued… ou Code review in progress…. Uma reação 👀 no seu comentário não confirma que uma revisão está a caminho. Se nenhuma check run aparecer, verifique cada uma destas causas:
  • O Code Review não está ativado para este repositório: o Claude não publica nenhum comentário nem check run em resposta ao comando. Peça a um Owner para adicionar o repositório.
  • O comentário não atende a uma condição: era um comentário inline ou o corpo de uma revisão, em vez de um novo comentário de nível superior, ou o comando não estava no início do comentário. Editar um comentário anterior em vez de publicar um novo também não conta, e o pull request precisa estar aberto. Consulte as condições para comandos em comentários e publique um novo comentário que as atenda.
  • Você não tem acesso de escrita: você precisa da permissão write, maintain ou admin no repositório e, em um pull request de um fork, a permissão que conta é a do repositório base. Se a sua organização tiver as dicas ativadas, o Claude responde “No review was started: manual reviews can only be requested by someone with write access to this repository.” Peça a alguém com acesso de escrita para comentar.
  • O orçamento acabou: o Claude publica um comentário que começa com “⚠️ Code review skipped”. Consulte A revisão não foi executada e o PR mostra uma mensagem de orçamento.

​
A revisão não foi executada e o PR mostra uma mensagem de orçamento

Quando o orçamento da sua organização não consegue cobrir uma revisão, o Code Review ignora a revisão e o Claude publica no pull request um comentário que começa com “⚠️ Code review skipped”. Em alguns desses casos, também aparece uma check run com o título Code review declined. O comentário inclui um link para claude.ai/admin-settings/usage, onde um administrador restaura o orçamento. O texto dele informa qual limite foi atingido:
  • “has reached its monthly code review spending cap”: o limite mensal de gastos do Code Review foi atingido. As revisões são retomadas no início do próximo período de faturamento. Para obtê-las antes, peça a um administrador para aumentar o limite.
  • “has no extra usage available to pay for this review”: o saldo de créditos de uso da sua organização está vazio, ou o limite mensal geral de gastos dela foi atingido. Peça a um administrador para adicionar créditos de uso ou aumentar esse limite.
  • “is too low to start another review”: o que resta do orçamento ou do saldo é menor que o custo esperado de uma revisão. Peça a um administrador para aumentar o limite ou adicionar créditos de uso.
Depois que o orçamento for restaurado, comente @claude review no pull request para obter a revisão que foi ignorada. As condições para comandos em comentários se aplicam, portanto quem comenta precisa de acesso de escrita.

​
Dispare novamente uma revisão que falhou ou expirou

Se o resumo da check run disser “The review session was interrupted before it could finish. A new review of this commit has been queued automatically.”, você não precisa fazer nada. Essa revisão é repetida automaticamente uma vez. Caso contrário, quando o título da check run for Code review failed ou Code review timed out, execute a revisão novamente com um comentário ou uma nova execução:
  • Comente @claude review: publique-o como um comentário de nível superior no pull request. Isso inicia uma nova revisão sem inscrever o pull request em pushes futuros.
  • Clique em Re-run: se o pull request não for de um fork, clique em Re-run na verificação Claude Code Review na aba Checks do GitHub. A nova execução abrange o commit de head atual do pull request e também não inscreve o pull request.

​
Encontre problemas que não aparecem como comentários inline

Se o título da check run informar que foram encontrados problemas, mas você não vê comentários de revisão inline no diff, procure nestes outros locais onde os achados são exibidos:
  • Details da check run: clique em Details ao lado da verificação Claude Code Review na aba Checks. A tabela de gravidade lista os achados com arquivo, linha e resumo, independentemente de o comentário inline ter sido aceito.
  • Anotações em Files changed: abra a aba Files changed no PR. Um achado que tem uma linha, mas não foi publicado como comentário inline, aparece ali como uma anotação nas linhas em questão.
  • Corpo da revisão: achados que não têm localização inline, ou que ficam fora do diff atual, aparecem sob o título Additional findings no corpo da revisão.

​
A check run menciona REVIEW.md

Duas das mensagens que uma check run pode conter sobre REVIEW.md dizem respeito à proteção de branch:
  • “This review applied the repository’s review instructions (REVIEW.md) from its default branch, which is not protected against direct pushes.”: a revisão leu apenas o arquivo raiz. Consulte De qual branch o REVIEW.md é lido para saber o que muda ao proteger o branch.
  • “were not applied to this review: branch protection could not be confirmed”: a revisão não leu nenhum REVIEW.md.

​
Problemas de configuração

Estes casos surgem para um Owner durante a configuração do Code Review.

​
Um repositório não aparece em Add a repository

Primeiro, pesquise o repositório pelo nome, pois a caixa de diálogo não carrega uma lista longa por completo. A caixa de diálogo lista um repositório somente se o Claude GitHub App puder acessá-lo. Clique em Install GitHub App e dê ao app acesso ao repositório. Quando nenhum repositório estiver listado, Install GitHub App é um botão na caixa de diálogo. Caso contrário, ele fica na parte inferior do menu de filtro de organização do GitHub da caixa de diálogo.

​
Nenhuma check run aparece no pull request de teste

Confirme que Allow code review está ativado, que o repositório está listado em Repositories na seção Code review e que o Claude GitHub App tem acesso a ele. As revisões automáticas ignoram pull requests em rascunho, e um repositório configurado como Manual (@claude review) precisa de um comentário @claude review para iniciar a primeira revisão.