Revisão de código com o Codex: /review, @codex review e as suas regras

O que o Codex faz em revisão de código

• Revisa cada pull request em busca de bugs, testes faltando e mudanças arriscadas, e comenta inline no GitHub.
• Segue as suas regras de revisão escritas, então os comentários ficam longe do que o linter já confere.
• Revisa as próprias mudanças, e as de outros agentes, antes que cheguem a uma pessoa.
• Acompanha as pendências: um comentário que pede trabalho vira uma issue em vez de se perder.

Recursos do Codex para revisão de código

Como configurar o Codex para revisão de código

1. Conecte as ferramentas

   /review só precisa de um repositório Git. Para revisões no GitHub, conecte o repositório ao Codex e ative a revisão de código para ele nas configurações do Codex.

   # No GitHub, em um comentário do pull request
   @codex review
   @codex review for issues in the database migration

2. Escreva as regras no AGENTS.md

   O Codex lê o AGENTS.md antes de qualquer trabalho: ~/.codex/AGENTS.md e depois os arquivos da raiz do repositório até a pasta em que está trabalhando. Coloque ali as regras do trabalho, ou em uma skill em .agents/skills/ se forem longas. Veja o guia do AGENTS.md.

   ## 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.
   - Só comente: nunca aprove, peça mudanças ou faça merge.

3. Rode sem a interface interativa

   codex exec roda uma tarefa e encerra. O progresso vai para o stderr e a mensagem final para o stdout; -o também a grava em um arquivo e --json transmite os eventos. O sandbox é somente leitura, a menos que você passe --sandbox workspace-write.

   # Revise este branch em relação à main por um script ou pelo CI
   codex review --base main
   
   # Ou as mudanças que ainda não foram commitadas
   codex review --uncommitted

4. Coloque em um agendamento

   Crie uma tarefa agendada no app desktop do ChatGPT ou na web (a CLI não as gerencia), ou rode codex exec pelo cron. Veja como deixar o Codex proativo.

Fonte: documentação do Codex

Limites e segurança

• Ele comenta; não é o dono da mudança. Deixe aprovações e merges com as pessoas.
• As revisões consomem o uso do seu plano. Revise sob demanda ou quando um pull request estiver pronto, não a cada push.
• Ele revisa o diff e o repositório. Não consegue testar com dados de produção.
• O Codex roda os comandos em sandbox por padrão: as escritas ficam no workspace e a rede fica desligada. Deixe danger-full-access para um runner ou contêiner isolado.

Claude Code ou Codex para revisão de código?

As regras valem para os dois. Escreva-as uma vez no AGENTS.md e coloque @AGENTS.md no CLAUDE.md, e os dois agentes leem o mesmo arquivo.

Passo a passo para o outro agente: revisão de código com o Claude Code.

Coloque alguém responsável por revisão de código

Comandos rodam quando alguém lembra de rodá-los. O Crewmark transforma o seu próprio Codex em um funcionário de IA com um cargo, uma meta em números, horário de trabalho e um heartbeat, então o trabalho acontece no horário e aparece em um quadro.

1. Comece pelo cargo

   O engenheiro de software com IA, com estas regras no brief.

2. Leve o trabalho para o quadro dele

   Adicione o trabalho como issue recorrente. O funcionário acorda com o heartbeat, faz o trabalho e relata em um comentário.

3. Veja também

   Revisão de código com IA em todo PR compara todas as opções, e a revisão de segurança cobre vulnerabilidades.

Perguntas frequentes