Skip to main content
Ultrareview é um recurso de visualização de pesquisa. O recurso, preços e disponibilidade podem mudar com base no feedback. O comando é /code-review ultra. Quando ultrareview está disponível para sua conta, /ultrareview é um alias.
Ultrareview é uma revisão de código profunda que é executada como uma sessão na nuvem na infraestrutura da Anthropic. Quando você executa /code-review ultra, Claude Code inicia uma frota de agentes revisores em um sandbox na nuvem para encontrar bugs em sua branch ou pull request. Comparado a um /code-review local, ultrareview oferece:
  • Sinal mais alto: cada descoberta relatada é reproduzida e verificada independentemente, portanto os resultados se concentram em bugs reais em vez de sugestões de estilo
  • Cobertura mais ampla: uma frota maior de agentes revisores explora a mudança em paralelo, o que expõe problemas que uma revisão local pode perder
  • Sem uso de recursos locais: a revisão é executada inteiramente em um sandbox na nuvem, portanto seu terminal permanece livre para outro trabalho enquanto é executada
Ultrareview requer autenticação com uma conta claude.ai porque é executado como uma sessão na nuvem na infraestrutura da Anthropic. Se você está conectado apenas com uma chave de API, execute /login e autentique-se com claude.ai primeiro. Ultrareview não está disponível ao usar Claude Code com Amazon Bedrock, Google Cloud’s Agent Platform ou Microsoft Foundry, e não está disponível para organizações que habilitaram Zero Data Retention ou que têm a configuração HIPAA aplicada. Quando ultrareview não está disponível, /code-review ultra executa uma revisão local em sua sessão em vez disso.

​
Execute ultrareview a partir da CLI

Inicie uma revisão de qualquer repositório git:
Sem argumentos, ultrareview revisa o diff entre sua branch atual e a branch padrão, incluindo mudanças sem commit e preparadas. Para uma revisão de branch, Claude Code agrupa o estado do repositório e o carrega em um sandbox na nuvem de acordo com as regras para carregar um repositório local em uma sessão na nuvem, que abrangem os limites de tamanho, os requisitos de checkout e o que acontece com mudanças sem commit em arquivos nomeados como credenciais ou chaves, como arquivos .env e *.tfvars. Quando você revisa uma pull request, Claude Code não carrega nada de sua máquina. Antes de iniciar, Claude Code mostra um diálogo de confirmação com o escopo da revisão, suas execuções gratuitas restantes e o custo estimado; para uma revisão de branch, o escopo inclui a contagem de arquivos e linhas. Depois que você confirmar, a revisão continua em segundo plano enquanto você continua usando sua sessão. O comando é executado apenas quando você o invoca com /code-review ultra; Claude não inicia um ultrareview por conta própria.

​
Revisar contra uma base diferente

Para comparar contra uma base diferente da branch padrão, passe o nome da branch. Este exemplo revisa sua branch atual contra develop:
A branch base não precisa existir em seu clone local; Claude Code a busca de origin. Se o nome tiver um erro de digitação, Claude Code sugere o nome de branch mais próximo no erro. Um ID de commit ou tag também funciona como a base, e a revisão então cobre as mudanças em sua branch desde esse commit.

​
Revisar uma pull request

Para revisar um pull request em github.com em vez de um branch local, passe o número do PR:
O comando também aceita #1234, PR 1234 e URLs de PR coladas; uma URL colada deve apontar para o repositório em seu diretório atual. O modo PR requer um repositório em github.com. Para um repositório em uma instância do GitHub Enterprise Server, execute /code-review ultra sem um número de PR para revisar seu branch local em vez disso. No modo PR, o sandbox na nuvem clona o pull request de github.com em vez de carregar sua árvore de trabalho. Ele usa a conta do GitHub conectada à sua conta Claude, portanto essa conta precisa de acesso de leitura ao repositório. Execute /web-setup para conectar seu login do GitHub CLI à sua conta Claude.

