Skip to main content
O Code Review é um serviço gerenciado que um Owner da sua organização Claude ativa para um conjunto de repositórios do GitHub. Depois de ativado, o Claude revisa os pull requests nesses repositórios e publica suas descobertas como comentários inline, um resumo no corpo da revisão e um check run chamado Claude Code Review. Uma revisão nunca aprova nem bloqueia o seu pull request, e o check run nunca é concluído como falha. Um Owner controla quando as revisões são executadas e quão minuciosas elas são para cada repositório.
Se o seu plano não inclui o Code Review, você ainda pode pedir ao Claude que revise o seu branch a partir de uma sessão do Claude Code: consulte Revisar localmente com /code-review.

​
Níveis de severidade

O Claude publica cada descoberta como um comentário inline nas linhas em questão e a marca com um de três níveis de severidade: Quando a revisão registrou seu raciocínio, a descoberta tem uma seção recolhida Why this was flagged. Expanda-a para ler por que o Claude sinalizou o problema e como ele verificou o problema. Para alterar o que o Claude sinaliza no seu repositório ou como ele classifica a severidade, consulte Personalizar o Code Review.

​
Responder às descobertas

Você pode mesclar sem responder a uma descoberta, a menos que as regras do seu próprio repositório exijam isso. Se a proteção de branch dele exigir a resolução de conversas, resolva a thread de cada descoberta antes de mesclar. Para eliminar uma descoberta, resolva a thread dela ou envie uma correção.
  • Descartá-la sem alterar o código: resolva a thread você mesmo no GitHub. Apenas responder não descarta uma descoberta.
  • Corrigir o problema: altere o código e faça push. A próxima revisão do pull request resolve a thread anterior quando considera o problema corrigido, seja essa revisão executada automaticamente no seu push ou solicitada por você.
  • Explicar ou discordar: responda ao comentário. O Claude não responde imediatamente, e uma resposta não inicia uma revisão. A próxima revisão do pull request lê as respostas às descobertas anteriores e pode resolver a thread ou publicar uma resposta de acompanhamento. Se o mesmo tipo de descoberta continuar voltando, peça a um mantenedor que adicione uma regra ao REVIEW.md.
Para obter essa próxima revisão sem fazer push, comente @claude review como um comentário de nível superior no pull request.

​
Saída do check run

O link Details no check run Claude Code Review abre as descobertas em uma tabela ordenada por severidade, incluindo qualquer descoberta cujo comentário inline o GitHub não aceitou: Uma descoberta que tem uma linha, mas não foi publicada como comentário inline, aparece como uma anotação na aba Files changed, nas linhas em questão. Descobertas Important aparecem em vermelho, nits em amarelo e bugs pré-existentes em cinza. O check run é concluído como neutro, ou como ignorado quando uma revisão automática não foi executada porque um push não alterou nenhum arquivo. Ele nunca é concluído como falha, portanto uma revisão finalizada não faz uma verificação obrigatória falhar. Se você não vir descobertas ou se uma revisão não foi executada, consulte Solucionar problemas do Code Review.

​
Ler o resultado a partir de um script

Para condicionar um merge ou publicar um resumo a partir do seu próprio CI, analise a última linha do texto de Details com gh e jq. Essa linha é um comentário legível por máquina.
1

Encontrar o ID do check run

No seu shell, liste os check runs do commit e pegue o id da execução Claude Code Review. Substitua OWNER e REPO pelo proprietário e nome do seu repositório, e <commit-sha> pelo commit head do pull request:
2

Ler as contagens de severidade

Leia as contagens desse check run, substituindo CHECK_RUN_ID pelo ID:
Isso imprime um objeto JSON com uma contagem por severidade e suas chaves em ordem alfabética, por exemplo {"nit": 1, "normal": 2, "pre_existing": 0}. As contagens incluem descobertas de revisões anteriores do pull request cujas threads ainda estão abertas.
3

Agir com base no resultado

Faça o seu script tratar estes casos:
  • normal é maior que zero: faça o job falhar se quiser condicionar o merge. A chave normal contém a contagem de descobertas Important, então o Claude encontrou pelo menos um bug que vale a pena corrigir antes do merge.
  • A linha está ausente: trate isso como ausência de veredito, e não como zero descobertas. Um check run de uma revisão que falhou, excedeu o tempo limite, foi cancelada ou foi substituída por uma mais recente não tem essa linha, e algumas revisões concluídas também não a têm.

