Skip to main content
Como Owner da sua organização Claude, você ativa o Code Review em Admin settings > Claude Code no claude.ai. As revisões são executadas na infraestrutura da Anthropic, portanto você não adiciona arquivos de workflow aos seus repositórios. Após a configuração, você escolhe o quão minuciosas são as revisões e quando elas são executadas em cada repositório. Você gasta mais com um nível de revisão mais alto e quando as revisões são executadas com mais frequência. Consulte Custos do Code Review.

​
O que você precisa para ativar o Code Review

Primeiro, verifique se sua organização se qualifica para o Code Review. Em seguida, certifique-se de que você tem este acesso, ou alguém que tenha:

​
Ativar o Code Review

1

Clique no botão Allow code review

Vá até a seção Code review de Admin settings > Claude Code e clique no botão Allow code review.Se o Code Review for ativado imediatamente sem nenhuma caixa de diálogo, sua organização já tem o Claude GitHub App vinculado ou repositórios adicionados. Vá para Adicionar mais repositórios e depois volte para a última etapa.
2

Conecte sua conta do GitHub

Se uma caixa de diálogo Connect GitHub for aberta, clique em Connect. Se sua organização usa o GitHub Enterprise Server, selecione primeiro sua instância na caixa de diálogo. O GitHub solicita que você autorize o Claude e, em seguida, retorna você à página de administração com a caixa de diálogo Add a repository aberta.Se a caixa Add a repository for aberta imediatamente, sua conta já está conectada, então siga para a próxima etapa.
3

Instale o Claude GitHub App

Se os repositórios que você deseja estiverem listados na caixa de diálogo Add a repository, ou se você os encontrar pesquisando nela, siga para a próxima etapa. A caixa de diálogo lista um repositório somente se o Claude GitHub App puder acessá-lo; portanto, se eles não estiverem lá, instale o app:
  • Clique em Install GitHub App. Quando nenhum repositório está listado, ele é um botão na caixa de diálogo. Caso contrário, ele fica na parte inferior do menu de filtro de organizações do GitHub da caixa de diálogo. A página de instalação do GitHub é aberta em uma nova aba.
  • Escolha a organização do GitHub proprietária dos repositórios.
  • Escolha quais repositórios o app pode acessar.
  • Aprove as permissões solicitadas. O conjunto é mais amplo do que uma revisão usa e é compartilhado por outros recursos do Claude, como o GitHub Actions. Consulte o que uma revisão pode acessar e a lista completa de permissões.
  • Quando a instalação for concluída, a aba retorna ao Claude. Se ela mostrar um botão Finish connecting GitHub, clique nele para vincular a instalação à sua organização Claude.
  • Volte para a aba da página de administração, onde a lista na caixa de diálogo é atualizada.
4

Escolha os repositórios

Selecione os repositórios que você deseja revisar e clique em Continue. Adicionar um repositório exige acesso de escrita a ele a partir da conta do GitHub que você conectou. Você pode adicionar mais repositórios posteriormente.
5

Clique em Finish

Em seguida, aparece uma caixa de diálogo Code review is set up. Clique em Finish para ativar o Code Review. Se você fechar a caixa de diálogo de qualquer outra forma, seus repositórios permanecem adicionados, mas Allow code review continua desativado, e você o ativa pelo botão.Cada repositório começa configurado para revisar após cada push, o que executa o maior número de revisões. Para executar menos, defina quando as revisões são executadas.
6

Verifique com um pull request de teste

Abra um pull request de teste em um dos repositórios que você adicionou e não o marque como rascunho. Uma execução de verificação chamada Claude Code Review aparece em poucos minutos. Se você já configurou o repositório como Manual (@claude review), comente @claude review no pull request para iniciar a primeira revisão.Se nenhuma execução de verificação aparecer, consulte No check run appears on the test pull request.Quando a revisão chegar, envie aos seus desenvolvedores Ler e solicitar revisões em um pull request, que aborda os níveis de gravidade, os comandos de comentário e como responder às descobertas.

​
Definir padrões para sua organização

Como Owner, você decide o quão minuciosas são as revisões e com que frequência elas são executadas. Ambas as opções estão na seção Code review de Admin settings > Claude Code.

​
Definir o nível de revisão padrão

O nível de revisão define o quão minuciosa é cada revisão, e uma revisão mais minuciosa custa mais. Você define um padrão para a organização e pode sobrescrevê-lo para repositórios individuais.
  • Padrão da organização: selecione um nível em Review level e confirme com Change level. Todos os repositórios o usam, a menos que você atribua a um repositório o seu próprio nível.
  • Um repositório: clique em Edit na linha do repositório e selecione um Review level ali. A primeira opção, Default, segue a organização. O nível é salvo assim que você o seleciona.
Um novo nível se aplica às revisões que começam após a alteração. Para saber o que mais influencia o custo de cada revisão, consulte Custos e uso do Code Review.

​
Definir quando as revisões são executadas

Cada repositório tem sua própria configuração Review runs, que decide quando seus pull requests são revisados.
  • Once after PR creation: uma revisão é executada quando um pull request é aberto, reaberto ou marcado como pronto para revisão
  • After every push: uma revisão é executada em pushes para o branch do pull request, detectando novos problemas à medida que o pull request evolui e resolvendo automaticamente threads quando você corrige problemas sinalizados
  • Manual (@claude review): abrir um pull request ou fazer push para ele não inicia uma revisão. Comente @claude review para solicitar uma, ou @claude review always para também inscrever o pull request em revisões nos pushes subsequentes.
