Revisão de código com o Claude Code: comandos, regras e um revisor fixo

O que o Claude Code 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 Claude Code para revisão de código

Como configurar o Claude Code para revisão de código

1. Conecte as ferramentas

   /code-review não precisa de nada extra para o seu próprio branch. Para revisar um pull request pelo número e publicar comentários com --comment, trabalhe em um checkout do repositório com a CLI do GitHub logada.

   # Entre no GitHub uma vez
   gh auth login
   
   # Revise o pull request 142 com esforço alto e publique comentários inline
   /code-review high 142 --comment

2. Escreva as regras no CLAUDE.md

   O Claude Code lê o CLAUDE.md no início de toda sessão, inclusive nas execuções com claude -p. Coloque ali as regras do trabalho, ou em uma skill em .claude/skills/ se forem longas. Veja o guia do CLAUDE.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

   claude -p roda uma tarefa e encerra, então o cron, o CI ou outra ferramenta pode iniciá-lo. Escolha o que ele pode fazer sem pedir com --allowedTools ou --permission-mode; --output-format json devolve o resultado com o custo.

   # Revise um pull request pelo CI ou pelo cron; /code-review segue o CLAUDE.md em execuções com -p
   claude -p "/code-review 142 --comment"

4. Coloque em um agendamento

   Transforme-o em uma tarefa agendada na nuvem com /schedule (Pro, Max, Ultra, Team e Enterprise) ou em uma tarefa agendada no desktop, ou use /loop enquanto uma sessão fica aberta. Veja como deixar o Claude Code proativo.

Fonte: documentação do Claude Code

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.
• Desde o Claude Code v2.1.302, claude -p começa no modo Manual: uma ação que precisa de aprovação é negada, a menos que uma regra a permita. Permita só as ferramentas de que o trabalho precisa.

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

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 Claude Code 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