GitHub Copilot na Rússia: contas, planos e Custom Endpoints

Você pode conectar um modelo externo ao Copilot Chat por meio de um BetterToken Custom Endpoint. Conta GitHub, plano Copilot e acesso à API controlam recursos diferentes. As versões atuais do VS Code guardam a chave no armazenamento local de segredos; depois você pode verificar a solicitação no Chat e no Dashboard. Essa configuração não muda completions em linha nem o acesso aos serviços GitHub.

Você precisa da sua própria API Key antes de configurar o endpoint. Crie uma conta BetterToken

O que você está configurando

O Copilot tem camadas independentes. Separá-las antes da configuração facilita entender por que o Chat responde enquanto os avisos do editor não mudaram.

Camada	O que controla	Um Custom Endpoint a substitui?
Conta GitHub	Login, licença e recursos GitHub	Não
Plano Copilot	Cotas e recursos do serviço Copilot, incluindo modelos e completions integrados	Não
BYOK local / Custom Endpoint	Escolha de modelo externo em cliente e superfície Chat compatíveis	Apenas solicitações que o cliente envia ao modelo selecionado
Completions em linha	Completar código diretamente no editor	Não, continuam sendo parte do GitHub Copilot

O GitHub descreve o BYOK local: a chave fica no dispositivo e o suporte varia por cliente. Em uma organização Business ou Enterprise, o administrador pode desativar esse recurso. Enterprise BYOK é outro cenário, no servidor, com requisitos próprios.

Confira a configuração do BetterToken Custom Endpoint nas instruções atuais. BetterToken oferece acesso API OpenAI-compatible e histórico de uso no Dashboard, mas não cria conta GitHub, não ativa plano Copilot nem altera regras regionais do GitHub.

O que verificar antes de configurar GitHub Copilot na Rússia

1. Instale a versão estável atual do VS Code.
2. Execute Chat: Manage Language Models ou escolha Manage Language Models na interface do Chat.
3. Confira que Add Models → Custom Endpoint está disponível.
4. Crie sua BetterToken API Key e escolha a Model ID exata no diretório de modelos.

O suporte BYOK não muda simultaneamente em todos os clientes. A presença de Custom Endpoint no VS Code não prova que a configuração funcione em JetBrains, Xcode, GitHub.com ou outra interface. O GitHub publica a lista atual de clientes e restrições.

Há ainda um limite para o Copilot oficial. A GitHub Trade Restrictions Policy afirma que o Copilot não pode ser vendido ou exportado para a Rússia sem permissão adequada. Custom Endpoint não substitui essa política. Não há instruções para alterar região, pagar por terceiros ou contornar a verificação da conta.

Como adicionar BetterToken Custom Endpoint no VS Code

1. Abra o gerenciamento de modelos

No campo de Copilot Chat, escolha Manage Language Models ou execute Chat: Manage Language Models pela Command Palette. Depois clique em Add Models → Custom Endpoint.

Se essa opção não existir, atualize primeiro o VS Code. Não copie configuração de manual antigo aleatório: nomes de comandos e layout de arquivos podem ter mudado.

2. Crie um grupo e salve a chave

No campo Group Name, digite BetterToken. Quando VS Code pedir uma API Key, cole a chave na janela e pressione Enter.

O VS Code deve salvar o segredo localmente e escrever na configuração uma referência semelhante:

"apiKey": "${input:betterTokenApiKey}"

Não substitua essa referência pela chave real, não inclua a chave em settings.json, em .env de repositório público nem em commit.

3. Selecione o protocolo Chat Completions

Para configuração BetterToken verificada, selecione Chat Completions. O VS Code abrirá chatLanguageModels.json.

Use esta estrutura mínima:

[
  {
    "name": "BetterToken",
    "vendor": "customendpoint",
    "apiKey": "${input:betterTokenApiKey}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "YOUR_MODEL_ID",
        "name": "YOUR_MODEL_ID",
        "url": "https://www.bettertoken.ai/v1/chat/completions"
      }
    ]
  }
]

YOUR_MODEL_ID é um marcador. Substitua-o pela ID exata de um modelo disponível. Aqui, url contém o endpoint Chat Completions completo; apenas a Base URL https://www.bettertoken.ai/v1 não é suficiente. Adicione toolCalling, vision e limites de contexto de Token somente conforme as capacidades do modelo e a documentação BetterToken atual.