O modo Manual é útil para repositórios de alto tráfego nos quais você deseja incluir pull requests específicos na revisão, ou para começar a revisar pull requests somente quando estiverem prontos. Para comparar o efeito de cada opção nos gastos, consulte Com que frequência as revisões são executadas. Para alterar a configuração, clique em Edit na linha do repositório na tabela Repositories e selecione uma opção de Review runs. A escolha é salva assim que você a seleciona, e a coluna Review runs da tabela a mostra abreviada como Once per PR, Every push ou Manual.
  • Rascunhos e pull requests de forks: seja qual for a opção escolhida, as revisões automáticas ignoram ambos
  • Novos repositórios: um repositório que você adiciona pela caixa de diálogo Add a repository começa em After every push. Se sua organização do GitHub estiver coberta como um todo, ele assume a configuração da linha dessa organização.

​
Ativar ou desativar comentários de dica

Um comentário de dica é um comentário curto que o Claude publica em um pull request quando nenhuma revisão é iniciada, informando o motivo e o que fazer em seguida. Show tips on pull requests fica ativado por padrão. Com ele ativado, o Claude publica uma dica em cada um destes casos, explicando:
  • O repositório está configurado como Manual: como solicitar uma revisão com um comentário
  • O pull request vem de um fork: que um mantenedor pode solicitar a revisão
  • Um bot, ou alguém sem acesso de escrita, comenta @claude review: que nenhuma revisão foi iniciada e quem pode solicitar uma
  • A organização do GitHub não está vinculada à sua organização Claude: que as revisões estão pausadas e como vinculá-la
Desative a configuração para interromper esses comentários.

​
O que os desenvolvedores podem alterar

Os desenvolvedores recorrem a você para alterar o nível de revisão, a configuração Review runs ou quais repositórios recebem revisões. Pelo GitHub, sem a função Owner, eles podem fazer o seguinte:
  • Solicitar uma revisão: comentar @claude review em um pull request. Isso requer acesso de escrita ao repositório e funciona em rascunhos e pull requests de forks, que as revisões automáticas ignoram.
  • Inscrever um pull request em uma revisão a cada push: comentar @claude review always em um pull request que não seja um rascunho nem de um fork, como em um repositório configurado como Manual
  • Alterar o que as revisões sinalizam: fazer commit de arquivos REVIEW.md e CLAUDE.md no repositório, por exemplo para adicionar uma verificação
As revisões solicitadas pelos desenvolvedores são cobradas da sua organização. Para limitar o quanto o Code Review gasta em um mês, consulte Limitar seus gastos.

​
Gerenciar repositórios

Você pode adicionar repositórios um de cada vez ou cobrir uma organização do GitHub inteira de uma só vez, e interromper as revisões onde não as quiser.

​
Adicionar mais repositórios

Para adicionar repositórios após a configuração, clique em Add acima da tabela Repositories na seção Code review. A caixa de diálogo Add a repository é aberta. Selecione os repositórios e clique em Continue.

​
Cobrir uma organização do GitHub inteira

Para ativar o Code Review em todos os repositórios de uma organização do GitHub, defina Review runs na linha da organização na tabela Repositories. Isso cobre todos os repositórios dela que o Claude GitHub App pode acessar, incluindo repositórios adicionados posteriormente. Isso pode aumentar significativamente os gastos. Exige todos os itens a seguir:
  • A conta do GitHub que você conectou ao Claude é owner dessa organização do GitHub.
  • A organização está no github.com. Instâncias do GitHub Enterprise Server e contas pessoais do GitHub não são elegíveis.
  • Um limite de gastos mensal está definido, para sua organização Claude ou para o Code Review.
Para cobrir a organização, clique em Edit na linha dela, selecione uma opção de Review runs e confirme. As opções são as três de Definir quando as revisões são executadas, mais Off. Após a confirmação, estas alterações entram em vigor:
  • Cobertura: cada repositório passa a ser coberto a partir do seu próximo pull request. Se o Claude GitHub App foi instalado em repositórios selecionados em vez de em todos, o Claude revisa esses repositórios; altere o acesso do app aos repositórios no GitHub para cobrir o restante.
  • Configurações existentes: todos os repositórios dessa organização do GitHub assumem a opção que você selecionar, incluindo repositórios que você havia configurado individualmente. Definir a linha novamente tem o mesmo efeito. Os repositórios que você desativou em suas próprias linhas permanecem desativados.
  • Alterações individuais posteriores: um repositório que você configurar depois de forma diferente da sua organização é marcado como Custom na tabela.
  • Nível de revisão: uma linha de organização não tem nível de revisão próprio.

​
Desativar o Code Review ou remover um repositório

Na seção Code review de Admin settings > Claude Code, escolha o controle que corresponde ao que você deseja interromper:
  • Um repositório, mantendo-o na lista: clique em Edit na linha dele e desative Code review. A tabela mostra o repositório como Off.
  • Um repositório, removendo-o: clique em Edit na linha dele e, em seguida, em Remove repository na parte inferior da caixa de diálogo. As revisões são interrompidas ali, e outra organização Claude pode então configurar esse repositório. Enquanto a organização do GitHub do repositório estiver coberta como um todo, você não pode removê-lo; desative o botão Code review dele em vez disso.
  • Uma organização do GitHub inteira: clique em Edit na linha da organização e selecione Off. Isso também desativa os repositórios dessa organização que você adicionou um de cada vez.
  • Tudo: desative Allow code review. Nenhuma nova revisão é iniciada em nenhum repositório, e sua lista de repositórios é mantida para que você possa reativá-lo mais tarde.