GitHub Copilot en Russie : comptes, plans et Custom Endpoints

Ce que vous configurez

Copilot comporte plusieurs couches indépendantes. Les séparer avant la configuration explique pourquoi Chat répond sans que les suggestions de l'éditeur aient changé.

GitHub décrit le BYOK local : la clé est stockée sur l'appareil et la prise en charge varie selon le client. Dans une organisation Business ou Enterprise, un administrateur peut désactiver cette fonction. Enterprise BYOK est un cas serveur différent avec ses propres prérequis.

Vous voulez vérifier Custom Endpoint dans votre version de Copilot Chat ? Créez votre compte BetterToken et votre API Key, ouvrez les instructions actuelles, puis suivez la procédure ci-dessous. BetterToken fournit un accès API OpenAI-compatible et l'historique d'usage dans le Dashboard, mais ne crée pas de compte GitHub, n'active pas de plan Copilot et ne modifie pas les règles régionales de GitHub.

Vérifications avant de configurer GitHub Copilot en Russie

1. Installez la version stable actuelle de VS Code.
2. Ouvrez Copilot Chat et vérifiez que le sélecteur de modèle contient Manage Models....
3. Vérifiez que la commande Add Models → Custom Endpoint est disponible dans la fenêtre Language Models.
4. Créez votre BetterToken API Key et choisissez l'identifiant de modèle exact dans le répertoire de modèles.

Le support BYOK n'arrive pas en même temps sur tous les clients. La présence de Custom Endpoint dans VS Code ne prouve pas que la même configuration fonctionne dans JetBrains, Xcode, GitHub.com ou une autre interface. GitHub publie la liste actuelle des clients pris en charge et des restrictions.

Une autre limite concerne Copilot officiel. La GitHub Trade Restrictions Policy indique que Copilot ne peut pas être vendu ou exporté vers la Russie sans autorisation appropriée. Un Custom Endpoint ne déroge pas à cette règle. Il n'existe pas de procédure pour changer de région, payer via un tiers ou contourner la vérification de compte.

Ajouter BetterToken Custom Endpoint dans VS Code

1. Ouvrir la gestion des modèles

Dans le champ de saisie Copilot Chat, ouvrez le sélecteur de modèle et choisissez Manage Models..., puis cliquez sur Add Models → Custom Endpoint.

Si l'option est absente, mettez d'abord VS Code à jour. Ne recopiez pas une ancienne configuration trouvée au hasard : noms de commandes et structure de fichiers peuvent avoir changé.

2. Créer un groupe et enregistrer la clé

Saisissez BetterToken dans Group Name. Lorsque VS Code demande une API Key, collez votre clé dans la fenêtre contextuelle et appuyez sur Entrée.

VS Code doit enregistrer le secret localement et écrire dans la configuration un lien similaire :

"apiKey": "${input:chat.lm.secret.xxxxx}"

Ne remplacez pas ce lien par la clé réelle. Ne mettez pas la clé dans settings.json, dans une .env d'un dépôt public et ne la committez pas.

3. Choisir le protocole Chat Completions

Pour une configuration BetterToken vérifiée, choisissez Chat Completions. VS Code ouvrira alors chatLanguageModels.json.

Voici la structure minimale :

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

YOUR_MODEL_ID est un espace réservé : remplacez-le par l'identifiant exact d'un modèle disponible. Ici, url contient l'endpoint Chat Completions complet; la seule Base URL https://www.bettertoken.ai/v1 ne suffit pas. Ajoutez toolCalling, vision et les limites de contexte Token uniquement selon le modèle choisi et la documentation BetterToken actuelle.

4. Recharger la fenêtre VS Code

Enregistrez le fichier et lancez dans la Command Palette :

Developer: Reload Window

Après redémarrage, ouvrez de nouveau le sélecteur Copilot Chat et choisissez un modèle du groupe BetterToken.

5. Faire un test court

Envoyez une requête dont le résultat est facilement vérifiable, par exemple :

Retourne uniquement du JSON avec deux champs : language="fr" et sum=2+2.

La connexion est confirmée seulement si trois conditions sont réunies :

• Copilot Chat renvoie un JSON valide sans erreur d'autorisation ni Model ID;
• la requête apparaît dans l'historique du Dashboard BetterToken;
• la complétion en ligne est vérifiée séparément et n'est pas prise pour un résultat Custom Endpoint.

