Índice
- 1. O que esse erro realmente está dizendo
- 2. Contexto: como o Claude Code enxerga o seu PR
- 3. Por que acontece — 6 causas raiz
- 4. Resolva agora — a ordem de diagnóstico
- 5. Referência rápida de comandos
- 6. Dá para ignorar "pode estar desatualizada"?
- 7. Checklist de prevenção de reincidência
- Resumo
- FAQ
Você termina de construir um recurso no Claude Code. O diff mostra +2,148 −14, a branch é main e só falta apertar "Create PR" — e então um banner vermelho aparece no topo da tela:
⚠ Requisição inválida
Não foi possível verificar o status do pull request.
Esta informação pode estar desatualizada.O incômodo é que o botão "Create PR" continua ali, mas você já não consegue saber qual é o estado atual do PR — se ainda não foi criado, se já está aberto ou se foi mesclado. Do nada, e sem nenhuma relação com as suas alterações de código, somente "como esta branch está no GitHub neste momento" fica invisível.
A conclusão primeiro: na maioria dos casos isso não é um erro fatal. O Claude Code busca o status do PR no GitHub por meio da GitHub CLI (gh), e quando essa consulta falha aparece este banner vermelho. A causa é uma de três — o gh não está instalado, a autenticação não passa ou a conexão caiu por um instante — ou então a branch ainda não tem PR / não foi enviada ao remoto. Este artigo percorre o mecanismo conforme descrito na documentação oficial e no CHANGELOG, as 6 causas raiz, a ordem de diagnóstico, uma referência rápida de comandos e como evitar que se repita.
"Não foi possível verificar o status do PR" em resumo
— o Claude Code perguntou ao GitHub pelo estado; essa única requisição falhou
A essência: não é "um problema de código", e sim "um problema de comunicação/autenticação com o GitHub".
Seu trabalho (geração de código, commits) normalmente pode continuar. Não há motivo para correr para uma nova sessão.
1. O que esse erro realmente está dizendo
Lido de forma simples, ele diz: "Não consegui verificar em que estado está o pull request desta branch no GitHub neste momento, então a informação exibida na tela pode estar desatualizada."
O que importa é entender que duas coisas NÃO aconteceram. Primeiro, o seu código e o seu diff não estão quebrados — as alterações de +2,148 −14 continuam exatamente ali na sua árvore de trabalho. Segundo, ele não diz "a criação do PR falhou". Este é um aviso do lado de leitura: "Como passo anterior à criação de um PR, tentei ler o estado atual do PR (não criado / aberto / mesclado / fechado) e falhei."
Em outras palavras, esse banner é uma mensagem do tipo "não consegui sincronizar", e normalmente é temporário. Minha leitura: quando você vir esse banner vermelho, a primeira coisa a suspeitar não é "o seu código", e sim "o estado da conexão com o GitHub" — especificamente estes três pontos: se a autenticação expirou, se a rede está acessível e se esta branch está sequer em um estado em que um PR poderia existir (enviada para o remoto).
2. Contexto: como o Claude Code enxerga o seu PR
O status de um PR (não criado / aberto / mesclado / fechado) só existe nos servidores do GitHub. O Claude Code consulta o GitHub a cada vez e reflete a resposta no selo e nos botões da tela. O caminho da consulta está descrito na documentação do app desktop da Anthropic e no CHANGELOG do Claude Code, e ambos dependem da GitHub CLI (gh) (conferido nos originais em 30 de setembro de 2026).
| Onde | Como o status do PR é obtido | Fonte |
|---|---|---|
| App desktop, aba Code ("Create PR" e a barra de status de CI) | Consulta periodicamente os resultados das verificações com o gh / exige o gh instalado e autenticado (se faltar, o app pede a instalação na primeira vez que você tenta criar um PR) | Documentação do desktop, "Monitor pull request status" |
| Terminal (CLI), selo de PR abaixo do prompt | Normalmente gh pr view / no Bedrock, Vertex e Foundry, ou com a telemetria desativada, chama a API do GitHub diretamente com o token de gh auth token, GH_TOKEN ou GITHUB_TOKEN | CHANGELOG 2.1.251 |
| Frequência de verificação desse selo | Verifica menos enquanto o PR não muda / um push ou um comando gh pr o atualiza na hora / ao voltar ao terminal, pula a nova verificação se a anterior tiver menos de um minuto | CHANGELOG 2.1.248 e 2.1.247 |
Ou seja, o status do PR só é obtido quando quatro condições se alinham: "o gh está instalado, o gh está autenticado, a rede responde, e a branch e o PR existem no remoto". Se faltar qualquer uma, surge o banner vermelho. Além disso, no login pelo navegador (o padrão), o gh guarda o token no armazenamento de credenciais do sistema e só recorre a um arquivo de texto simples quando esse armazenamento não está disponível (o gh auth status mostra onde; manual da GitHub CLI, gh auth login).
O que a documentação oficial não diz
Os detalhes de com que frequência o app desktop consulta e quais falhas geram "Requisição inválida" não constam da documentação oficial em 30 de setembro de 2026. O diagnóstico deste artigo se apoia no que a tabela acima documenta (se o gh está presente, autenticado e conectado).
3. Por que acontece — 6 causas raiz
Os caminhos que levam a "não foi possível verificar o status do PR" podem ser agrupados em cerca de 6. Verificá-los de cima para baixo é o mais rápido.
6 motivos pelos quais o status do PR não é obtido
gh não está instaladogh instalado e autenticado (oficial). Se gh --version falhar, ele não está instalado. Baixe em cli.github.com.gh não está logado, ou o token foi revogado. O GitHub revoga automaticamente um token que ficou um ano sem uso, e um PAT expira na data definida ao criá-lo (GitHub Docs). O gh auth status mostra isso.main), ela é igual à base e não dá para abrir um PR a partir dela.gh auth login (o padrão), repo, read:org e gist são concedidos desde o início (o mínimo oficial). As permissões ficam curtas quando você passa um PAT via --with-token ou GH_TOKEN. Um PAT fine-grained só alcança os repositórios que você autorizou.gh, a autenticação e a rede estão funcionando, normalmente some depois de esperar um pouco e tentar de novo.
As causas 1–5 são problemas de configuração/estado (corrigidas, não voltam).
A causa 6 é passageira. Começar pelas causas 1–2 (gh presente e autenticado) e pela 3 (push / existência do PR) é o caminho mais curto.
4. Resolva agora — a ordem de diagnóstico
Quando o banner vermelho aparecer, siga 4 passos de cima para baixo. Os STEPS 1 e 2 cobrem as causas 1–3.
A ordem do diagnóstico
gh e a autenticaçãogh --version para ver se o gh está instalado e gh auth status para a autenticação. Se houver problema, ele sai com código 1 e diz o motivo. Faça login de novo com gh auth login.git push -u origin <branch> e confirme se existe um PR com gh pr view ou gh pr status. Se não houver, é só criar.gh auth refresh restaura os scopes mínimos.
A regra: "Desconfie da conexão com o GitHub antes de desconfiar do código."
O gh auth status do STEP 1 é o movimento mais rápido rumo à causa real.
Mais um ponto: mesmo com este banner, seus commits locais e a árvore de trabalho estão seguros. Não precisa correr para um git reset nem descartar a sessão. Primeiro conserte a conexão e depois aperte "Create PR" de novo. Se ainda assim não conseguir criar pela interface, rode gh pr create em um terminal para criar o PR sem passar pela interface do Claude Code. Se a branch ainda não foi enviada, o gh pr create pergunta para onde fazer o push (manual da GitHub CLI).
5. Referência rápida de comandos
Estes são os comandos do diagnóstico. Rode-os de cima para baixo e você vai estreitar naturalmente qual CAUSA se aplica.
| Objetivo | Comando | O que observar |
|---|---|---|
O gh está instalado? | gh --version | Se imprime uma versão (se não, instale em cli.github.com) |
| A autenticação está viva? | gh auth status | Se aparece "Logged in to github.com" / código de saída 1 se houver problema |
| Login de novo | gh auth login | Pelo navegador por padrão (concede repo, read:org, gist) |
| Restaurar scopes | gh auth refresh | Recupera os scopes mínimos (repo, read:org, gist) |
| Conferir o remoto | git remote -v | Se o origin aponta para o repositório certo no GitHub |
| Enviar a branch | git push -u origin <branch> | Cumpre o pré-requisito para um PR existir |
| PR da branch atual | gh pr view | Mesmo método do selo no terminal / se falhar, o selo também falha |
| Lista e status de PRs | gh pr status | Se a branch atual tem PR / aberto ou mesclado |
| Criar o PR pela CLI | gh pr create | Criar direto, sem a interface (alternativa) |
| Teste de conectividade | gh api rate_limit | Se responde, a conexão está ok / veja remaining para o limite de taxa |
Se gh auth status retorna "Logged in" e gh pr view responde normalmente, o mais provável é que seja só a exibição do Claude Code desatualizada. Atualize para a versão mais recente e reinicie, e o selo volta a sincronizar.
6. Dá para ignorar "pode estar desatualizada"?
A frase "esta informação pode estar desatualizada" significa coisas diferentes em situações diferentes. Você precisa distinguir quando ela pode ser ignorada de quando exige ação.
✅ Pode ignorar (inofensivo)
gh auth statusestá OK- outras operações de Git/push passam normalmente
- some após uma curta espera / nova tentativa
- o selo do PR só parece desatualizado por um instante
→ Apenas um atraso de sincronização / cache. Continue trabalhando.
⚠ Exige ação (real)
gh auth statusdiz "not logged in"- tanto o push quanto o pull falham
- não some por mais que você tente de novo
- apertar "Create PR" não avança
→ Um problema real de autenticação/conexão. Resolva com os STEP 1–3.
O teste decisivo é, novamente, um único gh auth status. Se ele estiver verde (Logged in) e outras operações de Git passarem, você pode deixar o banner em paz. Por outro lado, se a autenticação estiver fora do ar, então operações além dos PRs (push, obtenção de reviews etc.) cedo ou tarde também vão falhar, então é sensato resolver na hora.
7. Checklist de prevenção de reincidência
Um checklist prático para que o mesmo banner vermelho não fique te incomodando.
① Em uma máquina nova, instale o gh e conclua o gh auth login antes de criar PRs pelo Claude Code. ② Crie o hábito de conferir o gh auth status de vez em quando (o GitHub revoga um token sem uso por um ano, e um PAT expira na data definida ao criá-lo). ③ Se usar PAT, crie um classic com repo, read:org e gist, ou inclua o repositório em um PAT fine-grained. ④ Não deixe tokens antigos nas variáveis de ambiente GH_TOKEN / GITHUB_TOKEN (elas têm prioridade sobre o login salvo; manual da GitHub CLI). ⑤ Ao começar em uma branch nova, faça git push -u origin <branch> cedo. ⑥ Em rede corporativa (proxy/VPN), verifique a conectividade uma vez com gh api rate_limit. ⑦ Mantenha o Claude Code atualizado — como mostra o CHANGELOG, a forma de obter o selo de PR já mudou várias vezes. ⑧ Se a interface continuar instável, crie os PRs com gh pr create.
Resumo
O "Não foi possível verificar o status do pull request. Esta informação pode estar desatualizada" do Claude Code indica não um defeito de código, mas que a consulta ao GitHub (que oficialmente depende da CLI gh) não passou. Normalmente é um atraso de sincronização inofensivo, mas por trás dele pode se esconder um gh não instalado, autenticação expirada, branch sem push / sem PR, problema de rede ou permissões de um PAT.
O diagnóstico mais rápido: ① confira o gh e a autenticação com gh --version e gh auth status, ② confira o push e o PR com git push + gh pr view, ③ inspecione conectividade e permissões, ④ se estiver tudo certo, espere, tente de novo e atualize para a versão mais recente. Se realmente não der para criar pela interface, crie direto com gh pr create. "Desconfie da conexão com o GitHub antes de desconfiar do código" — lembre disso e este banner vermelho não vai mais te assustar.
Leitura relacionada: O que é o GitHub Copilot, O que é o Claude Agent SDK, O erro 400 dos blocos de pensamento do Claude Code e o fluxo de deploy com Claude Code / Cursor.
FAQ
Q. Se esse erro aparecer, meu código ou meu diff serão perdidos?
A. Não. Este é um aviso do lado da comunicação de que "o estado do PR não pôde ser lido"; ele não tem nenhum efeito sobre seus commits locais, sua árvore de trabalho ou seu diff (como +2,148 −14). Não há motivo para correr para um git reset nem para descartar a sua sessão.
Q. O que devo verificar primeiro?
A. gh auth status. Esse único comando diz se a sua autenticação no GitHub está ativa. Se você vir "Logged in", a autenticação está OK — normalmente é transitório, então aguarde e tente de novo. Se não, refaça o login com gh auth login e a maioria dos casos se resolve.
Q. Posso deixar "esta informação pode estar desatualizada" em paz?
A. Se tanto a autenticação quanto a rede estiverem ativas, sim. Muitas vezes é apenas um atraso de sincronização / cache e some após uma curta espera ou nova tentativa. Mas se o gh auth status disser "not logged in", ou se até o push falhar, isso é um problema real — resolva.
Q. O "Create PR" não passa por mais que eu tente.
A. Execute gh pr create diretamente do terminal, contornando a GUI; isso permite criar o próprio PR. Se ainda falhar, verifique se a branch está no remoto com git push -u origin <branch> e se o origin aponta para o repositório correto com git remote -v.
Q. Acontece com frequência na minha rede corporativa. Por quê?
A. É provável que um proxy, VPN ou firewall esteja bloqueando o tráfego para api.github.com. Verifique se o gh api rate_limit responde; se não responder, você precisa de uma liberação do lado da rede (adicionar os domínios do GitHub à lista de permissões). Desligar temporariamente a VPN para isolar o problema também ajuda.
Q. O selo de PR abaixo do prompt do terminal continua desatualizado.
A. Segundo o CHANGELOG, o selo verifica menos enquanto o PR não muda, e um push ou um comando gh pr o atualiza na hora (2.1.248). Se não atualizar, veja se gh pr view funciona no seu terminal. No Bedrock, Vertex ou Foundry, ou com a telemetria desativada, ele chama a API diretamente com o token de gh auth token, GH_TOKEN ou GITHUB_TOKEN em vez de gh pr view (2.1.251), então confirme que esse token é válido.
Q. O gh auth status está ok, mas o status do PR continua sem vir.
A. Desconfie do alcance do token realmente em uso. Um PAT fine-grained só alcança os repositórios que você autorizou, então mesmo com login válido ele pode não ler os PRs do repositório. Além disso, se a variável de ambiente GH_TOKEN ou GITHUB_TOKEN estiver definida, o gh a usa com prioridade sobre o login salvo (manual da GitHub CLI). Verifique se não há um token indesejado.
Erros do Claude Code relacionados: referência de erros do Claude Code, Unable to connect, 529 Overloaded / 500.
