Skip to main content
/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.
Para que todo pull request em um repositório seja revisado automaticamente no GitHub, consulte Code Review, um serviço gerenciado que um Owner ativa para sua organizaçã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.
1

Execute /code-review

Execute o comando:
Sem um alvo, a revisão abrange as alterações no seu branch atual. Para direcionar a revisão para um pull request, outro branch, um caminho ou um intervalo de commits, consulte Escolha o que revisar.Você também pode adicionar flags:
  • --fix: também pede ao Claude para aplicar as descobertas à sua árvore de trabalho após a revisão. Suas edições passam pelo seu modo de permissão.
  • --comment: publica as descobertas em um pull request do GitHub como comentários inline, ou em um merge request do GitLab como uma única nota
2

Continue trabalhando

A revisão é executada como um subagente em segundo plano com sua própria janela de contexto, portanto não enche sua conversa. As descobertas chegam à sua conversa quando a revisão é concluída.
3

Aja com base nas descobertas

Peça ao Claude para corrigir o que a revisão encontrou. Com --fix ou --comment, o Claude aplica ou publica as descobertas como parte da revisão, e pode ser solicitado que você aprove as edições dele.

​
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:
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.
A ultrareview requer autenticação com uma conta claude.ai. Ela não está disponível no Amazon Bedrock, no Agent Platform do Google Cloud ou no Microsoft Foundry, nem para organizações com Zero Data Retention habilitado ou com a configuração HIPAA aplicada. Nesses casos, /code-review ultra executa uma revisão local na sua sessão. Organizações que usam chaves de criptografia gerenciadas pelo cliente (CMEK) não podem executar a ultrareview. Para revisar suas alterações localmente, execute /code-review.
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.
  • 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