​
Postar descobertas na pull request

No Claude Code v2.1.227 ou posterior, quando você revisa um pull request em github.com, você pode fazer com que Claude poste as descobertas concluídas no PR como um único comentário simples de sua própria conta GitHub. O comentário não é uma revisão ou uma aprovação, e termina com uma nota “Generated by Claude Code”. Quando você revisa um branch, Claude Code mostra as descobertas apenas em sua sessão. Claude Code nunca posta a menos que você escolha nessa execução, e --no-post é o padrão. Postar é uma escolha que você faz para cada execução:
  • Interativo: no diálogo de lançamento, selecione Executar e postar as descobertas na PR como eu. Se você adicionar --post ao comando, como em /code-review ultra 1234 --post, Claude Code pré-seleciona essa escolha e ainda pergunta antes de iniciar.
  • Não interativo: execute o subcomando claude ultrareview com --post. Você consente com a postagem ao executar o subcomando com a flag, portanto Claude Code posta sem perguntar. Em uma execução claude -p '/code-review ultra', Claude Code sai antes das descobertas chegarem, portanto não posta nada; use o subcomando em vez disso.
Claude Code não posta de sua máquina. Ele envia o ID da sessão da revisão para a API Anthropic, que posta as descobertas armazenadas da revisão como o comentário através da conta GitHub que você conectou ao Claude. Postar requer o mesmo login claude.ai que a revisão em si, e não está disponível em provedores de terceiros ou quando você define CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC. Em uma sessão interativa, Claude Code inicia a postagem quando as descobertas chegam, portanto mantenha a sessão aberta até que a revisão seja concluída. Claude Code mantém a escolha de postagem apenas nessa sessão. Se a sessão terminar antes da revisão ser concluída, Claude Code não posta nada, mesmo se você retomar a conversa mais tarde. Quando a postagem é concluída, Claude informa o resultado:
  • Postado: Claude fornece um link para o comentário.
  • Já postado: uma postagem anterior da mesma revisão já colocou o comentário na PR, portanto Claude o vincula à pull request em vez de postar novamente.
  • Falhou: Claude informa por quê, e as descobertas permanecem em seu terminal para que você possa postá-las manualmente.

​
Passar um pedido em palavras simples

No Claude Code v2.1.218 ou posterior, você também pode descrever no que está trabalhando em palavras simples:
A revisão ainda cobre sua branch atual, o mesmo escopo que executar sem argumento. Claude mantém seu texto como uma nota, mostrada no diálogo de lançamento, e relaciona as descobertas a ele quando chegam. Claude Code trata seu texto como uma nota apenas quando tem mais de uma palavra e não é um nome de branch ou referência de PR. Ele lê uma única palavra como um nome de branch ou referência de PR, portanto um nome de branch digitado incorretamente recebe o erro de branch mais próximo de Revisar contra uma base diferente em vez de iniciar com uma nota. Se seu texto combinar uma referência de PR com outras palavras, como check PR 123 again, Claude Code também não inicia; ele pede que você execute novamente com apenas o número da PR para revisar essa PR, ou sem a referência para revisar sua branch atual.
Se seu repositório for muito grande para agrupar, Claude Code pede que você use o modo PR em vez disso. Para um repositório em github.com, envie seu branch e abra um PR de rascunho, depois execute /code-review ultra <PR-number>.

​
Limites de diff e fallbacks

