Última atualização: 16/11/2026. Informações conferidas em páginas oficiais nesta data.

Revisão de código com IA em um pull request é uma primeira leitura automática: a IA procura erros de lógica, casos esquecidos e problemas de segurança, e uma pessoa decide o que entra. Em 16/11/2026, as páginas oficiais que consultei descrevem quatro caminhos: o comando /code-review no Claude Code, o serviço gerenciado Code Review da Claude, a revisão do GitHub Copilot e um pipeline próprio. Qual usar depende de onde o código está hospedado, de quem paga e de quem tem permissão para ativar.

O ponto que mais confunde quem começa: nenhum desses caminhos é um portão de qualidade por conta própria. Segundo a documentação, o serviço da Claude nunca aprova nem bloqueia um pull request, e a revisão do Copilot só conta como aprovação obrigatória se a organização ativar essa opção. A decisão de fazer o merge continua humana.

Este guia compara os caminhos por critérios explícitos (onde roda, quem pode usar, o que lê, como cobra) e não elege um vencedor. Existem outras ferramentas de revisão no mercado. Elas ficaram de fora porque só incluí o que consegui confirmar em páginas oficiais nesta data.

Diagrama com quatro caminhos para revisar um pull request com IA: comando local, serviço gerenciado, Copilot e pipeline próprio
Esquema dos quatro caminhos comparados neste guia, com base nas páginas oficiais consultadas em 16/11/2026.

Os 4 caminhos lado a lado

A tabela resume o que as páginas oficiais dizem sobre cada caminho. Os detalhes vêm nas seções seguintes.

CaminhoO que dispara a revisãoOnde rodaQuem pode usarHospedagem do código
1. /code-review no Claude CodeVocê digita o comandoNa sua sessão do Claude CodeQualquer plano, segundo a documentaçãoRevisa a sua branch ou um PR; com --comment publica no GitHub (PR) ou no GitLab (merge request)
2. Code Review gerenciado da ClaudeAtividade no PR, conforme o repositório, ou o comentário @claude reviewInfraestrutura da AnthropicOrganizações Team e Enterprise, depois que um Owner ativaGitHub, incluindo GitHub Enterprise Server e Cloud
3. GitHub Copilot code reviewVocê atribui o Copilot como revisor, ou a revisão automática configuradaPlataforma do GitHubPlanos pagos do CopilotGitHub.com, GitHub CLI, Mobile, VS Code, Visual Studio, Xcode e JetBrains; Azure DevOps em preview público
4. Pipeline próprio (CI)Eventos do seu pipeline, como cada PR ou merge requestSeus próprios runnersQuem tem chave de API ou credenciais de nuvemGitHub Actions ou GitLab CI/CD

Qual caminho para cada perfil

Não existe caminho universal. A tabela abaixo cruza cada perfil com o que a documentação permite e com o ponto que mais exige atenção.

PerfilCaminho que costuma caber primeiroPor quê, segundo a documentaçãoAtenção
Dev solo1, e o 3 se já tem plano pago do CopilotO /code-review roda na sua sessão e vale em qualquer plano. Segundo a documentação, o usuário pode configurar o Copilot para revisar automaticamente os PRs que ele cria, nos planos Copilot Pro, Pro+ e Max e com licença Business ou Enterprise (não disponível para contas de usuário gerenciadas)O uso do /code-review entra no consumo do seu plano ou na cobrança da API. O plano Free do Copilot não inclui revisão de código
Freelancer1, antes de abrir o PRRoda na sua máquina e não depende de o cliente ativar nada no repositórioO repositório é do cliente: peça autorização por escrito antes de enviar código dele a uma IA. Organizações podem bloquear revisões pedidas com licença externa do Copilot
Equipe no GitHub2 ou 3, ativado por quem administraO 2 é ativado por um Owner da organização Claude (Team ou Enterprise). O 3 depende da política do Copilot da organizaçãoDecida quem trata os achados: o serviço da Claude não bloqueia o merge, e no Copilot a revisão só conta como aprovação se essa opção for ativada
Equipe no GitLab1 com --comment, ou 4O serviço gerenciado da Claude é para GitHub. A documentação do Copilot não lista GitLab entre os locais compatíveis. O /code-review --comment publica uma nota no merge request pelo glab (Claude Code v2.1.257 ou superior)Sem o glab instalado, o Claude imprime os achados no terminal em vez de publicar

