8 8
9Com 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.9Com 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.
10 10
11As descobertas chegam como comentários inline nas linhas em questão, classificadas por [severidade](/docs/pt/code-review-pull-requests#severity-levels), 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.11As descobertas chegam como comentários inline nas linhas em questão, classificadas por [severidade](/docs/pt/code-review-pull-requests.md#severity-levels), 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.
12 12
1313
14 14
16>16>
17> 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.17> 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.
18 18
19Para ativar Code Review, um Owner de sua organização Claude segue [Configurar Code Review](/docs/pt/code-review-setup). Claude também pode revisar código sem este serviço. Execute [`/code-review`](/docs/pt/code-review-local) em sua sessão do Claude Code em qualquer plano, ou [compare todas as opções](#compare-ways-to-get-a-review).19Para ativar Code Review, um Owner de sua organização Claude segue [Configurar Code Review](/docs/pt/code-review-setup.md). Claude também pode revisar código sem este serviço. Execute [`/code-review`](/docs/pt/code-review-local) em sua sessão do Claude Code em qualquer plano, ou [compare todas as opções](#compare-ways-to-get-a-review).
20 20
21## Disponibilidade21## Disponibilidade
22 22
23Verifique se sua organização se qualifica antes de configurar Code Review:23Verifique se sua organização se qualifica antes de configurar Code Review:
24 24
25* **Planos**: [Team e Enterprise](/docs/pt/feature-availability)25* **Planos**: [Team e Enterprise](/docs/pt/feature-availability.md)
26* **Hosts de código**: repositórios hospedados no GitHub, incluindo [GitHub Enterprise Server](/docs/pt/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](/docs/pt/github-enterprise-server#admin-setup) e insira o hostname `ghe.com` de sua empresa.26* **Hosts de código**: repositórios hospedados no GitHub, incluindo [GitHub Enterprise Server](/docs/pt/github-enterprise-server.md) 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](/docs/pt/github-enterprise-server.md#admin-setup) e insira o hostname `ghe.com` de sua empresa.
27* **Retenção de dados**: Code Review não está disponível para organizações com [Zero Data Retention](/docs/pt/zero-data-retention) ativado ou com a [configuração HIPAA](/docs/pt/hipaa-setup) aplicada, e não é coberto pelo Business Associate Agreement (BAA) da Anthropic.27* **Retenção de dados**: Code Review não está disponível para organizações com [Zero Data Retention](/docs/pt/zero-data-retention.md) ativado ou com a [configuração HIPAA](/docs/pt/hipaa-setup.md) aplicada, e não é coberto pelo Business Associate Agreement (BAA) da Anthropic.
28* **Chaves de criptografia**: Code Review ainda não está disponível para organizações que usam chaves de criptografia gerenciadas pelo cliente (CMEK).28* **Chaves de criptografia**: Code Review ainda não está disponível para organizações que usam chaves de criptografia gerenciadas pelo cliente (CMEK).
29* **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 Foundry29* **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
30 30
32 32
33Escolha a página para o que você precisa fazer:33Escolha a página para o que você precisa fazer:
34 34
35> **[Configurar Code Review](/docs/pt/code-review-setup)**35> **[Configurar Code Review](/docs/pt/code-review-setup.md)**
36>36>
37> 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 executadas37> 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
38 38
39> **[Personalizar Code Review](/docs/pt/code-review-customize)**39> **[Personalizar Code Review](/docs/pt/code-review-customize.md)**
40>40>
41> Ajuste o que é sinalizado com arquivos `REVIEW.md` e `CLAUDE.md` em seu repositório41> Ajuste o que é sinalizado com arquivos `REVIEW.md` e `CLAUDE.md` em seu repositório
42 42
43> **[Ler e solicitar revisões em um pull request](/docs/pt/code-review-pull-requests)**43> **[Ler e solicitar revisões em um pull request](/docs/pt/code-review-pull-requests.md)**
44>44>
45> Leia as descobertas e suas severidades, e solicite outra revisão com um comentário45> Leia as descobertas e suas severidades, e solicite outra revisão com um comentário
46 46
47> **[Solução de problemas do Code Review](/docs/pt/code-review-troubleshooting)**47> **[Solução de problemas do Code Review](/docs/pt/code-review-troubleshooting.md)**
48>48>
49> Corrija uma revisão que não iniciou, falhou ou foi ignorada por orçamento49> Corrija uma revisão que não iniciou, falhou ou foi ignorada por orçamento
50 50
51> **[Custos e uso do Code Review](/docs/pt/code-review-costs)**51> **[Custos e uso do Code Review](/docs/pt/code-review-costs.md)**
52>52>
53> Veja como as revisões são faturadas, estime gastos, defina o limite de gasto mensal e acompanhe a atividade de revisão53> Veja como as revisões são faturadas, estime gastos, defina o limite de gasto mensal e acompanhe a atividade de revisão
54 54
55## Como as revisões funcionam55## Como as revisões funcionam
56 56
57Por 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](/docs/pt/code-review-customize) ao seu repositório.57Por 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](/docs/pt/code-review-customize.md) ao seu repositório.
58 58
59Uma revisão é executada na infraestrutura da Anthropic em quatro etapas:59Uma revisão é executada na infraestrutura da Anthropic em quatro etapas:
60 60
66Cada revisão deixa estes itens no pull request:66Cada revisão deixa estes itens no pull request:
67 67
68* **Descobertas**: comentários inline nas linhas em questão, com um resumo no corpo da revisão68* **Descobertas**: comentários inline nas linhas em questão, com um resumo no corpo da revisão
69* **Uma execução de verificação**: chamada **Claude Code Review**, com as descobertas listadas em seus [detalhes](/docs/pt/code-review-pull-requests#check-run-output). A execução de verificação não é concluída como falha.69* **Uma execução de verificação**: chamada **Claude Code Review**, com as descobertas listadas em seus [detalhes](/docs/pt/code-review-pull-requests.md#check-run-output). A execução de verificação não é concluída como falha.
70* **Quando não encontra nada**: o título da execução de verificação diz **Code review found no issues**, e Claude publica a mesma nota curta no pull request70* **Quando não encontra nada**: o título da execução de verificação diz **Code review found no issues**, e Claude publica a mesma nota curta no pull request
71 71
72Code 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](#review-levels).72Code 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](#review-levels).
73 73
74Depois que um Owner ativa Code Review, cada repositório tem uma configuração para [quando as revisões são executadas](/docs/pt/code-review-setup#set-when-reviews-run): 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](/docs/pt/code-review-pull-requests#comment-commands).74Depois que um Owner ativa Code Review, cada repositório tem uma configuração para [quando as revisões são executadas](/docs/pt/code-review-setup.md#set-when-reviews-run): 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](/docs/pt/code-review-pull-requests.md#comment-commands).
75 75
76### Níveis de revisão76### Níveis de revisão
77 77
81* **Standard**: profundidade, velocidade e custo equilibrados. O nível padrão.81* **Standard**: profundidade, velocidade e custo equilibrados. O nível padrão.
82* **Deep**: a passagem mais minuciosa. Leva mais tempo e custa mais.82* **Deep**: a passagem mais minuciosa. Leva mais tempo e custa mais.
83 83
84Um Owner [escolhe um nível para a organização](/docs/pt/code-review-setup#set-the-default-review-level) 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](/docs/pt/code-review-costs).84Um Owner [escolhe um nível para a organização](/docs/pt/code-review-setup.md#set-the-default-review-level) 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](/docs/pt/code-review-costs.md).
85 85
86### O que uma revisão pode acessar86### O que uma revisão pode acessar
87 87
88Uma revisão acessa seu repositório através do Claude GitHub App que um Owner [instala durante a configuração](/docs/pt/code-review-setup#turn-on-code-review):88Uma revisão acessa seu repositório através do Claude GitHub App que um Owner [instala durante a configuração](/docs/pt/code-review-setup.md#turn-on-code-review):
89 89
90* **Onde é executada**: na infraestrutura da Anthropic, em um ambiente gerenciado. As revisões não são executadas em [ambientes auto-hospedados](/docs/pt/self-hosted-environments).90* **Onde é executada**: na infraestrutura da Anthropic, em um ambiente gerenciado. As revisões não são executadas em [ambientes auto-hospedados](/docs/pt/self-hosted-environments).
91* **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](/docs/pt/code-review-pull-requests#check-run-output), 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](/docs/pt/github-actions#github-app-permissions) que outros recursos Claude compartilham.91* **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](/docs/pt/code-review-pull-requests.md#check-run-output), 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](/docs/pt/github-actions.md#github-app-permissions) que outros recursos Claude compartilham.
92* **Como examina seu código**: uma revisão trabalha lendo o diff e o código circundante, sem compilar ou executar seu código.92* **Como examina seu código**: uma revisão trabalha lendo o diff e o código circundante, sem compilar ou executar seu código.
93 93
94### Quem controla uma revisão94### Quem controla uma revisão
95 95
96* **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](/docs/pt/code-review-pull-requests#review-drafts-and-pull-requests-from-forks). Um [comando de comentário](/docs/pt/code-review-pull-requests#comment-commands) inicia uma apenas quando vem de uma pessoa com acesso de escrita ao repositório.96* **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](/docs/pt/code-review-pull-requests.md#review-drafts-and-pull-requests-from-forks). Após alguns pushes, Code Review [mantém o resultado anterior](/docs/pt/code-review-pull-requests.md#when-a-push-keeps-the-earlier-result) em vez disso. Um [comando de comentário](/docs/pt/code-review-pull-requests.md#comment-commands) inicia uma apenas quando vem de uma pessoa com acesso de escrita ao repositório.
97* **Quais instruções segue**: `REVIEW.md` do branch base ou padrão e [nunca das próprias alterações do pull request](/docs/pt/code-review-customize#which-branch-review-md-is-read-from).97* **Quais instruções segue**: `REVIEW.md` do branch base ou padrão e [nunca das próprias alterações do pull request](/docs/pt/code-review-customize.md#which-branch-review-md-is-read-from).
98 98
99## Comparar formas de obter uma revisão99## Comparar formas de obter uma revisão
100 100
104| :- | :- | :- | :- |104| :- | :- | :- | :- |
105| [Code Review](#how-reviews-work) | Atividade de pull request, conforme configurado em cada repositório, ou um comentário `@claude review` | Infraestrutura da Anthropic | Organizações em um plano Team ou Enterprise com repositórios GitHub, depois que um Owner o ativa |105| [Code Review](#how-reviews-work) | Atividade de pull request, conforme configurado em cada repositório, ou um comentário `@claude review` | Infraestrutura da Anthropic | Organizações em um plano Team ou Enterprise com repositórios GitHub, depois que um Owner o ativa |
106| [`/code-review`](/docs/pt/code-review-local) | Você executa o comando em seu branch | Sua sessão do Claude Code | Qualquer pessoa, em qualquer plano |106| [`/code-review`](/docs/pt/code-review-local) | Você executa o comando em seu branch | Sua sessão do Claude Code | Qualquer pessoa, em qualquer plano |
107| [Ultrareview](/docs/pt/ultrareview) | Você a inicia a partir do Claude Code | Um sandbox na nuvem | Requer login com uma conta claude.ai. Consulte [Ultrareview](/docs/pt/ultrareview) para saber onde não está disponível |107| [Ultrareview](/docs/pt/ultrareview.md) | Você a inicia a partir do Claude Code | Um sandbox na nuvem | Requer login com uma conta claude.ai. Consulte [Ultrareview](/docs/pt/ultrareview.md) para saber onde não está disponível |
108| Claude em seu próprio CI, com [GitHub Actions](/docs/pt/github-actions) ou [GitLab CI/CD](/docs/pt/gitlab-ci-cd) | Os eventos do seu pipeline, como cada pull request ou merge request | Seus próprios runners de CI | Qualquer pessoa com uma chave de API do Claude ou credenciais de provedor de nuvem, no GitHub ou GitLab |108| Claude em seu próprio CI, com [GitHub Actions](/docs/pt/github-actions.md) ou [GitLab CI/CD](/docs/pt/gitlab-ci-cd.md) | Os eventos do seu pipeline, como cada pull request ou merge request | Seus próprios runners de CI | Qualquer pessoa com uma chave de API do Claude ou credenciais de provedor de nuvem, no GitHub ou GitLab |
109| Seu próprio revisor, como um [subagente](/docs/pt/sub-agents) ou [skill](/docs/pt/skills) | Você ou Claude o invocam durante uma sessão | Onde quer que você execute Claude Code | Qualquer pessoa que escreva um |109| Seu próprio revisor, como um [subagente](/docs/pt/sub-agents.md) ou [skill](/docs/pt/skills.md) | Você ou Claude o invocam durante uma sessão | Onde quer que você execute Claude Code | Qualquer pessoa que escreva um |
110 110
111## Recursos relacionados111## Recursos relacionados
112 112
113* [GitHub Enterprise Server](/docs/pt/github-enterprise-server): use Code Review com uma instância GitHub auto-hospedada113* [GitHub Enterprise Server](/docs/pt/github-enterprise-server.md): use Code Review com uma instância GitHub auto-hospedada
114* [Permissões do GitHub App](/docs/pt/github-actions#github-app-permissions): o conjunto completo de permissões que o Claude GitHub App solicita114* [Permissões do GitHub App](/docs/pt/github-actions.md#github-app-permissions): o conjunto completo de permissões que o Claude GitHub App solicita
115* [How Anthropic secures its AI-native software development lifecycle](https://claude.com/blog/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 Anthropic115* [How Anthropic secures its AI-native software development lifecycle](https://claude.com/blog/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