> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Configurar o Code Review
> Ative o Code Review para sua organização Claude: conecte o GitHub, instale o Claude GitHub App, escolha os repositórios e defina quando as revisões são executadas
Como Owner da sua organização Claude, você ativa o Code Review em [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review) 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](/docs/pt/code-review-costs#pricing).
O que você precisa para ativar o Code Review
Primeiro, verifique se sua organização [se qualifica para o Code Review](/docs/pt/code-review#availability). Em seguida, certifique-se de que você tem este acesso, ou alguém que tenha:
| Acesso | Necessário para |
| :- | :- |
| [Função Owner](/docs/pt/server-managed-settings#access-control) na sua organização Claude | Todas as etapas na página de administração |
| Owner da organização do GitHub | Instalar o Claude GitHub App e [vinculá-lo à sua organização Claude](/docs/pt/admin-setup#connected-github-accounts). Se você não for owner, peça a um owner que instale e vincule o app antes de começar |
| Acesso de escrita a cada repositório que você adicionar, a partir da conta do GitHub que você conectar ao Claude | Adicionar o repositório |
Ativar o Code Review
Vá até a seção **Code review** de [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review) 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](#add-more-repositories) e depois volte para a última etapa.
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.
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](/docs/pt/github-actions). Consulte [o que uma revisão pode acessar](/docs/pt/code-review#what-a-review-can-access) e a [lista completa de permissões](/docs/pt/github-actions#github-app-permissions).
* 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.
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](#add-more-repositories) posteriormente.
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](#set-when-reviews-run).
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](/docs/pt/code-review-troubleshooting#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](/docs/pt/code-review-pull-requests), 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**](https://claude.ai/admin-settings/claude-code#code-review).
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.
| Nível | O que ele equilibra |
| :- | :- |
| Quick | Uma passada 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 passada mais minuciosa. Leva mais tempo e custa mais |
* **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](/docs/pt/code-review-costs).
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`](/docs/pt/code-review-pull-requests#comment-commands) 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](/docs/pt/code-review-costs#how-often-reviews-run).
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](/docs/pt/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)
* **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](#cover-a-whole-github-organization), ele assume a configuração da linha dessa organização.
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`](/docs/pt/code-review-pull-requests#comment-commands) em um pull request. Isso requer acesso de escrita ao repositório e funciona em [rascunhos e pull requests de forks](/docs/pt/code-review-pull-requests#review-drafts-and-pull-requests-from-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](/docs/pt/code-review-pull-requests#review-drafts-and-pull-requests-from-forks), como em um repositório configurado como Manual
* **Alterar o que as revisões sinalizam**: fazer commit de [arquivos `REVIEW.md` e `CLAUDE.md`](/docs/pt/code-review-customize) no repositório, por exemplo para adicionar uma verificação
As revisões solicitadas pelos desenvolvedores são [cobradas da sua organização](/docs/pt/code-review-costs#pricing). Para limitar o quanto o Code Review gasta em um mês, consulte [Limitar seus gastos](/docs/pt/code-review-costs#limit-your-spend).
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**.
* **Um repositório não está listado**: consulte [A repository isn't listed in Add a repository](/docs/pt/code-review-troubleshooting#a-repository-isn’t-listed-in-add-a-repository).
* **Você deseja todos os repositórios de uma organização do GitHub**: [cubra a organização](#cover-a-whole-github-organization) em vez de selecionar repositórios um de cada vez
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](/docs/pt/code-review-costs#limit-your-spend) 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](#set-when-reviews-run), 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**](https://claude.ai/admin-settings/claude-code#code-review), 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.
* [Custos e uso do Code Review](/docs/pt/code-review-costs): como o nível de revisão e o momento em que as revisões são executadas afetam os gastos, como definir um limite de gastos e onde ver o uso
* [Ler e solicitar revisões em um pull request](/docs/pt/code-review-pull-requests): o que os desenvolvedores veem em um pull request e os comandos de comentário
* [Personalizar o Code Review](/docs/pt/code-review-customize): ajuste o que o Claude sinaliza com `REVIEW.md` e `CLAUDE.md`
* [GitHub Enterprise Server](/docs/pt/github-enterprise-server): conecte uma instância auto-hospedada do GitHub antes da configuração