Solucionar problemas do Code Review

Corrija um Code Review que não foi iniciado, falhou ou foi ignorado por causa do orçamento, encontre achados ausentes e resolva problemas de configuração e de REVIEW.md.

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. Em um pull request de um fork, a permissão que conta é a do repositório base. A menos que o pull request seja seu, o Claude pode responder com uma dica: "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 em seu lugar.
• 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

Estas são quatro das mensagens que uma check run pode conter sobre REVIEW.md:

• "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.
• "they link to a file this pull request modifies, or carry more links than the review checks": a revisão ignorou o REVIEW.md raiz, ou o número de arquivos REVIEW.md de subdiretórios indicado na mensagem. Verifique o arquivo ignorado para cada causa. Para o REVIEW.md raiz, verifique também os arquivos que ele inclui:
  • Links demais: ele contém mais de 64 links Markdown. Reduza os links para 64 ou menos.
  • Um link que a revisão não consegue analisar: ele tem um link Markdown malformado. Corrija ou remova o link.
  • Um link para um arquivo alterado: ele aponta para um arquivo ou pasta que este pull request altera, e a revisão não conseguiu deixar de fora apenas as linhas com esse link. Escreva a regra no próprio REVIEW.md.
• "include line(s) in the root REVIEW.md were skipped on this review": o seu REVIEW.md raiz foi aplicado, mas os arquivos indicados por essas linhas não foram. Verifique as listas em Incluir outros arquivos no REVIEW.md e, no caso de uma skill, em Incluir um arquivo de skill.

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.

Recursos relacionados

• Ler e solicitar revisões em um pull request: o que significam os achados e a check run, e os comandos em comentários
• Configurar o Code Review: para Owners, ativar o Code Review e gerenciar repositórios
• Custos e uso do Code Review: os limites de gastos por trás de uma mensagem de orçamento
• Personalizar o Code Review: qual cópia do REVIEW.md uma revisão lê