Si vous utilisez Chat sans connexion Copilot, VS Code avertit que certaines tâches utilitaires demandent toujours un modèle. Dans ce cas, choisissez vos modèles BYOK pour chat.utilityModel et chat.utilitySmallModel; vérifiez les noms exacts dans la documentation VS Code sur les language models.

Pourquoi Chat fonctionne mais les complétions en ligne ne changent pas

Custom Endpoint relie le modèle aux surfaces Chat et aux workflows Agent pris en charge. L'autocomplétion directe dans l'éditeur reste une fonction GitHub Copilot. Une requête BetterToken réussie ne confirme donc pas les complétions officielles et ne les consomme pas de la même façon.

Certaines fonctions VS Code dépendent aussi des services GitHub : recherche sémantique, suggestions en ligne et embeddings. Si vous voulez seulement une conversation avec un modèle ou un script Agent dans Chat, le BYOK local peut suffire. Pour les complétions et les autres fonctions Copilot intégrées, contrôlez séparément compte, plan et règles d'organisation.

L'application GitHub Copilot prend en charge son scénario BYOK propre : avec son propre provider, un compte GitHub est nécessaire mais pas un plan Copilot. Cette règle est spécifique à cette application; elle ne s'applique pas automatiquement à VS Code, GitHub.com ou aux fonctions Enterprise.

Erreurs fréquentes de Custom Endpoint

Le modèle n'apparaît pas dans le sélecteur

Vérifiez que VS Code est à jour, qu'une entrée existe dans chatLanguageModels.json et que le Model ID correspond exactement. Lancez ensuite Developer: Reload Window. Sur un appareil géré, vérifiez qu'une règle Copilot Business ou Enterprise n'interdit pas le BYOK local.

Erreur 401 ou Invalid token

Ajoutez à nouveau le modèle avec Add Models afin que VS Code demande la clé et la place dans le stockage de secrets. Le JSON doit contenir ${input:chat.lm.secret...}, pas la valeur réelle. Vérifiez que la clé appartient à votre compte BetterToken et qu'elle est active.

404 ou model not found

Pour apiType: "chat-completions", vérifiez l'URL complète https://www.bettertoken.ai/v1/chat/completions. Comparez ensuite id avec le Model ID actuel du répertoire BetterToken. Base URL, endpoint complet et Model ID sont trois champs de validation différents.

Chat répond mais les complétions restent identiques

C'est la limite attendue. Custom Endpoint ne remplace pas les complétions en ligne. Elles demandent un accès séparé à la fonction GitHub Copilot correspondante.

Ce qui dépend finalement de GitHub et de BetterToken

GitHub contrôle le compte, les plans Copilot, les restrictions régionales et organisationnelles, ainsi que les fonctions intégrées comme les complétions en ligne. Dans ce scénario, BetterToken fournit la requête externe OpenAI-compatible, l'API Key, le Model ID disponible et la trace d'usage dans le Dashboard.

Avant la configuration, vérifiez le support BYOK actuel dans votre client. Ouvrez ensuite les instructions BetterToken actuelles, ajoutez un Custom Endpoint via l'interface VS Code et terminez la vérification avec une requête courte et une entrée Dashboard.

FAQ

Puis-je utiliser Custom Endpoint sans plan Copilot payant ?

Cela dépend du client et de la fonction. Pour l'application GitHub Copilot, la documentation autorise le BYOK avec un compte GitHub sans plan Copilot. Dans VS Code, certains scripts BYOK de Chat peuvent fonctionner sans connexion Copilot, mais recherche sémantique, suggestions en ligne, embeddings et certaines tâches auxiliaires ont des dépendances distinctes.

BetterToken remplace-t-il l'abonnement GitHub Copilot ?

Non. BetterToken connecte un modèle externe là où le client prend en charge Custom Endpoint ou BYOK. Compte GitHub, plan, complétions et autres fonctions Copilot restent séparés.

Puis-je enregistrer une API Key dans chatLanguageModels.json ?

La valeur réelle de la clé ne doit pas être écrite dans ce fichier. Entrez la clé dans la fenêtre VS Code et conservez le lien de secret créé par l'application.

Un VPN est-il nécessaire dans ce schéma ?

Pour la connexion au BetterToken API Endpoint depuis la Russie, un VPN n'est pas nécessaire. Cela ne vaut que pour l'endpoint BetterToken. Le site GitHub, la connexion, les téléchargements client, les mises à jour et les fonctions Copilot restent soumis aux conditions GitHub et à votre réseau.