Como começar em 6 passos, qualquer que seja o caminho

  1. Escolha um repositório e um tipo de PR de risco baixo. Evite começar por pagamento ou autenticação.
  2. Escreva as regras da equipe em um arquivo curto. Convenções, o que é proibido e o que sempre exige teste. O nome do arquivo muda por caminho (veja a seção de instruções).
  3. Mantenha o PR pequeno e explique o porquê na descrição. A IA e o revisor humano erram menos quando o objetivo está escrito.
  4. Leia o PR antes de ler os comentários da IA. Assim você não é conduzido pelo que ela apontou.
  5. Marque cada comentário como útil, irrelevante ou errado. Esse registro é a única medida honesta de que a revisão está ajudando.
  6. Ajuste as regras e só depois expanda para outros repositórios. Se muitos comentários são descartados, o problema costuma estar nas instruções ou no tamanho do PR.

Caminho 1: /code-review no terminal do Claude Code

É o caminho mais direto para quem trabalha sozinho. O comando revisa as mudanças da sua branch, procura erros de correção e mostra o resultado na sua conversa. Segundo a página de revisão local, ele funciona em qualquer plano, e o uso conta no consumo do plano ou na cobrança da API, como o restante da sessão. Para saber se o Claude Code está incluído no seu plano, veja o guia de planos do Claude.

  1. Abra o Claude Code na pasta do projeto.
  2. Rode /code-review. Sem alvo, ele cobre os commits da branch à frente do upstream mais as mudanças ainda não commitadas.
  3. Para revisar um PR específico, informe o número: /code-review 1234. Também aceita um nome de branch, um caminho ou um intervalo de commits.
  4. Escolha o nível de esforço se quiser: /code-review high 1234. No nível low, ele reporta só o que tem mais confiança, com menos falsos positivos. De medium até max, a cobertura aumenta.
  5. Leia os achados antes de qualquer correção. Use --fix apenas se quiser que o Claude aplique as correções na sua cópia de trabalho (as edições passam pelo seu modo de permissão) e --comment para publicar os achados no PR do GitHub ou no merge request do GitLab.

O que ele lê: o /code-review segue o seu CLAUDE.md e não lê o REVIEW.md, que serve ao serviço gerenciado. O que ele não faz sozinho: em uma sessão de terminal, a revisão roda como um subagente em segundo plano, e as correções feitas com --fix nesse modo ficam fora dos checkpoints da sessão, então /rewind não as desfaz por completo. Use o git para reverter.

Existe ainda a revisão profunda na nuvem, /code-review ultra. Segundo a página de comandos consultada em 16/11/2026, ela inclui 3 execuções gratuitas nos planos Pro, Max e Ultra e, depois disso, exige créditos de uso. A página de revisão local acrescenta que ela exige autenticação com uma conta claude.ai e não está disponível no Amazon Bedrock, no Google Cloud nem no Microsoft Foundry.

Caminho 2: Code Review gerenciado da Claude (Team e Enterprise)

É o serviço que revisa os pull requests do GitHub automaticamente, sem você manter infraestrutura. Segundo o post oficial de 15/10/2026, ele está em disponibilidade geral para os planos Team e Enterprise. Vários agentes leem o diff junto com o código ao redor, uma etapa de verificação confere os achados contra o código e só então os comentários chegam ao PR, ordenados por severidade.

  • Quem ativa: um Owner da organização Claude instala o GitHub App da Claude, escolhe os repositórios, o nível (Quick, Standard ou Deep, sendo Standard o padrão) e quando as revisões rodam.
  • Quando rodam: uma vez ao abrir o PR, a cada push ou só sob demanda. Em qualquer modo, quem tem permissão de escrita pode comentar @claude review.
  • O que publica: comentários nas linhas afetadas, um resumo e um check run chamado Claude Code Review. O check run não termina como falha.
  • O que não faz: não aprova nem bloqueia o PR, não compila nem executa o código, e o acesso ao repositório durante a revisão é somente leitura.
  • Quando ignora o PR: automaticamente, ignora rascunhos e PRs vindos de forks.
  • Entre os que ficam de fora: organizações com retenção zero de dados e as que usam chaves de criptografia gerenciadas pelo cliente, segundo a seção Availability da documentação.
  • Modelo: o serviço escolhe os modelos. As configurações de administração não oferecem escolha de modelo, e o nível de revisão é a única alavanca de profundidade.

A própria documentação avisa que a IA pode deixar passar bugs e vulnerabilidades, e que uma revisão sem achados não significa código sem erros.

Caminho 3: GitHub Copilot code review

