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

# Solucionar problemas do Code Review

> Corrija um Code Review que não foi iniciado, falhou ou foi ignorado por causa do orçamento, encontre achados ausentes e resolva problemas de configuração e de `REVIEW.md`.

Quando o [Code Review](/docs/pt/code-review) não faz o que você espera em um pull request, comece pela check run **Claude Code Review**. O título dela informa até onde a revisão chegou.

<h2 id="check-how-far-the-review-got">
  Verifique até onde a revisão chegou
</h2>

Encontre a check run **Claude Code Review** no seu pull request e, em seguida, compare o título dela com um destes mais comuns:

| Título da check run | O que significa | O que fazer |
| :- | :- | :- |
| **Code review queued...** ou **Code review in progress...** | A revisão ainda não terminou | Aguarde o título mudar |
| **Code review found no issues** | A revisão terminou e não encontrou nada a sinalizar | Nada |
| Um título informando que foram encontrados problemas | A revisão terminou com achados | Se você não os vê no diff, consulte [Encontre problemas que não aparecem como comentários inline](#find-issues-that-aren’t-showing-as-inline-comments) |
| **Code review skipped — no new changes** | Uma revisão automática não foi executada no seu push mais recente | Para obter uma revisão mesmo assim, comente `@claude review` |
| **Code review failed** ou **Code review timed out** | A revisão não terminou | Para executá-la novamente, consulte [Dispare novamente uma revisão que falhou ou expirou](#retrigger-a-failed-or-timed-out-review) |
| **Code review declined** | A revisão não foi executada | Leia o resumo da check run. Se ele mencionar um orçamento ou um limite de gastos, consulte [A revisão não foi executada e o PR mostra uma mensagem de orçamento](#review-didn’t-run-and-the-pr-shows-a-budget-message) |
| Nenhuma check run | Nenhuma revisão foi iniciada | Comente `@claude review`. Se nenhuma check run aparecer depois disso, consulte [Um comando em comentário não iniciou uma revisão](#a-comment-command-didn’t-start-a-review) |

<h2 id="a-review-didn’t-start">
  Uma revisão não foi iniciada
</h2>

Verifique estes casos quando nenhuma check run **Claude Code Review** aparecer, ou quando o Claude publicar um comentário dizendo que a revisão foi ignorada.

<h3 id="a-comment-command-didn’t-start-a-review">
  Um comando em comentário não iniciou uma revisão
</h3>

Depois de comentar `@claude review`, procure no pull request uma check run **Claude Code Review** com o título **Code review queued...** ou **Code review in progress...**. Uma reação 👀 no seu comentário não confirma que uma revisão está a caminho. Se nenhuma check run aparecer, verifique cada uma destas causas:

* **O Code Review não está ativado para este repositório**: o Claude não publica nenhum comentário nem check run em resposta ao comando. Peça a um Owner para [adicionar o repositório](/docs/pt/code-review-setup#add-more-repositories).
* **O comentário não atende a uma condição**: era um comentário inline ou o corpo de uma revisão, em vez de um novo comentário de nível superior, ou o comando não estava no início do comentário. Editar um comentário anterior em vez de publicar um novo também não conta, e o pull request precisa estar aberto. Consulte as [condições para comandos em comentários](/docs/pt/code-review-pull-requests#comment-commands) e publique um novo comentário que as atenda.
* **Você não tem acesso de escrita**: você precisa da permissão write, maintain ou admin no repositório e, em um pull request de um fork, a permissão que conta é a do repositório base. Se a sua organização tiver as dicas ativadas, o Claude responde "No review was started: manual reviews can only be requested by someone with write access to this repository." Peça a alguém com acesso de escrita para comentar.
* **O orçamento acabou**: o Claude publica um comentário que começa com "⚠️ Code review skipped". Consulte [A revisão não foi executada e o PR mostra uma mensagem de orçamento](#review-didn’t-run-and-the-pr-shows-a-budget-message).

<h3 id="review-didn’t-run-and-the-pr-shows-a-budget-message">
  A revisão não foi executada e o PR mostra uma mensagem de orçamento
</h3>

Quando o orçamento da sua organização não consegue cobrir uma revisão, o Code Review ignora a revisão e o Claude publica no pull request um comentário que começa com "⚠️ Code review skipped". Em alguns desses casos, também aparece uma check run com o título **Code review declined**.

O comentário inclui um link para [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage), onde um administrador restaura o orçamento. O texto dele informa qual limite foi atingido:

* **"has reached its monthly code review spending cap"**: o [limite mensal de gastos do Code Review](/docs/pt/code-review-costs#limit-your-spend) foi atingido. As revisões são retomadas no início do próximo período de faturamento. Para obtê-las antes, peça a um administrador para aumentar o limite.
* **"has no extra usage available to pay for this review"**: o saldo de [créditos de uso](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) da sua organização está vazio, ou o limite mensal geral de gastos dela foi atingido. Peça a um administrador para adicionar créditos de uso ou aumentar esse limite.
* **"is too low to start another review"**: o que resta do orçamento ou do saldo é menor que o custo esperado de uma revisão. Peça a um administrador para aumentar o limite ou adicionar créditos de uso.

Depois que o orçamento for restaurado, comente `@claude review` no pull request para obter a revisão que foi ignorada. As [condições para comandos em comentários](/docs/pt/code-review-pull-requests#comment-commands) se aplicam, portanto quem comenta precisa de acesso de escrita.

<h2 id="retrigger-a-failed-or-timed-out-review">
  Dispare novamente uma revisão que falhou ou expirou
</h2>

Se o resumo da check run disser "The review session was interrupted before it could finish. A new review of this commit has been queued automatically.", você não precisa fazer nada. Essa revisão é repetida automaticamente uma vez.

Caso contrário, quando o título da check run for **Code review failed** ou **Code review timed out**, execute a revisão novamente com um comentário ou uma nova execução:

* **Comente `@claude review`**: publique-o como um comentário de nível superior no pull request. Isso inicia uma nova revisão sem inscrever o pull request em pushes futuros.
* **Clique em Re-run**: se o pull request não for [de um fork](/docs/pt/code-review-pull-requests#review-drafts-and-pull-requests-from-forks), clique em **Re-run** na verificação **Claude Code Review** na aba **Checks** do GitHub. A nova execução abrange o commit de head atual do pull request e também não inscreve o pull request.

<h2 id="find-issues-that-aren’t-showing-as-inline-comments">
  Encontre problemas que não aparecem como comentários inline
</h2>

Se o título da check run informar que foram encontrados problemas, mas você não vê comentários de revisão inline no diff, procure nestes outros locais onde os achados são exibidos:

* **Details da check run**: clique em **Details** ao lado da verificação **Claude Code Review** na aba **Checks**. A tabela de gravidade lista os achados com arquivo, linha e resumo, independentemente de o comentário inline ter sido aceito.
* **Anotações em Files changed**: abra a aba **Files changed** no PR. Um achado que tem uma linha, mas não foi publicado como comentário inline, aparece ali como uma anotação nas linhas em questão.
* **Corpo da revisão**: achados que não têm localização inline, ou que ficam fora do diff atual, aparecem sob o título **Additional findings** no corpo da revisão.

<h2 id="the-check-run-mentions-review-md">
  A check run menciona REVIEW\.md
</h2>

Duas das mensagens que uma check run pode conter sobre `REVIEW.md` dizem respeito à proteção de branch:

* **"This review applied the repository's review instructions (REVIEW\.md) from its default branch, which is not protected against direct pushes."**: a revisão leu apenas o arquivo raiz. Consulte [De qual branch o REVIEW.md é lido](/docs/pt/code-review-customize#which-branch-review-md-is-read-from) para saber o que muda ao proteger o branch.
* **"were not applied to this review: branch protection could not be confirmed"**: a revisão não leu nenhum `REVIEW.md`.

<h2 id="setup-problems">
  Problemas de configuração
</h2>

Estes casos surgem para um Owner durante a [configuração do Code Review](/docs/pt/code-review-setup).

<h3 id="a-repository-isn’t-listed-in-add-a-repository">
  Um repositório não aparece em Add a repository
</h3>

Primeiro, pesquise o repositório pelo nome, pois a caixa de diálogo não carrega uma lista longa por completo. A caixa de diálogo lista um repositório somente se o Claude GitHub App puder acessá-lo. Clique em **Install GitHub App** e dê ao app acesso ao repositório. Quando nenhum repositório estiver listado, **Install GitHub App** é um botão na caixa de diálogo. Caso contrário, ele fica na parte inferior do menu de filtro de organização do GitHub da caixa de diálogo.

<h3 id="no-check-run-appears-on-the-test-pull-request">
  Nenhuma check run aparece no pull request de teste
</h3>

Confirme que **Allow code review** está ativado, que o repositório está listado em **Repositories** na seção **Code review** e que o Claude GitHub App tem acesso a ele. As revisões automáticas ignoram pull requests em rascunho, e um repositório configurado como **Manual (@claude review)** precisa de um comentário `@claude review` para iniciar a primeira revisão.

<h2 id="related-resources">
  Recursos relacionados
</h2>

* [Ler e solicitar revisões em um pull request](/docs/pt/code-review-pull-requests): o que significam os achados e a check run, e os comandos em comentários
* [Configurar o Code Review](/docs/pt/code-review-setup): para Owners, ativar o Code Review e gerenciar repositórios
* [Custos e uso do Code Review](/docs/pt/code-review-costs): os limites de gastos por trás de uma mensagem de orçamento
* [Personalizar o Code Review](/docs/pt/code-review-customize): qual cópia do `REVIEW.md` uma revisão lê