Ultrareview verifica o diff antes de qualquer trabalho de revisão ser executado e informa quando não consegue revisá-lo como está:
  • Diff muito grande: uma revisão de branch pode incluir até 500 arquivos alterados e 8.000 linhas alteradas por padrão. Os valores exatos podem mudar, e a recusa nomeia os em vigor, o tamanho do seu diff e os arquivos com mais linhas alteradas. Claude Code recusa uma pull request muito grande da mesma forma, nomeando suas contagens de arquivo e linha, mas não o detalhamento por arquivo
  • Nada para revisar: quando o diff contra a base está vazio, ultrareview recusa e nomeia a branch ou commit com o qual comparou e o caso em que você está, como estar na própria branch base sem nada não confirmado, ou uma branch cujos commits já fazem parte da base. Também sugere a maneira de sair para esse caso, como mudar para a branch com seu trabalho, preparar ou confirmar edições locais, ou passar uma base diferente
  • Primeiro commit: o primeiro commit de um repositório não tem nada anterior para comparar, portanto ultrareview revisa cada arquivo nele depois que você confirma no diálogo de lançamento. Se você tiver arquivos não rastreados, ele recusa em vez disso e informa para git add os que você deseja revisados. Os mesmos limites de tamanho se aplicam. Um primeiro commit é revisado integralmente apenas após essa confirmação, portanto o subcomando claude ultrareview e claude -p o recusam e o apontam para uma sessão interativa em vez disso. Requer Claude Code v2.1.277 ou posterior
  • Sem base de mesclagem: quando sua branch não compartilha histórico com a branch base, ou o repositório não tem branch base para comparar, ultrareview revisa cada arquivo rastreado no repositório em vez disso. O fallback requer um clone completo e aplica os mesmos limites de tamanho. Ele é lançado apenas quando você confirma no diálogo de lançamento ou executa o subcomando claude ultrareview você mesmo. Em claude -p e em qualquer outro lugar onde nenhum desses acontece, ultrareview recusa, diz que a revisão cobriria cada arquivo, e o aponta para uma sessão interativa. Em um checkout sem branches ou outras refs, como um HEAD desanexado criado ao fazer checkout de FETCH_HEAD após buscar uma URL, Claude Code recusa a revisão e sugere criar uma branch primeiro

​
Preços e execuções gratuitas

Ultrareview é um recurso premium que é cobrado contra créditos de uso em vez do uso incluído em seu plano.
  • Execuções gratuitas: as três execuções Pro e Max são uma alocação única por conta e não são renovadas.
  • Custo por revisão: após usar as execuções gratuitas, normalmente $5 a $25 em créditos de uso dependendo do tamanho da mudança, correspondendo à estimativa que o diálogo de lançamento mostra antes de cada execução.
  • Quando uma execução é contada: assim que a sessão na nuvem é iniciada. Uma revisão que você interrompe no início ou que falha em ser concluída ainda usa uma execução gratuita; uma revisão paga é cobrada apenas pela parte que foi executada.
Como ultrareview sempre é cobrado como créditos de uso fora das execuções gratuitas, sua conta ou organização deve ter créditos de uso habilitados antes de poder iniciar uma revisão paga. Se os créditos de uso não estiverem habilitados, Claude Code bloqueia o lançamento. Se você puder gerenciar o faturamento da sua conta, Claude Code o direciona às configurações de faturamento onde você pode ativar os créditos de uso. Você também pode executar /usage-credits para verificar ou alterar sua configuração de créditos de uso. Claude Code pede que você confirme o faturamento de créditos de uso uma vez por conversa: quando você inicia uma nova conversa, por exemplo com /clear, Claude Code mostra a confirmação novamente para a próxima revisão paga.

​
Acompanhe uma revisão em execução

Uma revisão normalmente leva 15 a 25 minutos. A revisão é executada como uma tarefa em segundo plano, portanto você pode continuar trabalhando em sua sessão ou iniciar outros comandos. Se você escolheu postar as descobertas no pull request, mantenha a sessão aberta até que a revisão termine; se a sessão terminar primeiro, Claude Code não publica nada. Use /tasks para ver revisões em execução e concluídas, abrir a visualização de detalhes de uma revisão ou parar uma revisão em andamento. Se você parar uma revisão, Claude Code arquiva a sessão na nuvem e não retorna descobertas parciais. Claude também pode informar que uma revisão foi interrompida ou que sua sessão não foi encontrada:
  • Se a sessão na nuvem da revisão for interrompida ou arquivada no claude.ai antes da revisão terminar, Claude informa que foi interrompida.
  • Se a sessão na nuvem da revisão foi deletada, ou você se conectou a uma conta Claude ou organização diferente desde que a iniciou, Claude informa que a sessão não foi encontrada.
  • Se você trocou de conta, a revisão ainda pode terminar sob a conta que a iniciou. Se a revisão ainda estiver em execução, conecte-se novamente como essa conta e retome a conversa com claude --resume para revinculá-la.