Dentro do GitHub, o Copilot pode ser atribuído como revisor de um pull request. Segundo a documentação do GitHub consultada em 16/11/2026, o recurso está disponível em todos os planos pagos do Copilot, e o plano Free não inclui revisão de código. Organizações também podem permitir que membros sem licença do Copilot usem o recurso no GitHub.com, desde que um administrador ative as políticas necessárias.

  • Gatilho padrão: por padrão, o Copilot só revisa um PR se você o atribuir. A revisão automática pode ser configurada por usuário, por repositório ou por organização.
  • Novos pushes: a menos que a revisão a cada push esteja ativada, o Copilot revisa o PR uma vez. Para repetir, peça manualmente.
  • Níveis de esforço: Lite, Balanced (padrão) e Max. O nível Max, que não deve ser confundido com o plano Copilot Max, está em preview público segundo a documentação consultada em 16/11/2026.
  • Modelo: a troca de modelo não é suportada na revisão de código.
  • Arquivos que ficam de fora: arquivos de dependências como package.json e Gemfile.lock, logs e SVG.
  • Aprovações: por padrão, as revisões do Copilot não contam para as aprovações exigidas. Se a organização ativar as aprovações do Copilot, ele pode enviar uma revisão de aprovação que conta como a de um colega.
  • Contexto extra: a documentação cita leitura de todo o projeto, instruções do repositório, skills de agentes e servidores MCP configurados.

A documentação também lembra que o Copilot pode errar e recomenda validar o feedback e complementar com revisão humana.

Caminho 4: Claude no seu pipeline ou um revisor próprio

A tabela comparativa da documentação do Claude lista duas opções para quem quer controle total: rodar o Claude no seu CI, com GitHub Actions ou GitLab CI/CD, ou escrever um revisor próprio como subagente ou skill. A primeira roda nos seus runners e é aberta a quem tem uma chave de API ou credenciais de um provedor de nuvem. A segunda roda onde o Claude Code rodar e exige que você escreva e mantenha o revisor.

Esse é o caminho natural para equipes no GitLab que precisam de revisão em todo merge request, ou para quem não pode usar infraestrutura de terceiros. O custo é de manutenção: você define o gatilho, as instruções e o que fazer com o resultado. Os passos de configuração estão nas páginas oficiais da Claude e do seu provedor de CI, e eu não reproduzo aqui nenhum arquivo de pipeline porque não executei nenhum.

Custos segundo as páginas oficiais (estimativas, consultadas em 16/11/2026)

Os números abaixo são os que as páginas oficiais publicam. São estimativas da documentação, podem mudar e não servem para concluir qual caminho sai mais barato: o gasto real depende do tamanho dos seus PRs, do nível escolhido e de quantas revisões rodam.

Copilot code review: nível de esforçoFaixa típica por revisãoMédia aproximada por revisão
LiteUS$ 0,05 a US$ 1US$ 0,25
BalancedUS$ 0,25 a US$ 5US$ 1,50
MaxUS$ 1,50 a US$ 25US$ 10
  • Copilot: os valores acima são em créditos de IA e excluem os minutos do GitHub Actions, que a documentação lista como um segundo componente de custo dos recursos agênticos. A documentação diz que o consumo tende a subir com o tamanho do PR e com as instruções do repositório.
  • Code Review gerenciado da Claude: a página de custos diz que não há preço fixo por revisão. A cobrança é por uso de tokens, via créditos de uso, separada do que o plano inclui, e é feita à organização, não a quem abriu o PR. Há um limite mensal de gasto configurável, e as revisões são puladas quando o limite, o limite da organização ou o saldo acabam.
  • Claude no /code-review: conta no consumo do seu plano ou na cobrança da API.
  • Dica de piloto da própria documentação da Claude: rode em poucos repositórios representativos, leia o custo médio por revisão no painel e multiplique pelo número de PRs do mês.

Um detalhe de configuração que pesa na conta: segundo a página de custos, um repositório adicionado pela página de administração começa em Após cada push, que é o modo com mais revisões. Se o seu objetivo é testar, mude para uma revisão por PR ou para o modo manual antes de começar.

Quem lê qual arquivo de instruções, e de qual branch

As regras escritas no repositório são o que transforma uma revisão genérica em uma revisão útil. Mas cada caminho lê arquivos diferentes, e a branch de onde lê muda a segurança do processo.

CaminhoO que lê e de onde
1. /code-reviewO CLAUDE.md. Não lê o REVIEW.md
2. Code Review gerenciado da ClaudeO CLAUDE.md e o REVIEW.md. O REVIEW.md é lido da branch base do PR ou da branch padrão, nunca das mudanças do próprio PR. Parte das instruções só vale com a branch protegida
3. GitHub Copilot code reviewInstruções do repositório, instruções de agentes e skills, lidas da branch de cabeça do PR (a branch com as mudanças), não da base

