Você pode fazer revisão de código com Claude Code, Codex e Cursor através do Open Code Review, a ferramenta de código aberto do Alibaba para revisar mudanças de Git.
O interessante é o que acontece entre selecionar um diff e receber uma lista de descobertas. Esse processo determina se a revisão fornece observações úteis ou uma nova fila de comentários para investigar.
Este guia começa com Claude Code e depois mostra as opções para Codex CLI e Cursor. Open Code Review é o projeto que instalaremos para incorporar esse fluxo a cada agente.
O que o Open Code Review traz para o Claude Code?
Open Code Review é uma ferramenta de revisão de código licenciada sob Apache-2.0 que combina um processo determinístico com um agente baseado em LLM. O processo seleciona e agrupa arquivos, atribui regras de revisão e posiciona os comentários. O agente investiga o contexto do código e gera as descobertas. É assim que é descrito no README do projeto.
Essa divisão é a decisão técnica mais interessante: torna explícitas e inspecionáveis partes do processo de revisão. Isso não garante que as conclusões do modelo estejam corretas.
Claude Code é o agente de programação da Anthropic. Open Code Review é adicionado como um plugin de terceiros: o agente e o plugin são peças distintas do fluxo.
Em nosso artigo sobre code-review-graph exploramos um problema relacionado: como identificar o código conectado com uma mudança. Open Code Review oferece outra forma de examinar como as ferramentas que cercam o modelo influenciam a revisão.
Como fazer revisão de código com Claude Code?
Instale a CLI do Open Code Review e seu plugin para Claude Code; depois escolha se a revisão será feita pelo Claude ou pelo modelo conectado ao Open Code Review.
O projeto requer Git 2.41 ou posterior. Se você tiver npm disponível, instale o pacote:
npm install -g @alibaba-group/open-code-review
Dentro do Claude Code, com seu repositório aberto, adicione o marketplace e instale o plugin:
/plugin marketplace add alibaba/open-code-review
/plugin install open-code-review@open-code-review
São os comandos publicados no guia de integração do Alibaba. Depois ative o plugin recém instalado:
/reload-plugins
A documentação da Anthropic indica que este comando carrega as mudanças de plugins sem reiniciar a sessão.
Como usar o próprio modelo do Claude Code?
Execute o modo de delegação se você quiser que Claude faça a revisão:
Antes de executá-lo: as instruções deste comando também pedem para aplicar automaticamente correções claras e seguras de severidade alta ou média. Se você só quer um relatório, indique expressamente a Claude que não modifique arquivos e verifique o diff ao terminar. Essa indicação expressa sua intenção; não é um modo técnico de somente leitura.
/open-code-review:delegate-review
Open Code Review seleciona os arquivos e fornece as regras; Claude obtém os diffs e analisa as mudanças. Sem argumentos, o fluxo abrange mudanças preparadas, não preparadas e arquivos sem rastreamento. Você não precisa de um endpoint de LLM independente para Open Code Review neste modo. Consulte o fluxo de delegação.
Como usar um modelo independente para a revisão?
Conecte um provedor ao Open Code Review se você quiser que seu próprio mecanismo execute a análise. No terminal:
ocr config provider
ocr config model
ocr llm test
Depois, dentro do Claude Code:
/open-code-review:review
Este comando executa a revisão com Open Code Review e encarrega ao agente avaliar as descobertas. Também inclui instruções para aplicar as correções que considerar úteis. Esse comportamento aparece na definição do comando.
A diferença prática é quem analisa o código: em delegação é o Claude; no segundo fluxo é o mecanismo do Open Code Review com o provedor que você escolheu. Instalar o plugin não torna ambos os caminhos equivalentes.
Como usar Open Code Review em Codex e Cursor?
Você pode instalar as integrações do mesmo projeto em Codex CLI e Cursor, com um procedimento distinto para cada um. Ambos precisam da CLI ocr instalada; para o fluxo padrão, complete também a seleção e teste do provedor anteriores.
Codex CLI
A partir do terminal, registre o repositório como marketplace e abra Codex:
codex plugin marketplace add alibaba/open-code-review
codex
Abra /plugins, instale e ative Open Code Review, e inicie uma nova sessão. A documentação da OpenAI confirma o navegador de plugins da CLI e a necessidade de uma nova sessão; também documenta como registrar um marketplace.
Na nova sessão você pode invocar o plugin com este exemplo do projeto:
@Open Code Review review my current changes
O plugin fornece skills que usam a CLI local. A sequência específica do Alibaba está em seu guia para Codex.
Cursor
Para a instalação manual local, obtenha o repositório e copie sua pasta completa plugins/open-code-review/ para:
~/.cursor/plugins/local/open-code-review/
O manifesto deve ficar em ~/.cursor/plugins/local/open-code-review/.cursor-plugin/plugin.json. Reinicie Cursor ou execute Developer: Reload Window e revise os componentes em Customize. É a disposição descrita pelo Alibaba e respaldada pela documentação de plugins locais do Cursor.
A partir de Customize, identifique as skills carregadas e invoque-as no chat. Cursor permite invocá-las com / seguido de seu nome. Em ambientes gerenciados, o carregamento local depende da política Allow Local Plugin Imports; se estiver desativada, copiar a pasta não é suficiente.
Como revisar mudanças a partir do terminal sem abrir um agente?
Você pode usar a CLI diretamente com o provedor de LLM já conectado.
A partir do seu repositório, revise as mudanças atuais:
ocr review
A revisão inclui mudanças preparadas para o commit, mudanças não preparadas e arquivos sem rastreamento. Para revisar um branch a partir de seu ancestral comum com main:
ocr review --from main --to feature-branch
Substituia feature-branch pelo nome do seu branch. Para salvar os resultados em formato estruturado:
ocr review --format json --output result.json
Os modos de revisão e suas opções estão documentados no guia de início do README.
Para uma primeira avaliação, use uma mudança pequena que você já conheça bem. Verifique se cada descoberta identifica um problema real, aponta a localização correta e explica uma consequência que você pode reproduzir.
Open Code Review é gratuito?
O código é licenciado sob Apache-2.0; o custo de inferência depende de como você executa o modelo. Uma licença de código aberto não implica que todas as revisões sejam gratuitas. Você pode consultar a licença e os requisitos de uso no repositório.O projeto também documenta integrações com agentes de programação e um modo de delegação que permite usar o modelo do agente hospedeiro, em vez de um endpoint independente para Open Code Review. Isso muda qual serviço realiza a inferência, mas não demonstra que esse serviço seja gratuito. As alternativas estão descritas na documentação de integrações.
Se você o avaliar para uma equipe, meça o custo por descoberta útil junto com o tempo de revisão. Uma revisão barata que exige muito trabalho para separar os problemas reais dos falsos positivos pode não compensar.
Open Code Review consome menos tokens do que Claude Code?
O projeto declara um consumo aproximado de um nono dos tokens em comparação com Claude Code com o mesmo modelo subjacente, junto com maior precisão e F1, mas menor abrangência ou recall. Esses são resultados publicados pelo projeto, não uma prova independente do yoDEV. A afirmação aparece em sua seção de benchmarks.
Alibaba publica o conjunto de dados associado, AACR-Bench, que permite examinar um recurso concreto de avaliação.
O equilíbrio entre essas métricas é importante. Uma precisão maior significa que uma proporção maior das descobertas relatadas é válida. Um recall menor significa que mais defeitos reais permanecem não detectados. Uma revisão com menos ruído só é útil se você entender o que pode passar despercebido.
A economia de tokens, por si só, não permite saber se a ferramenta se adequa à sua base de código.
Também não deve transferir automaticamente esse número para o modo de delegação: lá muda quem realiza a análise. O benchmark citado não demonstra que invocar o plugin dentro do Claude Code reproduza essa economia.
Como avaliar Open Code Review no seu fluxo de trabalho?
Comece com um teste em alterações que sua equipe já tenha revisado.
Inclua um defeito conhecido, uma refatoração sem defeitos conhecidos e uma mudança que abrange vários arquivos. Registre as descobertas úteis, os falsos positivos, os defeitos omitidos, o tempo decorrido e o consumo de inferência. Valide as correções propostas com seus testes e seu processo usual de revisão.
Este guia segue as instruções publicadas; não é um relatório de desempenho baseado em um teste prático. As integrações foram verificadas documentalmente em 14 de setembro de 2026. Nesse dia, várias páginas vinculadas no site de documentação do Open Code Review retornaram erros 404; portanto, as instruções se baseiam no repositório e na documentação de cada agente.
A pergunta para decidir se deve incorporá-lo é concreta: essa revisão adicional detecta problemas suficientes sobre os quais você pode agir para justificar o tempo que sua equipe dedica a ler seus resultados?