Revise localmente com /code-review

Execute /code-review em uma sessão do Claude Code para encontrar bugs nas alterações do seu branch, direcionar a revisão para um pull request ou caminho e fazer o Claude aplicar as correções.

/code-review é um comando que você digita no prompt do Claude Code, na sessão em que está trabalhando. O Claude revisa as alterações no seu branch, procura bugs de correção e relata o que encontrou na sua conversa. Dependendo do seu modelo e nível de esforço, a revisão também abrange limpezas de reutilização, simplificação e eficiência.

O comando funciona em qualquer plano. A revisão é executada na sua própria sessão, portanto conta para o uso do seu plano ou para o faturamento da API da mesma forma que o restante da sessão.

/review é um alias de /code-review. Antes da v2.1.223, /review era um comando separado que executava uma revisão somente leitura, em passagem única, de um pull request do GitHub.

/code-review

Escolha o que revisar

Para revisar algo diferente do seu branch atual, digite um alvo após o nível de esforço e quaisquer flags. O Claude recebe esse texto como o alvo da revisão. Um alvo pode ser um número de pull request, um nome de branch, um caminho de arquivo ou um intervalo de revisões do Git. Encontre o que você deseja revisar na primeira coluna e digite o que a segunda coluna mostra:

Sem um alvo, /code-review revisa os commits do seu branch à frente do branch upstream, além das suas alterações não commitadas. Se o branch não tiver upstream, o Claude compara com main ou com o commit anterior.

Com ultra, o Claude Code interpreta o alvo de forma diferente, conforme descrito em Texto após o nível de esforço e as flags.

O que a revisão lê e edita

Verifique estes pontos antes de executar uma revisão, especialmente com --fix:

• Edições: sem --fix, as instruções da revisão pedem ao Claude apenas um relatório. Com --fix, elas também pedem que ele aplique as descobertas à sua árvore de trabalho. De qualquer forma, qualquer edição passa pelo seu modo de permissão.
• Retrocesso: uma revisão em segundo plano aplica suas edições de --fix fora dos checkpoints da sua sessão. Depois de uma delas, /rewind restaura apenas os arquivos que o Claude já havia editado na sua conversa. As edições da revisão em outros arquivos permanecem, então use o git para revertê-las. Quando a revisão é executada em primeiro plano, ela edita sua árvore de trabalho durante o seu próprio turno, então /rewind restaura suas edições normalmente.
• Instruções: a revisão segue o seu CLAUDE.md, inclusive em uma execução não interativa com -p. Ela não lê REVIEW.md. Esse arquivo configura o serviço Code Review gerenciado em pull requests do GitHub.

Como as descobertas são relatadas

O Claude relata as descobertas como texto na resposta em ambas as execuções a seguir:

• Em uma sessão de terminal, em que /code-review executa a revisão como um subagente bifurcado
• Em uma execução com -p com saída em texto ou JSON

Em um aplicativo host que solicita a lista de descobertas, como o aplicativo desktop, o Claude relata as descobertas da revisão por meio da ferramenta ReportFindings. O relatório aparece como uma lista de descobertas, e cada entrada mostra a localização do arquivo, um resumo de uma frase e uma tag de categoria como correctness quando a descoberta tiver uma. Uma requisição do host se aplica a todos os níveis de esforço e requer o Claude Code v2.1.218 ou posterior.

Quando o Claude corrige as descobertas relatadas mais adiante na sessão, ele as relata novamente. O Claude Code então marca cada descoberta na lista atualizada como corrigida, ignorada ou sem necessidade de alteração.

Ajuste o esforço e os argumentos

Além de --fix e --comment, o comando aceita estas flags:

• --post: em uma revisão ultra na nuvem de um pull request do github.com, pré-seleciona a publicação das descobertas finalizadas no PR na caixa de diálogo de inicialização. Consulte Publicar descobertas no pull request. Requer o Claude Code v2.1.227 ou posterior.
• --max-findings <n>, --max-findings all ou --max-findings default: relata até n descobertas, ou todas as descobertas com all, no lugar do limite habitual da revisão. Onde a revisão relata por meio da ferramenta de descobertas, o limite é 32. Revisões posteriores reutilizam o valor que você digitou até que você passe --max-findings default, mas um valor passado em uma execução não interativa com -p não é lembrado. Requer o Claude Code v2.1.288 ou posterior.

Passe um nível de esforço para equilibrar cobertura e confiança. Em low, a revisão relata as descobertas das quais tem mais confiança, então você vê menos falsos positivos. De medium até max, a revisão amplia a cobertura.

Quando você não digita um nível, a revisão reutiliza o último nível de low a max que você digitou, mesmo em uma sessão anterior. O Claude Code mostra um aviso como Reusing high effort, the level you typed last time. Estas regras decidem qual nível uma execução usa:

• Digitar um nível: um nível que você digita, como /code-review high, altera o que as execuções posteriores reutilizam
• Execuções não interativas: um nível que você passa em uma execução não interativa com -p não atualiza o nível lembrado
• ultra: a revisão não usa nem atualiza o nível lembrado
• Nenhum nível jamais digitado: a revisão usa o esforço atual da sessão

Antes da v2.1.223, um /code-review sem nível sempre usava o esforço atual da sessão.

Publicar descobertas em um merge request do GitLab

