Ú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.

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.
| Caminho | O que dispara a revisão | Onde roda | Quem pode usar | Hospedagem do código |
|---|---|---|---|---|
1. /code-review no Claude Code | Você digita o comando | Na sua sessão do Claude Code | Qualquer plano, segundo a documentação | Revisa a sua branch ou um PR; com --comment publica no GitHub (PR) ou no GitLab (merge request) |
| 2. Code Review gerenciado da Claude | Atividade no PR, conforme o repositório, ou o comentário @claude review | Infraestrutura da Anthropic | Organizações Team e Enterprise, depois que um Owner ativa | GitHub, incluindo GitHub Enterprise Server e Cloud |
| 3. GitHub Copilot code review | Você atribui o Copilot como revisor, ou a revisão automática configurada | Plataforma do GitHub | Planos pagos do Copilot | GitHub.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 request | Seus próprios runners | Quem tem chave de API ou credenciais de nuvem | GitHub 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.
| Perfil | Caminho que costuma caber primeiro | Por quê, segundo a documentação | Atenção |
|---|---|---|---|
| Dev solo | 1, e o 3 se já tem plano pago do Copilot | O /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 |
| Freelancer | 1, antes de abrir o PR | Roda na sua máquina e não depende de o cliente ativar nada no repositório | O 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 GitHub | 2 ou 3, ativado por quem administra | O 2 é ativado por um Owner da organização Claude (Team ou Enterprise). O 3 depende da política do Copilot da organização | Decida 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 GitLab | 1 com --comment, ou 4 | O 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
- Escolha um repositório e um tipo de PR de risco baixo. Evite começar por pagamento ou autenticação.
- 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).
- Mantenha o PR pequeno e explique o porquê na descrição. A IA e o revisor humano erram menos quando o objetivo está escrito.
- Leia o PR antes de ler os comentários da IA. Assim você não é conduzido pelo que ela apontou.
- Marque cada comentário como útil, irrelevante ou errado. Esse registro é a única medida honesta de que a revisão está ajudando.
- 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.
- Abra o Claude Code na pasta do projeto.
- Rode
/code-review. Sem alvo, ele cobre os commits da branch à frente do upstream mais as mudanças ainda não commitadas. - 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. - Escolha o nível de esforço se quiser:
/code-review high 1234. No nívellow, ele reporta só o que tem mais confiança, com menos falsos positivos. Demediumatémax, a cobertura aumenta. - Leia os achados antes de qualquer correção. Use
--fixapenas 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--commentpara 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ço | Faixa típica por revisão | Média aproximada por revisão |
|---|---|---|
| Lite | US$ 0,05 a US$ 1 | US$ 0,25 |
| Balanced | US$ 0,25 a US$ 5 | US$ 1,50 |
| Max | US$ 1,50 a US$ 25 | US$ 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.
| Caminho | O que lê e de onde |
|---|---|
1. /code-review | O CLAUDE.md. Não lê o REVIEW.md |
| 2. Code Review gerenciado da Claude | O 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 review | Instruçõ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çõesModelo 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 outro | Confirmado: cita as duas chamadas, com arquivo e linha, que usam ordens diferentes |
| O carrinho vazio não é tratado | Confirmado: a função divide pelo total sem checar se ele é zero |
| Possível injeção de SQL na busca do cupom | Falso 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
| Erro | Por que acontece | Como corrigir |
|---|---|---|
| Tratar PR sem comentários como PR sem bugs | A documentação avisa que a IA pode deixar passar problemas | Faça a leitura humana de sempre e confira se os testes realmente falhariam com o código errado |
| PR grande demais | A revisão fica ruidosa e cara | Divida o PR ou explique na descrição por que não dá |
| Nenhuma regra escrita | Sem contexto, os comentários ficam genéricos | Escreva de 5 a 10 regras verificáveis no arquivo do seu caminho |
| Revisão a cada push sem olhar o custo | No 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 ativa | Comece com uma revisão por PR e peça outras manualmente |
| Esperar que a IA bloqueie o merge | O serviço da Claude não bloqueia, e o Copilot só conta como aprovação se a organização ativar | Defina na equipe quem trata os achados e use a proteção de branch do seu repositório |
| Mudar o REVIEW.md no PR revisado | O serviço lê o arquivo da branch base ou padrão | Faça o merge da mudança de regra antes e avalie o PR seguinte |
Aplicar --fix sem ler o diff | As edições passam pelo modo de permissão, mas continuam sendo mudanças no seu código | Leia 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)
- Claude Code Docs: Code Review (visão geral, seções Availability, How reviews work, Who controls a review e Compare ways to get a review)
- Claude Code Docs: Customize Code Review (REVIEW.md, CLAUDE.md e qual branch é lida)
- Claude Code Docs: Code Review costs and usage
- Claude Code Docs: Review locally with /code-review
- Claude Code Docs: Commands (/code-review e ultrareview)
- Claude: Code Review is now generally available (post de 15/10/2026)
- GitHub Docs: GitHub Copilot code review

