Revisão de código no Claude Code: /code-review, skills e effort
Como funciona o comando /code-review integrado: aponte para uma branch ou PR, leia achados classificados com prova e impacto, ajuste o effort e o --max-findings e coloque a revisão em todo pull request.
Resumão
- A revisão já vem integrada — o /code-review (ou o apelido /review) examina os commits em que sua branch está à frente do upstream mais as mudanças não commitadas, em segundo plano.
- Os achados vêm classificados — Important, Nit, Pre-existing — cada um com prova concreta, impacto e uma correção que você aplica com --fix.
- A profundidade é um dial: o effort low, medium, high e max fica lembrado entre sessões, o ultra escala para uma ultrareview na nuvem e o --max-findings (v2.1.288+) limita ou amplia o relatório.
- No GitHub, o app da Claude revisa PRs no seu gatilho e comenta inline; o check run sempre fecha neutro, então nenhum merge é bloqueado.
Introducing Code Review
Canal: Anthropic · Claude0:45
Anthropic's NEW Claude Code Review Agent
Canal: Patrick Ellis29:56
Claude Code release notes — v2.1.288
Notas de versão: github.com/anthropics/claude-code
Review pull requests with Claude Code — official docs
Documentação: code.claude.com/docs
Os fatos desta página foram conferidos com a documentação oficial de code review e o changelog da v2.1.288; os frames vêm dos dois vídeos acima, checados um a um. O comportamento descrito corresponde ao Claude Code v2.1.288 (outubro de 2026).
As capturas são frames do “Introducing Code Review” da Anthropic e do “Anthropic's NEW Claude Code Review Agent” de Patrick Ellis, usados com atribuição e linkados de volta ao timestamp de origem em cada passo.
Revisão de código, passo a passo
Rodar a revisão
- 1
Atualize o Claude Code e rode o comando
A revisão já vem integrada — nenhum plugin para instalar. Atualize para a v2.1.288 ou mais nova para ter as flags novas, digite /code-review (a grafia antiga /review hoje é um apelido) e dê enter. A revisão começa em segundo plano e você segue trabalhando.
A Anthropic anunciou o revisor integrado com um cartão de título próprio.Ver em 0:07 - 2
Aponte a revisão para o diff certo
Sem argumentos, o /code-review examina os commits em que sua branch está à frente do upstream mais suas mudanças não commitadas. Para mirar outra coisa, passe um caminho de arquivo, um número de PR, uma branch ou um intervalo como main...my-feature.
Escolha o repo e descreva a tarefa antes de a sessão de revisão começar.Ver em 0:08 - 3
Deixe rodar em segundo plano
A revisão é um agente próprio: seu prompt fica livre enquanto ela lê o codebase. Rode /code-review de novo para trazer uma revisão em andamento de volta ao primeiro plano, ou force o primeiro plano com o modo print ou CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1.
O status Starting Claude Code significa que a revisão já saiu rodando.Ver em 0:12 - 4
Leia achados classificados com prova e impacto
Cada achado vem marcado Important, Nit ou Pre-existing e mostra prova concreta, impacto e correção sugerida — na demo oficial, um bug de IDOR avaliado como CVSS 9.1 Critical é pego num pull request de verdade.
Prova, impacto e correção de um achado, do jeito que o bot publica.Ver em 0:23
Transformar achados em correções
- 5
Leve os achados para o pull request
Adicione --comment para publicar cada achado como comentário inline na PR do GitHub (MRs do GitLab vão por glab a partir da v2.1.257). O app GitHub da Claude deixa os achados do mesmo jeito quando a revisão roda no github.com.
O bot da Claude comenta sob o diff, com botão de resolver por thread.Ver em 0:18 - 6
Aplique as correções com --fix ou um colar
Rode /code-review --fix e os achados aceitos entram na sua árvore de trabalho. Ou cole uma sugestão de volta na sua sessão — na demo, a sessão edita o arquivo e vai ticando os todos sem babá eletrônica.
A sessão percorre a lista de correções todo por todo enquanto você assiste.Ver em 0:14 - 7
Revise de novo até o diff convergir
Rodar /code-review depois das correções re-checa o que mudou, então a segunda passada é barata — as re-reviews recebem ordem de convergir, não de reabrir discussão. Quando todo o checklist estiver ticado, faça push e abra o PR na mesma sessão.
Todas as tarefas completas e a sessão pronta para criar o PR.Ver em 0:24 - 8
Limite ou amplie com --max-findings
Novo na v2.1.288: /code-review --max-findings 5 ou --max-findings all substitui o limite de sempre, e a escolha vale para as revisões seguintes até você passar --max-findings default para restaurar.
Um achado crítico publicado com severidade, prova e correção sugerida.Ver em 0:20
Ajustar profundidade, automação e regras
- 9
Suba o effort no máximo, ou vá de ultra
As revisões aceitam effort low, medium, high e max — e ficam lembrando sua última escolha entre sessões: digite uma vez. O /code-review ultra escala para uma ultrareview na nuvem; combine com /code-review ultra --fix, ou pilote pela CI com claude ultrareview.
A profundidade da revisão fica num dial, colado ao seletor de modelo.Ver em 0:04 - 10
Instale o app GitHub da Claude para cada PR
Um Owner pode ativar o Code Review nas configurações de admin, o que instala o app GitHub da Claude. Escolha um gatilho por repo — uma vez após criar a PR, após cada push ou manual — e comente @claude review em qualquer PR aberta.
Um clique em Setup autoriza o app GitHub da Claude a ler código.Ver em 0:02 - 11
Ensine suas regras da casa
Todo CLAUDE.md do caminho é seguido e violações novas saem como nits. A revisão hospedada também lê um REVIEW.md na raiz do repo — redefinição de severidades, teto de nits, regras de exclusão, barra de verificação — e o skillOverrides pode reservar a skill para execuções manuais.
Uma rubrica de revisão de segurança em markdown, direto do repo da Anthropic.Ver em 18:30
/code-review vs /review vs /security-review vs /simplify vs ultra
O Claude Code traz uma pequena família de comandos de revisão, fáceis de confundir. Aqui é quando cada um é a resposta certa.
- 1/code-review — a caça a bugs padrão. Examina os commits à frente do upstream mais as mudanças não commitadas, classifica achados por severidade e roda em segundo plano enquanto você trabalha.
- 2/review — o mesmo comando. Desde a v2.1.223, /review é apelido de /code-review; antes, era uma revisão de PR separada, de uma passada e somente leitura — por isso tutoriais antigos a descrevem de outro jeito.
- 3/security-review — a passada focada em segurança, construída com o playbook open source da Anthropic. Caça só vulnerabilidades — na demo do Patrick Ellis, pegou uma fake API key plantada — e também vem com o Claude Code.
- 4/simplify — limpeza, não caça a bugs. Aplica refactors diretos e formatação sem julgar correção. Se você tinha um script antigo com /simplify para achar bugs, aponte esse script para /code-review --fix.
- 5ultra — a escalada para a nuvem. O /code-review ultra manda o diff inteiro da branch contra a branch padrão para uma revisão mais profunda na nuvem; encadeie com --fix para aplicar localmente, ou rode claude ultrareview pela CI.
A divisão prática: /code-review é seu loop interno padrão enquanto programa, /security-review vale ouro em auth, pagamentos e tudo que toca token, e ultra fica para as migrações arriscadas que você pediria a um colega para revisar. Limpeza puramente estilística é trabalho do /simplify — revisão que nada.
Revisão calada, tagarela ou sumida no GitHub? Primeiros socorros
Quase todo problema de revisão de código se resolve com uma linha. Percorra esta lista antes de mexer nas configurações.
- 1“Unknown command” ou comportamento igual ao de tutoriais antigos — atualize o Claude Code. --max-findings pede v2.1.288+, o apelido /review veio na v2.1.223 e --comment em MR do GitLab pede v2.1.257+.
- 2A revisão termina e “não acha nada” — o limite padrão deixa os relatórios curtos. Rode de novo com --max-findings all para levantar o limite e fique de olho nos marcadores Nit e Pre-existing em vez de esperar um Critical.
- 3Ela sumiu no segundo plano — é de propósito. Rode /code-review de novo para se reconectar à revisão em andamento, ou defina CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 se a quer sempre em primeiro plano.
- 4Parece que ignora suas regras — o /code-review local segue o CLAUDE.md mas nunca lê o REVIEW.md, que é da revisão hospedada no GitHub. Checklists do repo vão no REVIEW.md; estilo pessoal ou de projeto, no CLAUDE.md.
- 5Pull requests sem revisão no GitHub — confira o gatilho do repo (uma vez após criar a PR, cada push, manual), confirme que quem comenta tem acesso write ou maior, e lembre: PRs de fork só são revisadas após um comentário explícito de @claude review.
Mais uma pegadinha: o check run sempre se chama Claude Code Review e sempre fecha com conclusão neutra, então a proteção de branch nunca vai bloquear um merge por causa dele. Quer travar mesmo? Faça parse da linha de resumo bughunter-severity do check run no seu próprio job de CI e derrube o build com achados Important.