Casos de uso · Engenharia

Revisão de código com IA em todo pull request com o Claude Code e o Codex

Tanto o Claude Code quanto o Codex conseguem revisar um pull request e deixar comentários inline no GitHub. Você pode rodar uma revisão por conta própria, fazer com que ela comece automaticamente ou dar a um funcionário de IA o trabalho de revisar tudo o que chegar ao quadro. Esta página mostra os comandos de cada opção, as regras de revisão que vale a pena escrever, o que os revisores não fazem e como tornar a revisão um trabalho fixo, em vez de algo que você precisa lembrar de pedir.

Três formas de ter revisão com IA em um pull request

OpçãoComo começaOnde rodaBom para
Claude Code /code-reviewVocê roda, com o número de um PR; --comment publica comentários inlineA sua própria sessão do Claude Code, em qualquer planoRevisar o seu branch ou um PR antes do merge
Claude Code Review (gerenciado)Um Owner da organização ativa para os repositórios; qualquer pessoa pode comentar @claude reviewO serviço da AnthropicEquipes em planos do Claude que querem revisões sob demanda
Revisão de código do Codex@codex review em um comentário do PR, ou Automatic review nas configurações do CodexA nuvem da OpenAIEquipes em planos do ChatGPT; aponta problemas P0 e P1 no GitHub
Um funcionário de IAUma issue de revisão no quadro, ou todo PR atribuído a eleO seu próprio Claude Code ou Codex, com um heartbeatUm trabalho fixo: todo PR revisado, pendências acompanhadas

Como revisar um pull request com o Claude Code ou o Codex

  1. Claude Code: rode /code-review

    Em uma sessão do Claude Code, /code-review encontra bugs nas mudanças do seu branch; passe o número de um PR para revisar esse pull request e --comment para publicar os achados no GitHub como comentários inline. --fix aplica as correções na sua working tree em vez disso. /review é um alias.

    # Claude Code: revise um pull request e publique comentários inline
    /code-review 142 --comment
    
    # Codex: peça uma revisão em um comentário do PR no GitHub
    @codex review
    @codex review for issues in the database migration
  2. Codex: mencione @codex review

    Em um comentário do pull request, escreva @codex review; o Codex reage com 👀 e publica uma revisão. Acrescente um foco depois, se quiser. Para revisar sem precisar pedir, ative Automatic review nas configurações do Codex e escolha o gatilho.

  3. Escreva as suas regras de revisão

    O Codex lê uma seção ## Code Review Rules do AGENTS.md mais próximo do código. Para o Claude Code, coloque as mesmas regras no CLAUDE.md. Regras deixam as revisões consistentes e as mantêm longe de assuntos que o seu linter já cobre.

    ## Code Review Rules
    - Aponte testes faltando para branches novos em billing/ e auth/.
    - Toda migração SQL precisa de rollback; diga se não tiver.
    - Não comente sobre formatação; o linter cuida disso.
    - Não aprove nada nem peça mudanças em nada: só comente.

Fonte: documentação do Claude Code, revisão local com /code-review

O que a revisão com IA não faz

  • Aprovar ou bloquear: o Code Review gerenciado do Claude nunca aprova nem bloqueia um pull request, e um bom brief de revisão diz ao funcionário para só comentar.
  • Substituir a pessoa dona da mudança: ela pega bugs e testes faltando; decisões de produto e de design ficam com as pessoas.
  • Ver tudo: o Codex no GitHub aponta só problemas P0 e P1, para manter os comentários focados. Peça um foco específico quando precisar.
  • Sair de graça: as revisões consomem o uso do seu plano. Revise sob demanda, ou quando o PR estiver pronto para revisão, e não a cada push.

Passo a passo para o Claude Code e o Codex

Os comandos nativos, as ferramentas para conectar e o agendamento de cada agente: Revisão de código no Claude Code e Revisão de código no Codex.

Com o Crewmark

Faça da revisão o trabalho de alguém

Comandos revisam quando alguém lembra de rodá-los. Um funcionário de IA revisa porque esse é o trabalho dele: o Crewmark transforma o seu Claude Code ou Codex em um engenheiro que acorda com um heartbeat, pega os pull requests esperando revisão e comenta neles.

  1. Comece pelo cargo

    O engenheiro de software com IA, com as suas regras de revisão no brief.

  2. Leve as revisões para o quadro

    Atribua issues de revisão a ele, ou adicione uma issue recorrente para revisar todo pull request aberto marcado como pronto.

  3. Mais trabalhos de engenharia

    Veja Claude Code para engenharia e triagem de erros do Sentry.

Perguntas frequentes

Como reviso um pull request com o Claude Code?

Rode /code-review <PR number> --comment em uma sessão do Claude Code para publicar os achados como comentários inline no GitHub. Sem --comment, ele relata na própria sessão; --fix aplica as correções localmente.

/review é a mesma coisa que /code-review no Claude Code?

A documentação do Claude Code lista /review como alias de /code-review.

Como faço o Codex revisar um pull request?

Comente @codex review no pull request, ou ative Automatic review nas configurações do Codex para que as revisões comecem no gatilho que você escolher. A revisão de código precisa estar ativada para o repositório.

Posso passar as regras da nossa equipe para o revisor de IA?

Sim. O Codex lê uma seção ## Code Review Rules no AGENTS.md; para o Claude Code, coloque as mesmas regras no CLAUDE.md.

A IA vai aprovar ou fazer merge de pull requests?

O Code Review gerenciado do Claude nunca aprova nem bloqueia, e você deve manter o merge com as pessoas. O brief de um funcionário de IA deve dizer para só comentar.

Conferido na documentação de revisão de código do Claude Code e na documentação de revisão de código do Codex da OpenAI em 10 de novembro de 2026.

Todo pull request revisado, sem ninguém precisar lembrar de pedir.

O Crewmark transforma sessões do Claude Code e do Codex em funcionários de IA com cargos, metas, horário de trabalho e heartbeat.