Como Corrigir o Erro de Autenticação 401 do GitHub Copilot no VS Code

Você abre o Visual Studio Code e vê um banner de erro vermelho: “GitHub Copilot: Request failed with status code 401.” Isso significa que o Copilot não consegue verificar sua identidade com os servidores do GitHub. O erro 401 aparece quando seu token de autenticação está expirado, ausente ou revogado. Este artigo explica por que o erro ocorre e fornece correções passo a passo para restaurar a funcionalidade do Copilot.

Por que o Erro 401 Ocorre com o GitHub Copilot

O código de status HTTP 401 significa “Não Autorizado.” O Copilot envia uma solicitação para a API do GitHub, mas o servidor rejeita o token de autenticação anexado. Isso pode acontecer por vários motivos:

Seu token de sessão do GitHub expirou. Os tokens emitidos pelo GitHub têm um tempo de vida limitado. Quando o token expira, o Copilot não consegue autenticar sua assinatura e o erro 401 aparece.

Sua assinatura do Copilot foi revogada ou alterada. Se sua organização removeu sua licença do Copilot ou sua assinatura pessoal expirou, o GitHub invalida seu token. Na próxima vez que o Copilot tentar se conectar, ele receberá uma resposta 401.

Um token corrompido ou duplicado existe no VS Code. Se você fez login várias vezes ou usou contas diferentes do GitHub, o VS Code pode conter um token obsoleto que não corresponde mais à sua assinatura ativa. O servidor vê isso como uma credencial inválida.

Proxies de rede ou VPNs interferem na validação do token. Alguns proxies corporativos removem ou modificam cabeçalhos de autenticação. Quando o cabeçalho está ausente ou alterado, o GitHub responde com 401.

Passos para Corrigir o Erro de Autenticação 401

Os passos a seguir estão ordenados do mais simples ao mais completo. Comece com o passo 1 e prossiga apenas se o erro persistir.

1. Sair do GitHub Copilot
   Abra o VS Code. Pressione Ctrl+Shift+P para abrir a paleta de comandos. Digite GitHub Copilot: Sign Out e pressione Enter. Isso remove a sessão de autenticação atual do VS Code.
2. Entrar no GitHub Copilot novamente
   Abra a paleta de comandos novamente com Ctrl+Shift+P. Digite GitHub Copilot: Sign In e pressione Enter. Uma janela do navegador será aberta. Faça login com sua conta do GitHub que possui uma assinatura ativa do Copilot. Após autorizar o aplicativo, retorne ao VS Code. O erro 401 deve desaparecer.
3. Limpar o cache de autenticação do VS Code
   Se sair e entrar novamente não funcionar, limpe os tokens em cache manualmente. Abra a paleta de comandos e execute Developer: Reload Window. Isso recarrega o host de extensões e limpa os tokens na memória. Em seguida, repita os passos 1 e 2.
4. Revogar o token no site do GitHub
   Acesse github.com/settings/tokens. Procure por qualquer token chamado Visual Studio Code ou GitHub Copilot. Clique no botão Excluir ao lado dele. Retorne ao VS Code e faça login novamente usando o passo 2. Isso força o GitHub a emitir um novo token.
5. Verificar o status da sua assinatura do Copilot
   Abra um navegador e acesse github.com/settings/copilot. Confirme se o Copilot está ativo e mostra uma marca de verificação verde. Se sua assinatura expirou, renove-a pelo GitHub. Após a renovação, repita os passos 1 e 2.
6. Desativar proxy ou VPN temporariamente
   Se você usa um proxy corporativo ou VPN, desative-o e tente fazer login novamente. Se o erro desaparecer, configure o proxy para permitir tráfego para api.github.com e copilot-proxy.githubusercontent.com na porta 443. Adicione esses domínios à lista de permissões do seu proxy.

Se o Copilot Ainda Mostrar 401 Após a Correção Principal

A extensão do Copilot está desatualizada

Uma versão antiga da extensão pode não suportar o protocolo de autenticação mais recente. Abra a visualização de Extensões no VS Code. Encontre GitHub Copilot. Se uma atualização estiver disponível, clique no botão Atualizar. Recarregue o VS Code e faça login novamente.

Conflito de múltiplas contas do GitHub

Se você está logado em várias contas do GitHub no VS Code, o Copilot pode usar a conta errada. Abra a paleta de comandos e execute GitHub: Sign Out para cada conta, exceto a que possui a licença do Copilot. Em seguida, faça login no Copilot usando a conta correta.

Firewall bloqueia endpoints necessários

Seu firewall de rede pode bloquear as URLs que o Copilot usa para autenticação. Certifique-se de que os seguintes domínios estejam acessíveis a partir da sua máquina: api.github.com, github.com, copilot-proxy.githubusercontent.com. Teste a conectividade executando ping api.github.com em um terminal. Se o ping falhar, entre em contato com o administrador da rede.

Política de rotação de tokens na sua organização

Algumas organizações impõem a rotação de tokens a cada 24 horas. Se seu token for rotacionado automaticamente, o VS Code pode não atualizá-lo. Nesse caso, saia e entre novamente no início de cada dia de trabalho. Alternativamente, peça ao administrador para estender o tempo de vida do token.

Atualização Manual de Token vs Atualização Automática de Token

Item	Atualização Manual de Token	Atualização Automática de Token
Gatilho	Usuário executa comandos Sign Out e Sign In	VS Code atualiza token em segundo plano
Ação do usuário necessária	Sim, cada vez que o token expira	Não, acontece silenciosamente
Melhor para	Organizações com rotação estrita de tokens	Contas pessoais com tempo de vida padrão do token
Confiabilidade	Garantido que funciona após o passo manual	Pode falhar se a extensão estiver desatualizada

O erro 401 é quase sempre um problema de token ou assinatura. Sair e entrar novamente resolve a maioria dos casos. Se o erro persistir, revogue o token do GitHub e verifique o status da sua assinatura. Para usuários atrás de proxies corporativos, adicionar os domínios necessários à lista de permissões é o passo final. Após seguir estes passos, o Copilot autenticará corretamente e retomará a sugestão de código.