​
Solicitar uma revisão

Se o seu pull request for um rascunho ou vier de um fork, as revisões automáticas o ignoram, então solicite a revisão com um comando de comentário. Para obter uma revisão no seu pull request, faça uma destas ações:
  • Abri-lo ou marcá-lo como pronto: em um repositório configurado como Once after PR creation ou After every push, uma revisão é iniciada quando você abre ou reabre o pull request, ou marca um rascunho como pronto para revisão.
  • Comentar um comando: publique @claude review no pull request.
  • Fazer push de um commit: um push inicia uma revisão em um repositório configurado como After every push, ou em um pull request que você assinou com @claude review always.
  • Clicar em Re-run: depois que uma revisão falha ou excede o tempo limite em um pull request que não vem de um fork, execute-a novamente a partir do check run.
  • Aguardar a nova tentativa automática: uma revisão cuja sessão foi interrompida é tentada novamente uma vez de forma automática. O resumo do check run informa quando isso está acontecendo.

​
Comandos de comentário

Publique um destes comandos como comentário no pull request: Para que qualquer um desses comandos inicie uma revisão, todas estas condições precisam ser atendidas:
  • Publique-o como um novo comentário de nível superior no pull request, e não como um comentário inline em uma linha do diff nem como o corpo de uma revisão. Editar um comentário anterior não conta.
  • Coloque o comando no início do comentário, com always na mesma linha que o restante do comando. Maiúsculas e minúsculas não importam.
  • Você precisa de permissão de escrita, manutenção ou administrador no repositório. O Claude verifica isso com o GitHub para cada pessoa que comenta, e comentários de bots não iniciam revisões.
  • O pull request precisa estar aberto.
Quando o comando é aceito, um check run Claude Code Review aparece no pull request com o título Code review queued…. O título muda para Code review in progress… quando a revisão começa. O Claude também pode reagir ao seu comentário com 👀, mas essa reação pode aparecer quando nenhuma revisão é iniciada, então procure o check run em vez disso. Se uma revisão já estiver em execução no commit mais recente do pull request, uma nova solicitação não inicia uma segunda.
Antes de uma atualização de julho de 2026, @claude review assinava o PR para revisões acionadas por push. Se você dependia desse comportamento, comente @claude review always em vez disso.

​
O que uma revisão posterior abrange

Uma revisão posterior que começa por conta própria, como após um push, concentra-se no que mudou desde a última revisão e publica menos nits e descobertas pré-existentes. O resumo dela contabiliza o que foi deixado de fora, em uma linha que termina com “found and not posted” ou “outside the scope of this re-review and not posted.” Para obter uma revisão que não deixe nenhuma dessas de fora, comente @claude review. Ela abrange todo o pull request novamente.

​
Revisar rascunhos e pull requests de forks

As revisões automáticas ignoram ambos, então solicite a revisão com um comando de comentário:
  • Pull requests em rascunho: um comando de comentário é executado em um rascunho, então você pode solicitar uma revisão antes de marcar o pull request como pronto. Pushes em um rascunho não iniciam revisões, mesmo após @claude review always. A assinatura entra em vigor quando você marca o pull request como pronto.
  • Pull requests de forks: o Claude não revisa automaticamente um pull request de um fork, independentemente da configuração Review runs do repositório. Para iniciar uma revisão, comente @claude review no pull request. As condições para comandos de comentário continuam se aplicando, e o acesso de escrita necessário é ao repositório base, não ao fork.
Em um pull request de um fork, @claude review always também funciona, mas não assina o pull request para revisões em pushes posteriores. Clicar em Re-run no check run não inicia uma revisão nesse caso.

​
Usar o Code Review junto com o Claude Code GitHub Action

Se o repositório também executa o Claude Code GitHub Action no modo interativo com sua frase de acionamento padrão @claude, um comentário @claude review também inicia o Action. Para manter os dois separados, defina a entrada trigger_phrase do Action com uma frase diferente.