Objetivo: ao final, o consultor sabe o que o Code Review gerenciado faz num PR, o que ele deliberadamente não faz, quanto custa por revisão, e como calibrar o que ele reclama com um REVIEW.md.
CLAUDE.md (contexto de projeto; violação nova vira nit) e REVIEW.md (instrução de prioridade máxima, só para revisão).Exige papel de Owner ou Primary Owner na organização Claude, mais permissão para instalar GitHub App na organização do GitHub.
| Comportamento | Quando revisa | Custo relativo |
|---|---|---|
| Once after PR creation | Uma vez, quando o PR abre ou sai de draft | 1 revisão por PR |
| After every push | A cada push no branch do PR — resolve sozinho as threads que você corrigiu | Multiplica pelo número de pushes — o mais caro |
| Manual | Só quando alguém comenta @claude review |
Zero até alguém pedir |
Para repositório movimentado, Manual é a escolha sensata: você escolhe quais PRs valem revisão.
| Comando | O que faz |
|---|---|
@claude review |
Uma revisão, sem inscrever o PR em revisões futuras |
@claude review always |
Revisa e inscreve o PR para revisar a cada push seguinte |
@claude review once |
Igual ao comando puro |
Precisa ser comentário de topo do PR (não inline numa linha do diff), com o comando no início. Exige acesso de owner, member ou collaborator. Funciona em PR em draft — pedido explícito vence o status de draft.
Atenção: antes de uma atualização de julho de 2026, o
@claude reviewpuro inscrevia o PR em revisões por push. Hoje não inscreve mais. Se algum processo da Wayon dependia daquele comportamento, passe a usar@claude review always.
| Lugar | O que tem |
|---|---|
| Comentário inline, na aba Files changed | O achado na linha exata, com seção de raciocínio expansível |
| Check run → Details | Tabela-resumo de todos os achados por severidade, com arquivo e linha |
| Anotações na aba Files changed | Marcadas no diff, independentes do comentário inline |
Isso importa por um motivo prático: se o PR recebeu push enquanto a revisão rodava, alguns achados apontam para linhas que já não existem. Eles aparecem sob Additional findings no corpo da revisão, não como comentário inline. Se o check run diz que achou coisa e você não vê nada no diff, procure nos outros dois lugares.
O check run é sempre neutro por desenho. Mas a última linha do texto de Details é um comentário legível por máquina, então o seu próprio CI pode ler a contagem por severidade e decidir:
gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
--jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'
Devolve algo como {"normal": 2, "nit": 1, "pre_existing": 0} — normal é a contagem de Important. Diferente de zero significa que há bug que vale corrigir antes do merge.
@claude review.Os achados vêm com 👍 e 👎 já anexados. Clicar ajuda a calibrar o revisor e não dispara nova revisão.
Regra Wayon Duas decisões antes de habilitar em repositório de cliente: (1) configurar o teto de gasto mensal em
claude.ai/admin-settings/usage— a US$ 15–25 por revisão, no modo "a cada push", um repositório movimentado consome rápido, e o custo é fora da franquia do plano; (2) confirmar a cláusula de dados do contrato — se o cliente exigir Zero Data Retention, o recurso não está disponível, e prometê-lo em proposta seria erro. Vale acompanhar o gasto em claude.ai/analytics/code-review.