4. Recarregue a janela do VS Code

Salve o arquivo e execute na Command Palette:

Developer: Reload Window

Após reiniciar, abra o seletor Copilot Chat novamente e escolha um modelo do grupo BetterToken.

5. Faça um teste curto

Envie uma solicitação de resultado facilmente verificável, por exemplo:

Retorne apenas JSON com dois campos: language="pt-BR" e sum=2+2.

A conexão só é confirmada quando três condições ocorrem juntas:

• Copilot Chat retorna JSON válido sem erro de autorização ou Model ID;
• a solicitação aparece no histórico de uso do Dashboard BetterToken;
• a completion em linha é verificada separadamente e não é aceita como resultado de Custom Endpoint.

Por que Chat funciona, mas completion em linha não mudou

Custom Endpoint conecta o modelo ao Chat. Em sessões Agent Host, usar um modelo BYOK exige a configuração experimental atual chat.agentHost.byokModels.enabled; uma solicitação bem-sucedida no Chat comum não confirma um fluxo Agent. A autocompleção diretamente no editor continua sendo recurso do GitHub Copilot. Por isso uma solicitação BetterToken bem-sucedida não confirma completions oficiais nem as consome da mesma forma.

Alguns recursos do VS Code também dependem dos serviços GitHub: busca semântica, sugestões em linha e embeddings exigem conta GitHub e conexão com a internet; os requisitos de plano dependem de cada recurso. Se você precisa apenas de conversa com modelo no Chat, BYOK local pode bastar. Para Agent Host, completions e outros recursos Copilot integrados, revise configuração atual, plano e políticas da organização separadamente.

Erros comuns de Custom Endpoint

O modelo não apareceu no seletor

Verifique se VS Code está atualizado, se existe entrada em chatLanguageModels.json e se a Model ID corresponde exatamente. Depois execute Developer: Reload Window. Em aparelho gerenciado, confirme que uma política Copilot Business ou Enterprise não proíbe BYOK local.

Erro 401 ou Invalid token

Adicione o modelo novamente por Add Models para que VS Code solicite a chave e a guarde no armazenamento de segredos. O JSON deve conter ${input:...}, não o valor real. Confira que a chave pertence à sua conta BetterToken e está ativa.

404 ou model not found

Para apiType: "chat-completions", verifique a URL completa https://www.bettertoken.ai/v1/chat/completions. Depois compare id com a Model ID atual do diretório BetterToken. Base URL, endpoint completo e Model ID são três campos de validação diferentes.

Chat responde, mas completions continuam iguais

Esse é o limite esperado. Custom Endpoint não substitui completions em linha; elas exigem acesso separado ao recurso GitHub Copilot correspondente.

O que depende do GitHub e o que depende da BetterToken

O GitHub controla conta, planos Copilot, restrições regionais e organizacionais e recursos integrados como completions em linha. Nesse cenário a BetterToken responde pela solicitação externa OpenAI-compatible, API Key, Model ID disponível e registro de uso no Dashboard.

Antes de configurar, confira o suporte BYOK atual no cliente. Depois abra as instruções atuais da BetterToken, adicione Custom Endpoint na interface VS Code e conclua a verificação com solicitação curta e registro no Dashboard.

Perguntas frequentes

Posso usar Custom Endpoint sem plano Copilot pago?

Na versão atual do VS Code, o BYOK Chat não exige plano Copilot pago nem login no GitHub. Busca semântica, sugestões em linha e embeddings exigem conta GitHub e conexão com a internet; plano e política da organização devem ser verificados para cada recurso.

BetterToken substitui a assinatura GitHub Copilot?

Não. BetterToken conecta modelo externo onde o cliente suporta Custom Endpoint ou BYOK. Conta GitHub, plano, completions e outros recursos Copilot permanecem separados.

É possível guardar uma API Key em chatLanguageModels.json?

O valor real da chave não deve ser escrito ali. Insira a chave na janela do VS Code e mantenha a referência secreta criada pelo aplicativo.

É necessário VPN nesse esquema?

Para conectar ao BetterToken API Endpoint a partir da Rússia, VPN não é necessário. Isso vale somente para o endpoint BetterToken. Site GitHub, login, downloads do cliente, atualizações e recursos Copilot continuam sujeitos aos termos do GitHub e à sua rede.