Quando você passa --comment para um merge request do GitLab, o Claude Code publica as descobertas por meio da CLI glab do GitLab. Requer o Claude Code v2.1.257 ou posterior. Quando o glab não está instalado, o Claude imprime as descobertas no terminal.

Passe o merge request como sua URL ou uma referência !123. O Claude Code trata um número simples ou nome de branch como um merge request somente quando a origem do checkout está no gitlab.com. Em uma instância autogerenciada do GitLab, passe a URL ou a forma !123.

Texto após o nível de esforço e as flags

Após o nível de esforço e as flags, o Claude Code lê o restante da linha como o alvo da revisão. O argumento ultra muda essa interpretação:

• Com ultra: o Claude Code lê uma única palavra como um branch base ou número de PR. Um texto mais longo que não nomeia um branch ou PR se torna uma nota anexada à revisão. /code-review ultra check my auth changes revisa seu branch atual, e o Claude relaciona as descobertas à sua nota.
• Sem ultra: tudo o que sobra é o alvo da revisão, mesmo quando começa com outro nome de comando. /code-review /fix-issue 123 revisa com /fix-issue 123 como texto do alvo, em vez de carregar /fix-issue como uma segunda skill empilhada. Antes da v2.1.218, um comando empilhado após /code-review era expandido como sua própria skill.

Executar em primeiro plano

Para fazer a revisão ser executada em primeiro plano, faça uma destas opções:

• Execute-a no modo não interativo, com a flag -p ou o Agent SDK. O Claude Code aguarda a revisão e inclui as descobertas na resposta, exceto com ultra, que não aguarda a revisão na nuvem.
• Defina CLAUDE_CODE_DISABLE_BACKGROUND_TASKS como 1, o que também desativa todos os outros recursos de tarefas em segundo plano
• Execute /code-review novamente enquanto uma revisão anterior ainda estiver em andamento

Antes da v2.1.218, a revisão era executada dentro da sua conversa.

Deixe o Claude iniciar a revisão

O Claude pode iniciar /code-review por conta própria, sem que você digite o comando:

• Quando você pede em linguagem simples: peça ao Claude para revisar suas alterações e ele pode executar a skill
• A partir de uma tarefa agendada: uma tarefa agendada com /code-review como prompt executa a revisão

Uma tarefa agendada nunca inicia a revisão na nuvem, então agende /code-review sem o argumento ultra.

Para impedir que tanto o Claude quanto as tarefas agendadas iniciem a revisão, mantendo /code-review disponível para você digitar, adicione uma entrada skillOverrides a um arquivo de configurações como ~/.claude/settings.json:

{
  "skillOverrides": {
    "code-review": "user-invocable-only"
  }
}

Antes da v2.1.246, o Claude iniciava /code-review por conta própria apenas onde uma feature flag obtida da Anthropic o ativava. Em sessões que não obtêm feature flags, /code-review era executado apenas quando você o digitava, e um /code-review agendado chegava ao Claude como texto simples.

Escalar para ultrareview

/code-review ultra --fix executa a ultrareview mais aprofundada na nuvem e, em seguida, pede ao Claude para aplicar as descobertas à sua árvore de trabalho quando elas retornarem à sua sessão.

A ultrareview usa seu próprio escopo:

• O que ela compara: seu branch atual em relação ao branch padrão do repositório, além das alterações não commitadas e preparadas (staged) na árvore de trabalho
• Arquivos sensíveis: para alterações não commitadas em arquivos com nomes de credenciais ou chaves, como arquivos .env e *.tfvars, o Claude Code segue as regras para enviar um repositório local para uma sessão na nuvem
• Uma base diferente: passe um nome de branch, como /code-review ultra develop, para comparar com uma base diferente

Quando o alvo é um pull request do github.com, você pode fazer o Claude publicar as descobertas finalizadas no PR como um comentário da sua conta do GitHub. Requer o Claude Code v2.1.227 ou posterior.

Para executar uma revisão na nuvem a partir de um script ou job de CI, use o subcomando claude ultrareview, que aguarda as descobertas e as imprime no stdout.

Altere ou amplie a revisão

/code-review é uma skill incluída: suas instruções são incorporadas ao Claude Code, portanto não há um arquivo SKILL.md no disco para abrir ou editar. Para dar a cada revisão regras do projeto a seguir, adicione-as ao seu CLAUDE.md. Para ir além, comece por uma destas páginas:

• Substituir o comando: uma skill de projeto ou pessoal chamada code-review é executada no lugar da incluída, e o alias /review continua executando a revisão incluída. Consulte Resolver skills que compartilham um nome.
• Criar seu próprio revisor: escreva um subagente revisor ou uma skill de revisão
• Usar um comando vizinho: /simplify revisa apenas em busca de limpeza e aplica suas correções, e /verify executa seu aplicativo para confirmar que uma alteração funciona

O comando se chamava /simplify antes da v2.1.147, quando aplicava correções por padrão. Se você criou scripts com /simplify para encontrar bugs, mude para /code-review --fix.

Recursos relacionados

• Code Review: o serviço gerenciado que revisa todo pull request no GitHub para sua organização
• Ultrareview: configuração, limites e custo da revisão na nuvem mais aprofundada
• Commands: a referência de uma linha para /code-review, /review, /simplify e /verify
• Skills: como as skills incluídas funcionam e como escrever as suas próprias