Leitura minha, não da documentação: no serviço da Claude, alterar o REVIEW.md no mesmo PR não muda a revisão daquele PR, porque a regra só vale depois do merge. A página do Copilot descreve o oposto como vantagem: dá para testar mudanças nas instruções dentro do próprio PR, sem fazer merge. Na prática, isso significa que quem trata o conteúdo de um PR como entrada não confiável precisa saber qual das duas regras está em jogo.

Modelo de REVIEW.md (para o serviço da Claude)

O formato é Markdown livre, na raiz do repositório. Este modelo segue o formato do exemplo da página oficial Customize Code Review, com conteúdo que eu escrevi. Modelo fictício, não executado.

# Instruções de revisão

## O que é Importante aqui
Reserve Importante para achados que quebrariam o comportamento, vazariam dados ou impediriam um rollback: lógica incorreta, consultas sem filtro por cliente, dados pessoais em logs e migrações incompatíveis com a versão anterior. Estilo e nomes são, no máximo, Nit.

## Limite de nits
Reporte no máximo cinco Nits por revisão.

## Não reporte
- O que o CI já verifica: lint, formatação e erros de tipo
- Arquivos gerados em src/gen/ e arquivos *.lock

## Sempre verifique
- Rotas novas têm teste de integração
- Linhas de log não incluem e-mails, IDs de usuário nem corpo de requisições

Modelo de CLAUDE.md (para o /code-review e para o serviço)

O CLAUDE.md guarda o contexto do projeto. A documentação recomenda colocar nele o que vale para os dois caminhos e deixar no REVIEW.md só o que é específico da revisão de PR. Modelo fictício, não executado.

# Contexto do projeto
- Projeto: loja fictícia Aurora, API em Node com PostgreSQL.
- Regras de negócio ficam em src/dominio e não importam nada de src/infra.
- Rode os testes com: npm test
- Valores de dinheiro usam centavos inteiros, nunca decimais de ponto flutuante.

Modelo de instruções do repositório para o Copilot

A documentação do GitHub descreve as instruções personalizadas como frases curtas em linguagem natural, guardadas em arquivos do repositório, e cita o arquivo .github/copilot-instructions.md para regras do repositório inteiro. Modelo fictício, não executado.

# Instruções do repositório para o Copilot
- Valores de dinheiro são guardados em centavos inteiros.
- Toda rota nova precisa de teste de integração.
- Não comente formatação nem nomes de variáveis, porque o lint cuida disso.
- Marque como crítico qualquer log com e-mail ou ID de usuário.

Prompt de segunda passada para copiar

Todo revisor automático gera falsos positivos. Uma segunda leitura pedida à própria IA, com o código à mão, derruba parte deles antes de chegarem a uma pessoa. Cole o prompt abaixo na mesma conversa da primeira revisão (por exemplo, depois de um /code-review) ou em um chat com o diff.

Prompt: Releia a sua própria revisão deste pull request. Para cada comentário que você fez: 1) diga se há evidência no diff ou no código ao redor, citando arquivo e linha, ou se foi uma suposição; 2) classifique como confirmado, falso positivo provável ou precisa de mais informação; 3) se for falso positivo provável, explique em uma frase o que me deixaria com certeza; 4) reclassifique a severidade (crítico, alto, médio ou baixo) se for o caso. Não mantenha um comentário só porque ele apareceu antes. Não altere nenhum código agora. No final, liste em até três itens o que um revisor humano precisa confirmar com quem conhece a regra de negócio.

Exemplo fictício da segunda passada

Exemplo fictício, não executado: os comentários abaixo foram escritos por mim para ilustrar o formato, e não saíram de nenhuma ferramenta. Imagine um PR da loja fictícia Aurora que altera a função de desconto para clientes recorrentes.

Comentário da primeira revisão (fictício)Resultado da segunda passada (fictício)
O desconto é aplicado antes do frete em um ponto e depois em outroConfirmado: cita as duas chamadas, com arquivo e linha, que usam ordens diferentes
O carrinho vazio não é tratadoConfirmado: a função divide pelo total sem checar se ele é zero
Possível injeção de SQL na busca do cupomFalso positivo provável: a consulta usa parâmetros, e a evidência está na linha citada
(Item para o humano)Confirmar com a área comercial se o desconto pode acumular com cupom de campanha, regra que não está no repositório

Repare no último item: a IA não tinha como saber uma regra combinada em uma conversa. Esse é o tipo de decisão que continua com a pessoa.

Erros frequentes e como corrigir