Quando a revisão termina, Claude Code mostra as descobertas verificadas como uma notificação em sua sessão. Cada descoberta inclui a localização do arquivo e uma explicação do problema para que você possa pedir ao Claude para corrigi-lo diretamente.

​
Execute ultrareview de forma não interativa

Use o subcomando claude ultrareview para iniciar um ultrareview a partir de CI ou um script sem uma sessão interativa. O subcomando inicia a mesma revisão que /code-review ultra, bloqueia até que a revisão remota termine e imprime as descobertas para stdout.
Sem argumentos, o subcomando revisa o diff entre sua branch atual e a branch padrão, com o mesmo fallback de repositório inteiro que /code-review ultra quando não existe base de mesclagem. Passe um número de PR para revisar um pull request no github.com, ou uma branch base para revisar em relação a ela; o tratamento de branch base corresponde ao comando interativo. Você consente com o fallback de repositório inteiro e com o aviso de faturamento e termos quando executa o subcomando, portanto a execução começa sem aguardar entrada. Executar você mesmo é o que conta como consentimento. Quando Claude executa o subcomando para você, por exemplo através da ferramenta Bash, Claude Code recusa a revisão de repositório inteiro. claude -p '/code-review ultra' não entrega as descobertas a você, portanto use claude ultrareview em scripts. A execução com -p inicia a revisão na nuvem e sai sem aguardá-la. Quando a revisão cobraria créditos de uso, a execução com -p para sem iniciá-la. Antes da v2.1.218, /code-review ultra em uma sessão não interativa executava uma revisão local. claude ultrareview grava suas mensagens de progresso em stderr para que stdout permaneça analisável. Use essas flags para controlar a saída, o timeout e se deve postar as descobertas: Executar claude ultrareview requer a mesma autenticação e configuração de créditos de uso que /code-review ultra. O subcomando sai com um dos três códigos:
  • 0: a revisão foi concluída, com ou sem descobertas
  • 1: a revisão falhou ao iniciar ou foi interrompida antes de terminar, a sessão na nuvem apresentou erro ou o tempo limite decorrido
  • 130: você interrompeu o subcomando com Ctrl-C
Se o subcomando sair antes que as descobertas cheguem, elas nunca chegam ao seu terminal. A revisão ainda pode estar em execução na nuvem. Executar o subcomando novamente inicia uma nova revisão em vez de retomar aquela, e a nova revisão usa uma execução gratuita ou é cobrada como créditos de uso. Com --post, o subcomando inicia a postagem logo após imprimir as descobertas, e imprime o link para stderr.
  • Se a execução falhar, for interrompida ou atingir o timeout, o subcomando não posta nada.
  • Se a revisão for concluída mas o comentário não for postado, Claude Code imprime o motivo para stderr, e as descobertas permanecem em stdout para que você possa postá-las manualmente.
Para revisões automáticas em pull requests do GitHub, Code Review integra-se diretamente com seu repositório e publica descobertas como comentários inline de PR sem uma etapa de CLI.

​
Como ultrareview se compara a /code-review

Ambas as revisões examinam código, mas você as usa em diferentes estágios do seu fluxo de trabalho. Use /code-review para feedback rápido enquanto trabalha, ou passe um número de PR para revisar um pull request de um colega antes de aprová-lo. Use /code-review ultra antes de fazer merge de uma mudança substancial quando você quer uma passagem mais profunda que capture problemas que uma revisão local pode perder.