Code Review analisa seus pull requests do GitHub e publica descobertas como comentários inline nas linhas de código onde encontrou problemas. Uma frota de agentes especializados examina as alterações de código no contexto de sua base de código completa, procurando erros de lógica, vulnerabilidades de segurança, casos extremos quebrados e regressões.
Este artigo aborda como ativar Code Review, configurar gatilhos de revisão, personalizar o que é sinalizado e solucionar problemas comuns de configuração.
Nota: Code Review está em visualização de pesquisa e disponível em planos Team e Enterprise. Não está disponível para organizações com retenção de dados zero ativada. O uso de Code Review é cobrado separadamente através de créditos de uso e não conta contra o uso incluído do seu plano.
Como Code Review funciona
Depois que uma organização ativa Code Review, ele pode ser acionado automaticamente quando um pull request é aberto, em cada push ou apenas quando alguém solicita manualmente uma revisão. Quando uma revisão é executada, vários agentes analisam o diff e o código circundante em paralelo. Cada agente procura por uma classe diferente de problema, e uma etapa de verificação verifica os resultados em relação ao comportamento real do código para filtrar falsos positivos.
As descobertas são desduplicadas, classificadas por severidade e publicadas como comentários inline nas linhas específicas onde os problemas foram encontrados. Se nenhum problema for encontrado, Claude publica um breve comentário de confirmação no PR. As revisões não aprovam ou bloqueiam seu PR, portanto os fluxos de trabalho de revisão existentes permanecem intactos.
As revisões escalam em custo com o tamanho e complexidade do PR, completando em média em 20 minutos.
Níveis de severidade
Cada descoberta é marcada com um nível de severidade:
Marcador | Severidade | Significado |
🔴 | Normal | Um bug que deve ser corrigido antes de fazer merge |
🟡 | Nit | Um problema menor, vale a pena corrigir, mas não é bloqueante |
🟣 | Pré-existente | Um bug que existe na base de código, mas não foi introduzido por este PR |
As descobertas incluem uma seção de raciocínio estendido recolhível que você pode expandir para ver por que Claude sinalizou o problema e como verificou o problema.
O que Code Review verifica
Por padrão, Code Review se concentra em correção: bugs que quebrariam a produção, não preferências de formatação ou cobertura de teste ausente. Você pode expandir o que ele verifica adicionando arquivos de orientação ao seu repositório.
Configurar Code Review
As etapas abaixo cobrem a configuração para repositórios em github.com. Se seus repositórios estão em uma instância do GitHub Enterprise Server (GHES) auto-hospedada, consulte Claude Code com GitHub Enterprise Server para o guia de configuração completo.
Proprietários e Proprietários Primários de planos Team e Enterprise podem ativar Code Review uma vez para a organização e selecionar quais repositórios incluir. Além de uma função de proprietário em sua organização Claude, você precisará de permissão para instalar GitHub Apps em sua organização GitHub.
Vá para Configurações da Organização > Claude Code e encontre a seção Code Review.
Clique em "Configurar" para iniciar o fluxo de instalação do GitHub App.
Siga os prompts para instalar o Claude GitHub App em sua organização GitHub. O app solicita permissões de leitura e escrita para conteúdo, problemas e pull requests.
Escolha quais repositórios ativar para Code Review. Se você não vir um repositório, confirme que deu ao Claude GitHub App acesso a ele durante a instalação.
Defina um gatilho de revisão para cada repositório usando o dropdown Review Behavior (consulte a próxima seção para detalhes sobre cada opção).
Para verificar a configuração, abra um PR de teste. Se você escolheu um gatilho automático, uma execução de verificação chamada Claude Code Review deve aparecer em alguns minutos. Se você escolheu Manual, comente "@claude review" no PR para iniciar a primeira revisão.
Escolha um gatilho de revisão
Após a configuração, a seção Code Review mostra seus repositórios em uma tabela. Para cada repositório, escolha quando as revisões são executadas:
Uma vez após a criação do PR: A revisão é executada uma vez quando um PR é aberto ou marcado como pronto para revisão.
Após cada push: A revisão é executada em cada push para a branch do PR, capturando novos problemas conforme o PR evolui. Claude resolve automaticamente threads quando você corrige problemas sinalizados anteriormente. Isso executa a maioria das revisões e custa mais.
Manual: As revisões começam apenas quando alguém comenta "@claude review" em um PR. Útil para repositórios de alto tráfego onde você deseja selecionar quais PRs serão revisados.
A tabela de repositórios também mostra o custo médio por revisão para cada repositório com base na atividade recente.
Disparar revisões manualmente
Comente "@claude review" em um pull request para iniciar uma revisão e optar esse PR em revisões acionadas por push a partir de agora. Isso funciona independentemente do gatilho configurado do repositório.
Para o comentário disparar uma revisão:
Poste-o como um comentário de PR de nível superior, não um comentário inline em uma linha de diff.
Coloque "@claude review" no início do comentário.
Você deve ter acesso de proprietário, membro ou colaborador ao repositório.
O PR deve estar aberto e não ser um rascunho.
Se uma revisão já está em execução, a solicitação é enfileirada até que a revisão em andamento seja concluída.
Personalizar revisões
Code Review lê dois arquivos do seu repositório para orientar o que sinaliza. Ambos são aditivos além das verificações de correção padrão.
CLAUDE.md
Code Review lê os arquivos CLAUDE.md do seu repositório e trata violações recém-introduzidas como descobertas de nível de observação. Se seu PR altera o código de forma que torna uma declaração CLAUDE.md desatualizada, Claude sinaliza que a documentação também precisa ser atualizada.
Claude lê arquivos CLAUDE.md em cada nível da hierarquia de diretórios, portanto as regras no CLAUDE.md de um subdiretório se aplicam apenas aos arquivos sob esse caminho.
REVIEW.md
Adicione um arquivo REVIEW.md à raiz do seu repositório para regras específicas de revisão. Use-o para codificar:
Diretrizes de estilo da empresa ou equipe
Convenções específicas de linguagem ou framework não cobertas por linters
Coisas que Claude sempre deve sinalizar (por exemplo, "qualquer nova rota de API deve ter um teste de integração")
Coisas que Claude deve pular (por exemplo, "não comente sobre código gerado")
Claude descobre automaticamente REVIEW.md na raiz do repositório. Nenhuma configuração é necessária.
Preços e uso
Code Review é cobrado com base no uso de tokens. Cada revisão custa em média $15–25, dimensionando com o tamanho do PR, complexidade da base de código e quantos problemas exigem verificação.
O uso de Code Review é cobrado separadamente através de créditos de uso e não conta contra o uso incluído do seu plano. O gatilho de revisão que você escolhe afeta o custo total:
Uma vez após a criação do PR é executado uma vez por PR.
Após cada push é executado em cada push, multiplicando o custo pelo número de pushes.
Manual não incorre em custo até que alguém comente "@claude review". Após esse comentário, pushes adicionais para o PR acionam revisões automaticamente.
Os custos aparecem na sua fatura Anthropic independentemente de sua organização usar AWS Bedrock ou Google Vertex AI para outros recursos Claude Code.
Para definir um limite de gastos mensal, vá para Configurações da organização > Uso e configure o limite para o serviço Claude Code Review.
Monitore gastos através do gráfico de custo semanal no painel de análise ou da coluna de custo médio por repositório nas configurações de administrador.
Visualizar uso
Vá para o painel de análise de Code Review para ver a atividade em toda a sua organização. O painel mostra:
PRs revisados: Contagem diária de solicitações de pull revisadas no intervalo de tempo selecionado.
Custo semanal: Gastos semanais em Code Review.
Feedback: Contagem de comentários de revisão que foram resolvidos automaticamente porque alguém abordou o problema.
Detalhamento do repositório: Contagens por repositório de PRs revisados e comentários resolvidos.
Solução de problemas
Repositórios não aparecem após instalar o GitHub App
Se você instalou o Claude GitHub App mas seus repositórios não aparecem no painel de administrador:
Confirme que o Claude GitHub App tem acesso aos repositórios que você espera. Vá para as configurações da sua organização GitHub, encontre o Claude GitHub App em GitHub Apps Instalados e verifique se ele tem acesso a todos os repositórios ou apenas aos selecionados.
Se sua organização usa GitHub Enterprise Cloud com Enterprise Managed Users (EMU), certifique-se de que o Claude GitHub OAuth App está autorizado no nível da empresa. Empresas EMU podem restringir quais aplicativos OAuth são aprovados, e o aplicativo Claude deve ser explicitamente permitido.
Tente desconectar e reconectar a integração do GitHub. Vá para Configurações da organização > Claude Code, remova a configuração do repositório e execute a configuração novamente.
Se o problema persistir, entre em contato com nossa equipe de Suporte com o nome da sua organização e o nome da organização GitHub para que possamos investigar.
Code Review não inicia em um novo PR
Se nenhuma execução de verificação aparecer após abrir um PR:
Confirme que o repositório está listado e habilitado nas configurações de administrador.
Verifique a configuração do gatilho de revisão. Se estiver definido como Manual, você precisará comentar "@claude review" no PR para iniciar uma revisão.
Certifique-se de que o PR não é um rascunho. Code Review não é executado em PRs de rascunho.
Verifique se o Claude GitHub App ainda tem acesso ao repositório nas configurações da sua organização GitHub.
GitHub Enterprise Cloud com restrições de IP
Se sua organização GitHub Enterprise Cloud restringe o acesso por endereço IP, o Claude GitHub App pode ser incapaz de acessar seus repositórios. Para corrigir isso, ative a herança da lista de permissão de IP para GitHub Apps instalados nas configurações da sua empresa GitHub. O Claude GitHub App registra seus intervalos de IP, portanto ativar essa configuração permite acesso sem configuração manual. Para adicionar os intervalos à sua lista de permissão manualmente, ou para configurar outros firewalls, consulte os endereços IP da API Anthropic.
GitHub Enterprise Server (auto-hospedado)
GitHub Enterprise Server (GHES) auto-hospedado é suportado através de um fluxo de configuração separado. Consulte Claude Code com GitHub Enterprise Server para instruções completas.
Problemas comuns de configuração do GHES:
Erro "Public cannot be private" durante a configuração: Seu nome de host GHES deve ser resolvido para um endereço IP roteável publicamente. Code Review alcança seu servidor pela internet, portanto endereços de rede interna ou privada não funcionarão. Atualize o DNS ou sua configuração de rede para que o nome de host seja resolvido para um IP público e tente novamente.
GitHub Enterprise Cloud com Data Residency é um produto diferente. Locatários de Data Residency (nomes de host correspondentes a
*.ghe.com) não são suportados por Code Review. Apenas GitHub Enterprise Server auto-hospedado e repositórios padrão github.com são suportados.
Perguntas frequentes
Code Review está disponível como uma capacidade ao criar uma função personalizada?
Não, Code Review não está disponível para adicionar a uma função personalizada no momento.
Recursos relacionados
Plugins — Navegue pelo marketplace de plugins, incluindo um plugin de revisão de código para executar revisões sob demanda localmente antes de fazer push.
GitHub Actions — Execute Claude em seus próprios fluxos de trabalho do GitHub Actions para automação personalizada além da Revisão de Código.
GitLab CI/CD — Integração Claude auto-hospedada para pipelines do GitLab.