Code Review

Detecte bugs em pull requests do GitHub com Code Review: Claude revisa cada alteração, verifica suas descobertas e comenta inline. Para planos Team e Enterprise

Com Code Review, Claude revisa os pull requests em seus repositórios do GitHub. Vários agentes leem cada alteração junto com o código circundante, procurando problemas como erros de lógica, vulnerabilidades de segurança ou casos extremos quebrados. Uma etapa de verificação confere as descobertas contra o código antes de elas serem relatadas.

As descobertas chegam como comentários inline nas linhas em questão, classificadas por severidade, com um resumo e uma execução de verificação no pull request. Uma revisão nunca aprova nem bloqueia o pull request, portanto a decisão de fazer merge permanece com sua equipe.

[!NOTE]

Code Review usa IA para revisar código e pode deixar passar bugs, vulnerabilidades de segurança ou outros problemas. Uma revisão sem descobertas não significa que seu código está livre de erros ou é seguro.

Para ativar Code Review, um Owner de sua organização Claude segue Configurar Code Review. Claude também pode revisar código sem este serviço. Execute /code-review em sua sessão do Claude Code em qualquer plano, ou compare todas as opções.

Disponibilidade

Verifique se sua organização se qualifica antes de configurar Code Review:

• Planos: Team e Enterprise
• Hosts de código: repositórios hospedados no GitHub, incluindo GitHub Enterprise Server e GitHub Enterprise Cloud com residência de dados. Para residência de dados, peça a um Owner que siga a configuração de administrador do GitHub Enterprise Server e insira o hostname ghe.com de sua empresa.
• Retenção de dados: Code Review não está disponível para organizações com Zero Data Retention ativado ou com a configuração HIPAA aplicada, e não é coberto pelo Business Associate Agreement (BAA) da Anthropic.
• Chaves de criptografia: Code Review ainda não está disponível para organizações que usam chaves de criptografia gerenciadas pelo cliente (CMEK).
• Provedores de nuvem: você precisa de uma organização Claude em um desses planos mesmo que seus desenvolvedores usem Claude Code através do Amazon Bedrock, da Agent Platform do Google Cloud ou do Microsoft Foundry

Configurar e usar Code Review

Escolha a página para o que você precisa fazer:

[card] Configurar Code Review

Verifique os requisitos, instale o Claude GitHub App e escolha os repositórios, um nível de revisão e quando as revisões são executadas

[card] Personalizar Code Review

Ajuste o que é sinalizado com arquivos REVIEW.md e CLAUDE.md em seu repositório

[card] Ler e solicitar revisões em um pull request

Leia as descobertas e suas severidades, e solicite outra revisão com um comentário

[card] Solução de problemas do Code Review

Corrija uma revisão que não iniciou, falhou ou foi ignorada por orçamento

[card] Custos e uso do Code Review

Veja como as revisões são faturadas, estime gastos, defina o limite de gasto mensal e acompanhe a atividade de revisão

Como as revisões funcionam

Por padrão, Code Review se concentra em correção: bugs que quebrariam a produção, não preferências de formatação ou cobertura de testes ausente. Para alterar o que ele sinaliza, adicione arquivos de orientação ao seu repositório.

Uma revisão é executada na infraestrutura da Anthropic em quatro etapas:

1. Encontrar: vários agentes examinam o diff e o código circundante em paralelo.
2. Verificar: uma etapa de verificação confere as descobertas candidatas contra o código e filtra falsos positivos.
3. Classificar: as descobertas restantes são desduplicadas e classificadas por severidade.
4. Publicar: a revisão publica seus resultados no pull request.

Cada revisão deixa estes itens no pull request:

• Descobertas: comentários inline nas linhas em questão, com um resumo no corpo da revisão
• Uma execução de verificação: chamada Claude Code Review, com as descobertas listadas em seus detalhes. A execução de verificação não é concluída como falha.
• Uma nota no lugar das descobertas: publicada quando o título da execução de verificação diz Code review found no issues

Code Review escolhe os modelos Claude em que as revisões são executadas, e suas configurações de administrador não oferecem escolha de modelo. Para tornar as revisões mais ou menos minuciosas, altere o nível de revisão.

Depois que um Owner ativa Code Review, cada repositório tem uma configuração para quando as revisões são executadas: uma vez quando um pull request é aberto, após cada push ou apenas mediante solicitação. Qualquer que seja, alguém com acesso de escrita ao repositório pode comentar @claude review em um pull request para iniciar uma revisão.

Níveis de revisão

O nível de revisão define quão minuciosa é cada revisão, e uma revisão mais minuciosa custa mais:

• Quick: uma passagem mais leve. O nível mais rápido, com o menor custo.
• Standard: profundidade, velocidade e custo equilibrados. O nível padrão.
• Deep: a passagem mais minuciosa. Leva mais tempo e custa mais.

Um Owner escolhe um nível para a organização e pode dar a um repositório individual seu próprio nível, como Quick para uma base de código de rotina e Deep para uma crítica. Para saber o que mais determina o custo de cada revisão, consulte Custos e uso do Code Review.

O que uma revisão pode acessar

Uma revisão acessa seu repositório através do Claude GitHub App que um Owner instala durante a configuração:

• Onde é executada: na infraestrutura da Anthropic, em um ambiente gerenciado. As revisões não são executadas em ambientes auto-hospedados.
• O que lê e escreve: dentro de uma revisão, o acesso ao seu repositório é somente leitura, e uma revisão não faz push de commits. No pull request, ela publica comentários e a execução de verificação, resolve suas próprias threads de comentários anteriores e pode reagir a um comando de comentário com 👀. O próprio app possui um conjunto de permissões mais amplo que outros recursos Claude compartilham.
• Como examina seu código: uma revisão trabalha lendo o diff e o código circundante, sem compilar ou executar seu código.

Quem controla uma revisão

• Quem pode iniciar uma: onde as revisões são executadas automaticamente, abrir ou fazer push para um pull request inicia uma revisão, exceto em rascunhos e forks. Após alguns pushes, Code Review mantém o resultado anterior em vez disso. Um comando de comentário inicia uma apenas quando vem de uma pessoa com acesso de escrita ao repositório.
• Quais instruções segue: REVIEW.md do branch base ou padrão e nunca das próprias alterações do pull request.

Comparar formas de obter uma revisão

Para encontrar as opções disponíveis para você, verifique a coluna Quem pode usar em relação ao seu plano e host de código:

Recursos relacionados

• GitHub Enterprise Server: use Code Review com uma instância GitHub auto-hospedada
• Permissões do GitHub App: o conjunto completo de permissões que o Claude GitHub App solicita
• How Anthropic secures its AI-native software development lifecycle: como a revisão automatizada se encaixa como uma camada do processo de desenvolvimento seguro da Anthropic