Claude Code Review: como funciona a revisão de PRs com IA
O Claude Code Review é o serviço da Anthropic que revisa automaticamente os pull requests dos seus repositórios no GitHub com vários agentes de IA. Desde 14 de outubro de 2026, ele deixou o research preview e está disponível de forma geral para organizações nos planos Team e Enterprise.
Neste artigo, você vai entender como o serviço funciona por dentro, quais são os requisitos e como ajustar o que ele aponta. Além disso, vamos comparar as diferentes formas de obter uma revisão do Claude, para que você escolha a mais adequada ao seu time.
O que é o Claude Code Review
O Claude Code Review é um revisor gerenciado de pull requests que roda na infraestrutura da Anthropic. Em vez de um único modelo lendo o diff, vários agentes analisam cada mudança junto com o código ao redor.
Esses agentes procuram erros de lógica, vulnerabilidades de segurança e casos de borda quebrados. Antes de qualquer comentário chegar ao PR, uma etapa de verificação confronta cada achado com o código real.
Dessa forma, o serviço reduz os falsos positivos, que costumam ser o maior motivo de frustração com ferramentas automáticas de revisão. Afinal, um revisor que reclama de tudo rapidamente passa a ser ignorado pelo time.
Os achados aparecem como comentários inline nas linhas afetadas, ordenados por severidade. Além disso, o pull request recebe um resumo da revisão e um check run com os detalhes.
Um ponto importante é que o Claude Code Review nunca aprova nem bloqueia um pull request. Ou seja, a decisão de fazer o merge continua com o seu time, e a ferramenta atua como uma primeira leitura qualificada antes da revisão humana.
Por padrão, o foco está na corretude. Em outras palavras, ele procura bugs que quebrariam produção, e não preferências de formatação ou falta de cobertura de testes.
O que mudou na disponibilidade geral
O lançamento original aconteceu como research preview, com a proposta de revisões profundas conduzidas por um time de agentes. Na época, a Anthropic relatou que 84% dos PRs grandes, com mais de mil linhas alteradas, recebiam achados, com média de 7,5 problemas cada.
Com a disponibilidade geral, a empresa explica que os agentes de código aceleraram a escrita, mas o gargalo da revisão continuou. Por isso, a versão GA traz melhorias em três frentes.
- Velocidade: a maior parte das revisões agora termina cerca de três vezes mais rápido, caindo de aproximadamente 20 minutos para 6 a 10 minutos.
- Qualidade: os achados ficaram mais claros e concisos, descrevendo o problema, o que o dispara e a correção em poucas frases.
- Flexibilidade: os administradores escolhem entre os níveis Quick, Standard e Deep para cada repositório.
Segundo a Anthropic, quem usou o Claude Code Review durante o preview pediu revisões mais silenciosas, proporcionais ao tamanho da mudança e mais rápidas. Além disso, a própria empresa roda o serviço nos seus pull requests internos, o que mostrou onde as revisões atrasavam os engenheiros.
Há também um incentivo comercial para quem quer experimentar. Organizações Enterprise elegíveis podem resgatar pelo menos 10 mil dólares em créditos de Code Review até 15 de janeiro de 2027.
Contudo, esses créditos expiram 30 dias após o resgate e seguem os termos da oferta. Então, vale planejar o piloto antes de resgatar, para não desperdiçar o período.
Como o Claude Code Review funciona por dentro
Entender o fluxo interno ajuda a interpretar os resultados e a calibrar as expectativas. Afinal, o Claude Code Review não compila nem executa o seu código, porque trabalha apenas lendo o diff e o código ao redor.
Isso significa que problemas que só aparecem em tempo de execução, como uma configuração de ambiente errada, podem passar despercebidos. Por outro lado, a análise estática feita por vários agentes encontra muitos bugs de lógica que os testes não cobrem.
As quatro etapas de uma revisão
Cada revisão roda na infraestrutura da Anthropic e passa por quatro etapas bem definidas.
- Encontrar: vários agentes examinam o diff e o código ao redor em paralelo.
- Verificar: uma etapa de verificação confronta os achados candidatos com o código e filtra os falsos positivos.
- Classificar: os achados restantes passam por deduplicação e ganham uma ordem de severidade.
- Publicar: a revisão envia os resultados para o pull request.
A etapa de verificação é o que diferencia essa abordagem de um simples prompt sobre o diff. Assim, um agente pode levantar uma suspeita, mas ela só chega ao PR se resistir à checagem contra o código.
A deduplicação também faz diferença na prática. Como vários agentes leem a mesma mudança, é comum que dois deles encontrem o mesmo problema, e o time recebe apenas um comentário por achado.
O que fica registrado no pull request
Ao final de cada execução, o pull request recebe três tipos de registro.
- Achados: comentários inline nas linhas afetadas, com um resumo no corpo da revisão.
- Check run: um check chamado Claude Code Review, com os achados listados nos detalhes.
- Nota de ausência: quando a revisão não encontra nada, o título do check run indica que não há problemas, e o Claude deixa a mesma nota curta no PR.
O check run nunca termina como falha, então ele não funciona como um portão de merge por conta própria. Portanto, se o seu time quiser exigir a correção dos achados, essa regra precisa vir de outro processo, como uma política de aprovação humana.
Níveis de revisão: Quick, Standard e Deep
O nível de revisão define o quanto cada análise será minuciosa. Naturalmente, uma revisão mais profunda também custa mais e demora mais para terminar.
- Quick: uma passada mais leve, a mais rápida e com o menor custo.
- Standard: equilíbrio entre profundidade, velocidade e custo, sendo o nível padrão.
- Deep: a análise mais completa, que leva mais tempo e custa mais.
Um Owner da organização escolhe um nível padrão e pode definir um nível específico por repositório. Por exemplo, um serviço interno de rotina pode usar Quick, enquanto o repositório de pagamentos recebe Deep.
Vale notar que o serviço escolhe sozinho os modelos Claude usados nas revisões. Ou seja, as configurações administrativas não oferecem escolha de modelo, e o nível de revisão é a única alavanca de profundidade.
Na documentação oficial do Code Review, a Anthropic reforça que todos os níveis entregam revisões de qualidade. Assim, a escolha passa a ser uma decisão de custo e de risco, e não de confiança no resultado.
Requisitos e disponibilidade do Claude Code Review
Antes de ativar o Claude Code Review, confira se a sua organização atende aos requisitos. A lista é curta, mas tem restrições importantes para empresas reguladas.
- Planos: Team e Enterprise.
- Hospedagem de código: repositórios no GitHub, incluindo GitHub Enterprise Server e GitHub Enterprise Cloud com residência de dados.
- Residência de dados: nesse caso, o Owner segue a configuração do GitHub Enterprise Server e informa o hostname ghe.com da empresa.
- Retenção de dados: o serviço não atende organizações com Zero Data Retention ou com a configuração HIPAA, e também fica fora do Business Associate Agreement da Anthropic.
- Chaves de criptografia: organizações que usam chaves gerenciadas pelo cliente (CMEK) ainda não têm acesso.
- Provedores de nuvem: mesmo com o Claude Code via Amazon Bedrock, Google Cloud Agent Platform ou Microsoft Foundry, você precisa de uma organização Claude em um plano compatível.
Repare que GitLab e Bitbucket não aparecem na lista. Por isso, times que usam esses serviços precisam recorrer a outras opções, como rodar o Claude no próprio CI.
Empresas da área de saúde ou com contratos de retenção zero também precisam atenção redobrada. Nesses casos, o caminho mais seguro costuma ser uma integração no próprio pipeline, com credenciais e políticas controladas internamente.
Como configurar o Claude Code Review
Um Owner da organização Claude faz a configuração do Claude Code Review em poucos passos. Primeiro, ele ativa o recurso e conecta o GitHub; em seguida, define o comportamento de cada repositório.
- Ative o Code Review nas configurações do Claude Code.
- Instale o Claude GitHub App na organização do GitHub.
- Selecione os repositórios que vão receber revisões.
- Escolha o nível de revisão padrão e, se quiser, níveis específicos por repositório.
- Defina quando as revisões rodam em cada repositório.
Do lado dos desenvolvedores, não há nada a configurar. Depois que o Owner ativa o Claude Code Review, as revisões passam a rodar automaticamente nos novos PRs.
Caso o seu time ainda esteja consolidando o fluxo de branches e pull requests, vale revisar os fundamentos do Git e Azure DevOps antes de automatizar a revisão. Afinal, uma revisão automática funciona melhor quando os PRs chegam pequenos e focados.
Quando as revisões rodam
Cada repositório tem uma configuração que define o momento da revisão. Há três opções disponíveis.
- Uma vez, quando o pull request abre.
- Depois de cada push no pull request.
- Apenas sob demanda.
Independentemente da opção escolhida, qualquer pessoa com permissão de escrita no repositório pode pedir uma revisão comentando no PR.
@claude review
Nos modos automáticos, abrir ou atualizar um PR dispara a revisão, exceto em drafts e forks. Além disso, o comando só funciona quando vem de alguém com permissão de escrita, o que evita disparos por pessoas de fora do time.
Na prática, rodar a cada push oferece o retorno mais frequente, mas também multiplica o número de revisões. Por isso, muitos times preferem revisar apenas na abertura e pedir novas rodadas manualmente quando o PR muda bastante.
Personalizando o Claude Code Review com REVIEW.md
Por padrão, o foco é a corretude. Contudo, cada base de código tem riscos próprios, e é aqui que entram os arquivos de orientação.
O Claude Code Review usa dois arquivos do repositório para ajustar o que aponta. O CLAUDE.md traz o contexto geral do projeto, enquanto o REVIEW.md concentra as instruções específicas para revisão.
Um detalhe de segurança importante está na origem do REVIEW.md. O serviço lê esse arquivo do branch base ou do branch padrão, e nunca das alterações do próprio pull request.
Na prática, isso impede que alguém altere as regras de revisão no mesmo PR que deveria passar pela revisão. Portanto, mudanças no REVIEW.md só valem depois do merge.
Veja um exemplo de REVIEW.md para uma API em .NET com EF Core.
# Review guidelines
## Always flag
- EF Core queries executed inside loops (N+1 queries).
- Async methods that block with .Result or .Wait().
- Endpoints in the Orders API that skip authorization checks.
- Secrets or connection strings committed to appsettings.json.
## Ignore
- Formatting and naming style (handled by dotnet format).
- Missing XML documentation comments.
## Context
- Money values must use decimal, never double.
- All DateTime values must be UTC.
Repare que o exemplo usa linguagem direta e regras verificáveis. Assim, os agentes sabem exatamente o que procurar e o que ignorar, o que reduz o ruído nos comentários.
O CLAUDE.md, por sua vez, deve trazer o contexto que vale para qualquer tarefa, como arquitetura, convenções e organização do projeto.
# Project context
- Solution: Store.sln (ASP.NET Core Minimal APIs, .NET 10).
- Data access: EF Core with PostgreSQL, migrations in src/Store.Infrastructure.
- Business rules live in src/Store.Domain and must not reference infrastructure.
- Run tests with: dotnet test Store.sln
Uma boa regra é manter no REVIEW.md tudo o que interessa apenas à revisão. Dessa forma, o CLAUDE.md não cresce com instruções que só fazem sentido nos pull requests.
Com o tempo, o REVIEW.md vira uma espécie de memória das lições aprendidas pelo time. Cada falso positivo recorrente e cada bug que escapou para produção podem se transformar em uma nova linha de orientação.
O que o Claude Code Review pode acessar
Para um time preocupado com segurança, saber o alcance da ferramenta importa tanto quanto saber o que ela encontra. O Claude Code Review chega ao repositório por meio do Claude GitHub App que o Owner instala na configuração.
- Onde roda: na infraestrutura da Anthropic, em um ambiente gerenciado, e nunca em ambientes self-hosted.
- O que lê: dentro da revisão, o acesso ao repositório é somente leitura, e o serviço não faz push de commits.
- O que publica: comentários, o check run, a resolução dos próprios threads anteriores e uma reação 👀 aos comandos em comentários.
- Como examina: lendo o diff e o código ao redor, sem compilar nem executar nada.
Vale lembrar que o GitHub App possui um conjunto de permissões mais amplo, compartilhado com outros recursos do Claude. Por isso, revise a página de permissões do app antes de instalar em organizações com políticas rígidas.
Outro alerta vem da própria documentação. Como qualquer ferramenta de IA, o Claude Code Review pode deixar passar bugs ou vulnerabilidades, e uma revisão sem achados não garante código livre de erros.
Custos e controle de gastos
O custo de cada revisão depende principalmente do nível escolhido, já que análises mais profundas consomem mais. Além disso, a frequência das revisões influencia bastante a conta no fim do mês.
Para manter o controle, a documentação descreve um limite mensal de gastos que o Owner pode configurar. Quando o orçamento acaba, as revisões deixam de rodar, e a página de troubleshooting explica como identificar esse caso.
Então, antes de ativar Deep em todos os repositórios, faça um piloto com poucos projetos. Com os números reais em mãos, fica muito mais fácil estimar o gasto e decidir onde a profundidade extra compensa.
Claude Code Review ou /code-review: qual usar
O serviço gerenciado não é a única forma de obter uma revisão do Claude. A documentação oficial lista cinco caminhos, cada um com um gatilho, um ambiente e um público diferente.
| Opção | O que dispara | Onde roda | Quem pode usar |
|---|---|---|---|
| Code Review | Atividade no PR ou comentário @claude review | Infraestrutura da Anthropic | Team e Enterprise com GitHub, após ativação por um Owner |
| /code-review | Você roda o comando no seu branch | Sua sessão do Claude Code | Qualquer pessoa, em qualquer plano |
| Ultrareview | Você inicia pelo Claude Code | Um sandbox na nuvem | Exige login com conta claude.ai |
| Claude no seu CI | Eventos do pipeline (GitHub Actions ou GitLab CI/CD) | Seus próprios runners | Quem tem chave da API ou credenciais de nuvem |
| Revisor próprio | Você ou o Claude invocam na sessão | Onde o Claude Code rodar | Quem escrever um subagente ou skill |
Em resumo, o Claude Code Review faz sentido quando você quer revisões automáticas e padronizadas em todos os PRs, sem manter infraestrutura. Por outro lado, o comando /code-review atende quem quer uma revisão antes de abrir o PR, inclusive em planos individuais.
Já para quem usa GitLab ou precisa rodar tudo nos próprios runners, a integração com o CI é o caminho natural. Enquanto isso, um revisor próprio como subagente ou skill oferece controle total, ao custo da manutenção.
Nada impede combinar as opções. Um desenvolvedor pode rodar /code-review localmente antes do push, e o serviço gerenciado faz a revisão oficial quando o PR abre.
Boas práticas para adotar a revisão com IA
Ativar a ferramenta é a parte fácil, e o desafio real está em encaixá-la no fluxo do time. A seguir, algumas práticas ajudam a extrair valor desde as primeiras semanas.
- Comece por poucos repositórios e acompanhe a qualidade dos achados antes de expandir.
- Use Deep apenas onde o custo de um bug em produção justifica o investimento.
- Revise os falsos positivos com frequência e transforme os padrões em regras no REVIEW.md.
- Defina quem trata os achados, porque o check run não bloqueia o merge.
- Mantenha os pull requests pequenos, já que mudanças focadas geram revisões mais precisas.
- Acompanhe os gastos e configure o limite mensal antes de ampliar o uso.
Além disso, deixe claro para o time que o Claude Code Review complementa a revisão humana, e não a substitui. Afinal, decisões de design, de produto e de arquitetura continuam exigindo o olhar de quem conhece o negócio.
Uma boa forma de medir o resultado é acompanhar quantos achados viram correções reais. Se esse número cair muito, provavelmente o REVIEW.md precisa de ajustes ou o nível escolhido não combina com o repositório.
Conclusão
O Claude Code Review chega à disponibilidade geral mais rápido, mais preciso e mais flexível do que no preview. Com revisões que terminam em poucos minutos e níveis ajustáveis por repositório, ele se torna uma opção concreta para aliviar o gargalo da revisão.
Ao mesmo tempo, o serviço tem limites claros. Ele não aprova nem bloqueia PRs, não executa o código e exige GitHub, além de um plano Team ou Enterprise.
Para tirar o melhor proveito do Claude Code Review, invista em um REVIEW.md bem escrito e escolha o nível certo para cada repositório. Assim, a IA cuida da primeira leitura, enquanto o seu time foca nas decisões que realmente exigem experiência.
FAQ
O Claude Code Review substitui a revisão humana?
Não. Ele nunca aprova nem bloqueia um pull request, então a decisão de merge continua com o seu time.
Quais planos têm acesso ao Claude Code Review?
O serviço atende organizações nos planos Team e Enterprise, com repositórios hospedados no GitHub.
O Claude Code Review funciona com GitLab?
Não, o serviço gerenciado funciona apenas com GitHub. Para GitLab, a alternativa é rodar o Claude no próprio pipeline de GitLab CI/CD.
Posso escolher o modelo usado nas revisões?
Não. O serviço escolhe os modelos, e você controla a profundidade apenas pelos níveis Quick, Standard ou Deep.
Como pedir uma nova revisão em um pull request?
Basta comentar @claude review no PR, desde que você tenha permissão de escrita no repositório.
Um REVIEW.md alterado no próprio PR muda a revisão?
Não. O serviço lê o REVIEW.md do branch base ou do branch padrão, e nunca das mudanças do PR.