GitHub Copilot na Rússia: contas, planos e Custom Endpoints
Separe conta GitHub e plano Copilot de um Custom Endpoint do VS Code e teste um modelo externo sem confundi-lo com completions em linha.
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.
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.
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.
Quer verificar Custom Endpoint na sua versão do Copilot Chat? Crie sua própria conta BetterToken e API Key, abra as instruções atuais e siga a configuração. 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
- Instale a versão estável atual do VS Code.
- Abra Copilot Chat e confirme que há Manage Models... no seletor de modelo.
- Confira que o comando Add Models → Custom Endpoint aparece na janela Language Models.
- 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, abra o seletor de modelo e escolha Manage Models.... 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:
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:
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:
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:
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.
Se usar Chat sem login no Copilot, VS Code avisa que algumas tarefas utilitárias ainda exigem um modelo. Nesse caso selecione seus modelos BYOK para chat.utilityModel e chat.utilitySmallModel; confira os nomes exatos na documentação do VS Code sobre language models.
Por que Chat funciona, mas completion em linha não mudou
Custom Endpoint conecta o modelo a superfícies Chat e fluxos Agent compatíveis. 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. Se você precisa apenas de conversa com modelo ou script Agent no Chat, BYOK local pode bastar. Para completions e outros recursos Copilot integrados, revise conta, plano e políticas da organização separadamente.
O aplicativo GitHub Copilot suporta seu próprio cenário BYOK: com provider próprio, uma conta GitHub é necessária, mas um plano Copilot não. Essa regra é específica do aplicativo; não se transfere automaticamente a VS Code, GitHub.com ou recursos Enterprise.
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:chat.lm.secret...}, 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?
Depende do cliente e do recurso. Para o aplicativo GitHub Copilot, a documentação permite BYOK com conta GitHub sem plano Copilot. No VS Code, alguns scripts BYOK de Chat podem funcionar sem login no Copilot, mas busca semântica, sugestões em linha, embeddings e algumas tarefas auxiliares mantêm dependências separadas.
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.