ErroPor que aconteceComo corrigir
Tratar PR sem comentários como PR sem bugsA documentação avisa que a IA pode deixar passar problemasFaça a leitura humana de sempre e confira se os testes realmente falhariam com o código errado
PR grande demaisA revisão fica ruidosa e caraDivida o PR ou explique na descrição por que não dá
Nenhuma regra escritaSem contexto, os comentários ficam genéricosEscreva de 5 a 10 regras verificáveis no arquivo do seu caminho
Revisão a cada push sem olhar o custoNo serviço da Claude, o repositório novo começa em Após cada push; no Copilot, o push só é revisado se a opção estiver ativaComece com uma revisão por PR e peça outras manualmente
Esperar que a IA bloqueie o mergeO serviço da Claude não bloqueia, e o Copilot só conta como aprovação se a organização ativarDefina na equipe quem trata os achados e use a proteção de branch do seu repositório
Mudar o REVIEW.md no PR revisadoO serviço lê o arquivo da branch base ou padrãoFaça o merge da mudança de regra antes e avalie o PR seguinte
Aplicar --fix sem ler o diffAs edições passam pelo modo de permissão, mas continuam sendo mudanças no seu códigoLeia o diff do que foi alterado e reverta com o git o que não fizer sentido

Quando não usar IA na revisão

  • Código de pagamento, autorização e permissões: o custo de um erro é alto e depende de contexto que não está no diff. Use a IA como segunda leitura, nunca como a única.
  • Migrações difíceis de desfazer: a IA não vê o estado real do banco.
  • Repositórios de clientes sem autorização escrita: confirme o que o contrato permite antes de enviar o código a qualquer serviço.
  • PRs enormes ou gerados em massa: ninguém entende o que mudou, e a IA tampouco garante.
  • Quando o motivo é pular a revisão humana: nenhum dos caminhos substitui o revisor.

Um lembrete de segurança: nunca cole chaves de API, senhas, tokens nem código confidencial da empresa em uma IA. Se precisar mostrar um trecho, troque os valores por exemplos fictícios e leia antes o guia sobre dados de clientes no ChatGPT: o que não colar e como proteger.

Se o seu fluxo envolve gerar código com IA antes da revisão, veja também o mapa de IA para programar grátis em 2026 e o guia de vibe coding grátis, onde o código revisado costuma nascer.

Perguntas frequentes sobre revisão de código com IA

Qual IA posso usar para revisar pull requests?

Segundo as páginas oficiais consultadas em 16/11/2026, há quatro caminhos: o comando /code-review do Claude Code, o Code Review gerenciado da Claude (Team e Enterprise, GitHub), a revisão de código do GitHub Copilot (planos pagos) e um pipeline próprio com a API. A escolha depende de onde o código fica, de quem paga e de quem pode ativar.

A IA pode aprovar ou bloquear um pull request?

O serviço gerenciado da Claude nunca aprova nem bloqueia, e o check run dele não termina como falha. No Copilot, as revisões não contam para as aprovações exigidas por padrão; elas só contam se a organização ativar as aprovações do Copilot. Em ambos, a decisão de merge continua com a equipe.

Existe revisão de código com IA sem plano de equipe?

Segundo a documentação do Claude, o /code-review funciona em qualquer plano, e o uso entra no consumo do plano ou na cobrança da API. A revisão do Copilot está nos planos pagos, e o plano Free não a inclui. Os preços e limites mudam, então confira as páginas oficiais antes de decidir.

A revisão com IA funciona no GitLab?

O serviço gerenciado da Claude é para repositórios no GitHub. O /code-review com –comment publica uma nota em merge requests do GitLab pelo glab (Claude Code v2.1.257 ou superior), e a documentação também cita o Claude no GitLab CI/CD. A página do Copilot não lista GitLab entre os locais compatíveis.

Posso escolher o modelo que faz a revisão?

No serviço gerenciado da Claude, não: o serviço escolhe os modelos e você controla a profundidade pelo nível Quick, Standard ou Deep. No Copilot, a documentação diz que a troca de modelo não é suportada na revisão de código. No /code-review, o resultado depende do modelo e do nível de esforço da sua sessão.

Conclusão: escolha pelo contexto e mantenha a pessoa no comando

Para a revisão de código com IA em pull requests, a pergunta útil não é qual ferramenta é melhor, e sim qual cabe no seu repositório, no seu plano e no seu processo. Dev solo e freelancer costumam começar pelo comando local. Equipes no GitHub comparam o serviço gerenciado da Claude e o Copilot pelos critérios da tabela. Equipes no GitLab olham o comando com --comment ou um pipeline próprio. Em todos os casos, escreva as regras, comece pequeno, registre o que foi útil e deixe a decisão final com uma pessoa.

Fontes (páginas oficiais consultadas em 16/11/2026)