Revisão de código no GitHub do Claude Code: bot vs. revisão local

- Preço, status de research preview e a tabela de severidade abaixo foram conferidos diretamente com code.claude.com/docs/en/code-review no momento em que escrevo (2026-08-20); a Anthropic sinaliza que este recurso muda rápido, então confirme a documentação ao vivo antes de depender de números exatos.

O que o bot nativo de GitHub Code Review realmente é

É um GitHub App que um Owner instala no nível da organização, escolhendo quais repositórios o recebem. Uma vez habilitado, as revisões disparam automaticamente quando um PR é aberto, a cada push, ou quando alguém comenta @claude review em um PR - dependendo de como o gatilho de cada repositório está configurado.

Quando uma revisão roda, vários agentes analisam o diff em paralelo, cada um procurando uma classe diferente de problema, no contexto de toda a sua base de código. Em seguida, uma etapa de verificação confere os candidatos contra o comportamento real do código para filtrar falsos positivos. Os resultados são deduplicados, ordenados por severidade e postados como comentários inline nas linhas exatas onde os problemas foram encontrados, com um resumo no topo. Junto disso, um check run chamado Claude Code Review aparece ao lado das suas outras verificações de CI - se nada foi encontrado, o check run também é atualizado para dizer isso. Fonte: code.claude.com/docs/en/code-review.

Além dos comentários inline, a visão Details do check run lista todos os achados em um só lugar, ordenados por severidade - uma linha 🔴 Important apontando, por exemplo, para src/auth/session.ts:142 logo acima de uma linha 🟡 Nit algumas linhas abaixo - útil quando você quer os achados do PR inteiro em uma tela só, em vez de rolar o diff. Os mesmos achados também aparecem como anotações direto na aba Files changed. Se você faz um novo commit enquanto uma revisão ainda está analisando um diff mais antigo, uma linha sinalizada que se moveu não some simplesmente - ela reaparece sob um título Additional findings no corpo da revisão.

Bot vs. /code-review local - a comparação que mais ninguém faz

A maior parte do que se escreve sobre esse recurso ou descreve só o bot, ou o compara com ferramentas SaaS de terceiros. Quase ninguém o coloca lado a lado com o comando de revisão gratuito que o Claude Code já traz. Aqui vai a comparação direta:

Se você também usa o Codex, o comando de revisão equivalente é /review - presets diferentes, configuração diferente - tratado à parte em Codex Code Review (/review).

Os níveis de severidade, explicados

Cada achado recebe exatamente uma de três tags, exatamente como está na documentação:

Cada achado também traz uma seção de raciocínio recolhível explicando por que o Claude o sinalizou e como verificou o problema. Você pode reagir com 👍/👎 direto em um comentário - a Anthropic agrega essas reações depois que o PR é mesclado para ajustar o revisor, embora uma reação não dispare uma nova revisão nem mude nada no próprio PR.

REVIEW.md - como ajustar o que é sinalizado

O REVIEW.md fica na raiz do seu repositório e é injetado direto no system prompt de cada agente do pipeline de revisão, como o bloco de instruções de maior prioridade, sobrescrevendo a orientação de revisão padrão. Como ele é colado literalmente, a sintaxe de import @path não é expandida dentro dele - tudo o que você quer que o revisor saiba precisa ser escrito diretamente no arquivo.

O CLAUDE.md continua sendo lido junto, mas só como contexto do projeto, e violações recém-introduzidas recebem no máximo a tag Nit, nunca mais alta. Ele também funciona nos dois sentidos: se o seu PR deixa uma afirmação do CLAUDE.md desatualizada, o Claude sinaliza que a documentação também precisa ser atualizada.

A parte fácil de passar batido: o comando local /code-review NÃO lê o REVIEW.md. Ele só segue o CLAUDE.md, igual a qualquer sessão normal do Claude Code. Se você quer ajustar especificamente o bot gerenciado, o REVIEW.md é o único arquivo que tem algum efeito ali.

Um exemplo condensado, parafraseado da documentação (redefine Important, limita os nits, ignora arquivos gerados):

# Review instructions

## What Important means here
Reserve Important for findings that would break behavior, leak data,
or block a rollback. Style/naming/refactor suggestions are Nit at most.

## Cap the nits
Report at most 5 Nits per review; roll up the rest as "plus N similar items"
in the summary.

## Do not report
- Anything CI already enforces: lint, formatting, type errors
- Generated files under src/gen/ and any *.lock file

Configuração - como um Owner ativa

Vá em claude.ai/admin-settings/claude-code, encontre a seção Code Review - você precisa do papel de Owner ou Primary Owner na sua organização Claude, além de permissão para instalar GitHub Apps na sua org do GitHub. Clique em Setup para iniciar o fluxo de instalação do GitHub App: escolha a org do GitHub que é dona dos seus repos, selecione quais repos ele pode acessar e aprove as permissões solicitadas. Depois de instalado, selecione quais repos habilitar e, para cada um, escolha um Review Behavior: Once after PR creation, After every push, ou Manual (só roda quando alguém comenta @claude review).

Condição importante: isto não é algo que um dev solo no Pro/Max consiga habilitar sozinho - exige uma organização Team/Enterprise, e alguém precisa ter o papel de Owner.

