![Imagem de capa de [Claude Code #9] /code-review, de low a ultra](/assets/images/posts/3a3c5139-78d7-4952-be11-c771eeb272d4/claude-code-review-effort-levels.jpg)
Às vezes dá insegurança fazer commit do código gerado por IA sem alterações. Antes de chamar uma pessoa para revisar, é útil ter uma etapa de filtragem.
O /code-review do Claude Code cumpre esse papel. Ele inspeciona as alterações da branch atual e encontra bugs e pontos que podem ser limpos.
Neste artigo, vamos organizar os níveis passo a passo, da intensidade ajustável localmente à inspeção ultra detalhada na nuvem.
Os níveis de effort apresentados em Claude Code, parte 8 também são usados para definir a intensidade da revisão.
O comportamento padrão inspeciona as alterações da minha branch
A revisão começa quando você digita /code-review na sessão.
De acordo com Documentação oficial, o alvo padrão são os commits da branch que está à frente de upstream e as alterações ainda não commitadas. Ele relata bugs de correção e oportunidades de reutilização, simplificação e melhoria de eficiência.
Também é possível especificar outros alvos: caminhos de arquivos, números de PR, nomes de branches e intervalos como main...my-feature.
Por padrão, a revisão é executada por um subagente em segundo plano, no próprio contexto. Ela não ocupa sua conversa e, quando termina, apenas os resultados retornam.
Níveis: confiança ou cobertura
Adicionar um nível de effort, como /code-review high, altera a intensidade da revisão.
- low·medium: relata apenas os achados mais confiáveis. Menos falsos positivos
- high·xhigh·max: amplia a cobertura. Achados menos confiáveis também podem ser incluídos
Se você omitir o nível, o último nível digitado manualmente será reutilizado. A interface também exibe um aviso como “Reutilizando o nível high digitado anteriormente”.
Apenas encontrar problemas ou também corrigi-los?
--fix: aplica os achados diretamente à árvore de trabalho quando a revisão termina--comment: publica os achados como comentários inline no PR
--fix tem um ponto de atenção. As alterações da revisão em segundo plano acontecem fora do checkpoint da sessão, então não podem ser desfeitas com /rewind. Se você não gostar delas, terá de revertê-las com git.
ultra: revisão multiagente na nuvem
O /code-review ultra trabalha em outra escala. É um ultrareview no qual vários agentes investigam em paralelo na nuvem.
O escopo também muda. Ele compara a branch atual com a branch padrão do repositório e inclui alterações não commitadas. Também é possível trocar a branch de referência, como em /code-review ultra develop.
Documentação oficial do ultrareview exige autenticação com uma conta do claude.ai. Pro·Max pode executar 3 revisões gratuitamente; depois disso, cada revisão consome cerca de 5 a 25 dólares em créditos de uso.
Quando o alvo é um PR do github.com, o diálogo antes da execução mostra a opção de publicar o resultado como comentário na sua conta. Ao adicionar --post, essa opção fica pré-selecionada, mas ainda é preciso confirmar mais uma vez se deseja publicar (v2.1.227 ou posterior).
Para commits do dia a dia, os níveis locais são suficientes; para momentos importantes, como a checagem final antes de um release, o ultra é mais adequado. Em ambientes que não suportam ultra, como o Bedrock, esse comando faz fallback silenciosamente para uma revisão local.
Diferenças em relação aos comandos semelhantes
Há mais dois comandos com nomes parecidos.
/simplify: comando exclusivo de limpeza que apenas organiza e simplifica, aplicando as correções sem caçar bugs/security-review: concentra a inspeção exclusivamente nas vulnerabilidades de segurança das alterações
Use /code-review para encontrar bugs e /simplify para melhorar o código.
Ajustando os critérios da revisão
As revisões locais seguem as regras do projeto em CLAUDE.md, como qualquer outra sessão. Se você registrar as convenções da equipe no CLAUDE.md, elas também serão consideradas nas revisões.
Também existe o Code Review gerenciado para adicionar revisões automáticas aos PRs do GitHub, exclusivo de Team·Enterprise. Nesse caso, os critérios são ajustados pelo arquivo dedicado REVIEW.md, mas o /code-review local não lê esse arquivo.
Resumo
Como hábito antes do commit, /code-review já é suficiente. Use low·medium para priorizar confiança e high ou superior para fazer uma varredura mais ampla.
Para delegar também as correções, use --fix; para uma revisão detalhada antes do release, aumente para ultra.
Na próxima parte, veremos um conjunto de comandos de diagnóstico para examinar o estado da sessão, incluindo /doctor, /context e /usage.
Fontes e critérios de verificação
- Documentação oficial do Claude Code — Code Review (Anthropic, verificado em 2026-08-14)
- Documentação oficial do Claude Code — Ultrareview (Anthropic, verificado em 2026-08-14)
Continue lendo
Série Claude Code
- Parte anterior: [Claude Code #2] /plan, modo de planejamento: alinhe o design antes de fazer alterações
- Parte anterior: [Claude Code #1] /init, comece gerando o CLAUDE.md automaticamente