Revisão de Código 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 Revisão de Código, configurar gatilhos de revisão, personalizar o que é sinalizado e solucionar problemas comuns de configuração.
Observação: Revisão de Código 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 Revisão de Código é faturado separadamente através de uso extra e não conta contra o uso incluído do seu plano.
Como funciona a Revisão de Código
Depois que uma organização ativa Revisão de Código, ela pode ser acionada 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 Revisão de Código verifica
Por padrão, Revisão de Código 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 ela verifica adicionando arquivos de orientação ao seu repositório.
Configurar Revisão de Código
Proprietários e Proprietários Primários de planos Team e Enterprise podem ativar Revisão de Código 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 Revisão de Código.
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 Revisão de Código. 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 Comportamento de Revisão (veja 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 Revisão de Código 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 sã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.
Acionar 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 então. Isso funciona independentemente do gatilho configurado do repositório.
Para o comentário acionar 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
Revisão de Código lê dois arquivos do seu repositório para orientar o que ela sinaliza. Ambos são aditivos além das verificações de correção padrão.
CLAUDE.md
Revisão de Código lê seus arquivos CLAUDE.md do repositório e trata violações recém-introduzidas como descobertas de nível nit. Se seu PR altera o código de uma forma que torna uma declaração CLAUDE.md desatualizada, Claude sinaliza que os documentos também precisam ser atualizados.
Claude lê arquivos CLAUDE.md em cada nível de sua 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 deve sempre 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 em código gerado")
Claude descobre automaticamente REVIEW.md na raiz do repositório. Nenhuma configuração é necessária.
Preços e uso
Revisão de Código é faturada com base no uso de tokens. Cada revisão custa em média $15–25, escalando com o tamanho do PR, complexidade da base de código e quantos problemas requerem verificação.
O uso de Revisão de Código é faturado separadamente através de uso extra 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 em 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 Revisão de Código para ver atividade em toda sua organização. O painel mostra:
PRs revisados: Contagem diária de pull requests revisados no intervalo de tempo selecionado.
Custo semanal: Gastos semanais em Revisão de Código.
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 de 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 de sua organização e o nome de sua organização GitHub para que possamos investigar.
Revisão de Código 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 ativado em suas 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. Revisão de Código não é executada em PRs de rascunho.
Verifique se o Claude GitHub App ainda tem acesso ao repositório nas configurações de 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ões de IP para GitHub Apps instalados nas configurações de 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ões manualmente, ou para configurar outros firewalls, consulte os endereços IP da API Anthropic.
GitHub Enterprise Server (auto-hospedado)
Revisão de Código atualmente requer repositórios hospedados em github.com, portanto o GitHub Enterprise Server auto-hospedado ainda não é suportado.
Perguntas frequentes
Revisão de Código está disponível como uma capacidade ao criar uma função personalizada?
Não, Revisão de Código não está disponível para adicionar a uma função personalizada no momento.
Recursos relacionados
Plugins — Procure no 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 de Revisão de Código.
GitLab CI/CD — Integração Claude auto-hospedada para pipelines GitLab.