Uma vez rodando, os Owners podem acompanhar a adoção pelo painel de analytics em claude.ai/analytics/code-review: PRs revisados por dia, gasto semanal e quantos comentários de revisão foram resolvidos automaticamente porque alguém corrigiu o problema sinalizado, tudo detalhado por repositório. Trate os números do painel como estimativas para identificar tendências - para um gasto preciso de fatura, confira a sua conta real da Anthropic.

Preço - quanto custa de verdade

Cada revisão custa em média US$ 15-25, cobrado pelo uso real de tokens, escalando com o tamanho do PR e a complexidade da base de código. Esse custo é cobrado à parte por usage credits e não conta contra o uso incluído no seu plano Team/Enterprise. A sua escolha de gatilho multiplica o total de forma notável: Once after PR creation roda exatamente uma vez por PR, Manual só roda quando alguém comenta, e After every push roda de novo a cada push - o mais caro dos três. As orgs podem definir um teto de gasto mensal em admin settings; quando ele é atingido, as revisões pausam e recomeçam automaticamente no próximo período de faturamento (ou na hora, se um admin aumentar o teto).

Para comparar: o comando local /code-review não custa nada além do uso que você já está pagando.

Ele bloqueia o merge?

Não - nunca. O check run sempre termina com uma conclusão neutra, então a branch protection não consegue gatilhá-lo diretamente, mesmo que você quisesse. Esse é um detalhe genuinamente surpreendente para um time avaliando isso como um portão de merge rígido: para de fato impor um, você tem que fazer o parse do detalhamento de severidade legível por máquina no fim da saída do check run, você mesmo, no seu próprio CI, por exemplo:

gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
  --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'
# => {"normal": 2, "nit": 1, "pre_existing": 0}

A chave normal é a contagem de achados Important; um valor diferente de zero significa que há pelo menos um bug que vale corrigir antes do merge.

Mais uma nuance que vale conhecer: as revisões são best-effort. Se a execução bate em um erro interno ou dá timeout, o título do check run muda para Code review encountered an error ou Code review timed out - mas a conclusão continua neutra de qualquer jeito, então uma execução com falha não te bloqueia mais do que uma limpa. Comente @claude review para tentar de novo; o botão Re-run na própria aba Checks do GitHub não redispara o Code Review.

Uma terceira opção - um revisor local e personalizável

Além do bot gerenciado e do comando local gratuito, existe um terceiro caminho que vale nomear com honestidade: o Engineer Kit da AgentKit traz um agente de revisão local (code-reviewer), invocado via /ak:review - parecido com rodar o /code-review, mas empacotado junto com os outros agentes/fluxos do kit e personalizável ao jeito que você define o seu processo, sem ficar preso a Team/Enterprise e sem cobrança por revisão - é um preço único do kit, em vez disso. Isto não é uma alegação de paridade de recursos com o próprio bot da Anthropic - é só um terceiro ponto de comparação honesto para quem não quer nenhuma das outras duas. Para o comando local em profundidade, veja o passo a passo do /code-review local. Para uma visão geral do produto, leia a análise da AgentKit.

Qual você deveria usar?

Não são mutuamente exclusivos - muitos times usam mais de um:

• Dev solo, qualquer plano: o comando local /code-review - gratuito, suficiente.
• Time querendo cobertura automática em todo PR sem ensinar um comando: o bot gerenciado - reserve US$ 15-25/revisão no orçamento.
• Quer um revisor personalizável sem cobrança por revisão, em qualquer plano: o agente de revisão baseado em kit.

Perguntas frequentes (FAQ)

O que é o GitHub Code Review nativo do Claude Code?

Um bot de GitHub App, habilitado por um Owner da organização, que revisa automaticamente os pull requests no GitHub e posta comentários inline marcados por severidade. Atualmente está em research preview.

É gratuito?

Não. A média é de US$ 15-25 por revisão, cobrado à parte por usage credits, sem contar contra o uso incluído no seu plano. O comando local /code-review é a opção gratuita.

Quais planos têm Code Review?

Só Team e Enterprise (research preview), e ele fica indisponível para organizações com Zero Data Retention ativado. Pro/Max não conseguem habilitar o bot sozinhos, mas todo plano pode usar o comando local /code-review.

Ele bloqueia o merge?

Nunca. O check run sempre termina com uma conclusão neutra, então a branch protection não consegue gatilhá-lo diretamente - um portão rígido exige fazer o parse do detalhamento de severidade legível por máquina você mesmo no CI.

Qual a diferença entre REVIEW.md e CLAUDE.md?

O REVIEW.md é só para revisão e é injetado como a instrução de maior prioridade em cada agente de revisão. O CLAUDE.md é contexto geral do projeto, e novas violações ali só recebem a tag Nit. O comando local /code-review lê o CLAUDE.md, mas não o REVIEW.md.

Posso usar o comando local /code-review no lugar?

Pode, e é gratuito em todo plano. O trade-off: você tem que rodar por conta própria, não ganha a cobertura automática em todo PR do jeito que o bot oferece, e ele não lê o REVIEW.md.

Conclusão

Três opções, três situações: o bot de GitHub Code Review é research preview no Team/Enterprise, US$ 15-25/revisão, e nunca bloqueia um merge; o comando local /code-review é gratuito em todo plano, mas você roda por conta própria; o agente de revisão baseado em kit é a opção personalizável e de preço único. Quer o comando local em profundidade? Veja revisão de código com IA usando o /code-review. Precisa de uma camada de revisão totalmente diferente, focada em segurança? Veja auditorias de segurança com o /security-review.