> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Note>
  Para que todo pull request em um repositório seja revisado automaticamente no GitHub, consulte [Code Review](/docs/pt/code-review), um serviço gerenciado que um Owner ativa para sua organização.
</Note>

`/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.

<Steps>
  <Step title="Execute /code-review">
    Execute o comando:

    ```text theme={null}
    /code-review
    ```

    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](#choose-what-to-review).

    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](/docs/pt/permission-modes).
    * `--comment`: publica as descobertas em um pull request do GitHub como comentários inline, ou em um [merge request do GitLab](#post-findings-to-a-gitlab-merge-request) como uma única nota
  </Step>

  <Step title="Continue trabalhando">
    A revisão é executada como um [subagente](/docs/pt/sub-agents) 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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<h2 id="choose-what-to-review">
  Escolha o que revisar
</h2>

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:

| Para direcionar a revisão para | Digite |
| :- | :- |
| Seu branch atual e alterações não commitadas | `/code-review` |
| Seus últimos 15 commits | `/code-review HEAD~15..HEAD` |
| Um branch em relação a outro | `/code-review main...my-feature` |
| Um único commit, em que `abc1234` é o hash do commit | `/code-review abc1234^..abc1234` |
| Um pull request pelo número | `/code-review 1234` |
| Um caminho de arquivo ou diretório | `/code-review src/auth` |

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](#text-after-the-effort-level-and-flags).

<h2 id="what-the-review-reads-and-edits">
  O que a revisão lê e edita
</h2>

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](/docs/pt/checkpointing#subagent-edits-not-restored) 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](#run-in-the-foreground), 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](/docs/pt/code-review-customize#use-review-md-for-review-only-rules) gerenciado em pull requests do GitHub.

<h2 id="how-findings-are-reported">
  Como as descobertas são relatadas
</h2>

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](/docs/pt/skills#run-skills-in-a-subagent)
* 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](/docs/pt/desktop#review-your-code), o Claude relata as descobertas da revisão por meio da [ferramenta `ReportFindings`](/docs/pt/tools-reference). 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.

<h2 id="tune-effort-and-arguments">
  Ajuste o esforço e os argumentos
</h2>

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](/docs/pt/ultrareview#post-findings-to-the-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](/docs/pt/model-config#adjust-effort-level) 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.

<h3 id="post-findings-to-a-gitlab-merge-request">
  Publicar descobertas em um merge request do GitLab
</h3>

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`.

<h3 id="text-after-the-effort-level-and-flags">
  Texto após o nível de esforço e as flags
</h3>

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](/docs/pt/ultrareview#pass-a-request-in-plain-words). `/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](/docs/pt/skills#pass-arguments-to-skills). Antes da v2.1.218, um comando empilhado após `/code-review` era expandido como sua própria skill.

<h2 id="run-in-the-foreground">
  Executar em primeiro plano
</h2>

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](/docs/pt/ultrareview#run-ultrareview-non-interactively).
* Defina [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/pt/env-vars) 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.

<h2 id="let-claude-start-the-review">
  Deixe o Claude iniciar a revisão
</h2>

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](/docs/pt/scheduled-tasks) com `/code-review` como prompt executa a revisão

Uma tarefa agendada nunca inicia a [revisão na nuvem](#escalate-to-ultrareview), 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`](/docs/pt/skills#override-skill-visibility-from-settings) a um [arquivo de configurações](/docs/pt/settings#where-settings-live) como `~/.claude/settings.json`:

```json theme={null}
{
  "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](/docs/pt/env-vars#features-that-need-feature-flag-fetching), `/code-review` era executado apenas quando você o digitava, e um `/code-review` agendado chegava ao Claude como texto simples.

<h2 id="escalate-to-ultrareview">
  Escalar para ultrareview
</h2>

`/code-review ultra --fix` executa a [ultrareview](/docs/pt/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](/docs/pt/claude-code-on-the-web#send-local-repositories-without-github)
* **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](/docs/pt/ultrareview#post-findings-to-the-pull-request) como um comentário da sua conta do GitHub. Requer o Claude Code v2.1.227 ou posterior.

<Note>
  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](/docs/pt/hipaa-setup) 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](https://platform.claude.com/docs/en/manage-claude/cmek) (CMEK) não podem executar a ultrareview. Para revisar suas alterações localmente, execute `/code-review`.
</Note>

Para executar uma revisão na nuvem a partir de um script ou job de CI, use o [subcomando `claude ultrareview`](/docs/pt/ultrareview#run-ultrareview-non-interactively), que aguarda as descobertas e as imprime no stdout.

<h2 id="change-or-build-on-the-review">
  Altere ou amplie a revisão
</h2>

`/code-review` é uma [skill incluída](/docs/pt/skills#bundled-skills): 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](/docs/pt/skills#resolve-skills-that-share-a-name).
* **Criar seu próprio revisor**: escreva um [subagente](/docs/pt/sub-agents) revisor ou uma [skill](/docs/pt/skills) de revisão
* **Usar um comando vizinho**: [`/simplify`](/docs/pt/commands) revisa apenas em busca de limpeza e aplica suas correções, e [`/verify`](/docs/pt/commands) 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`.

<h2 id="related-resources">
  Recursos relacionados
</h2>

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