
GitHub Copilot Chat avec Claude via une passerelle : configuration de Custom Endpoint, mode agent et correctifs
Le chat de VS Code peut fonctionner avec les modèles que vous fournissez vous-même. Le fournisseur Anthropic intégré accepte uniquement une clé API, sans champ permettant de saisir une autre adresse : une passerelle s’ajoute donc via le fournisseur Point de terminaison personnalisé. Choisissez le type d’API Messages et répertoriez les modèles dans chatLanguageModels.json. Cette fonctionnalité fait partie de la version stable de VS Code depuis la version 1.122.
Fonctionnalités couvertes avec votre propre clé
| Fonctionnalité | Avec votre propre modèle |
|---|---|
| Chat, questions et planification | Oui |
| Mode agent, outils intégrés et serveurs MCP | Oui, si le modèle est marqué toolCalling: true |
| Suggestions en ligne (complétion de code) et suggestions de modification suivante | Non : elles proviennent toujours de GitHub Copilot |
| Recherche sémantique et autres fonctionnalités fondées sur les plongements vectoriels | Non : elles nécessitent toujours un compte GitHub |
Depuis VS Code 1.122, ces modèles fonctionnent sans connexion à GitHub et sans forfait Copilot. Sur Copilot Business et Enterprise, BYOK est activé par défaut, et les administrateurs peuvent le désactiver avec la stratégie **Utiliser votre propre clé de modèle de langage**.
Ajouter la passerelle comme point de terminaison personnalisé
- Ouvrez la vue de chat, ouvrez le sélecteur de modèles et choisissez **Gérer les modèles de langage**, ou exécutez **Chat : Gérer les modèles de langage** depuis la palette de commandes.
- Choisissez **Ajouter des modèles**, puis le fournisseur **Point de terminaison personnalisé**.
- Saisissez un nom d’affichage et la clé API de votre passerelle.
- Sélectionnez le type d’API **Messages**. VS Code ouvre ensuite
chatLanguageModels.jsonpour la liste des modèles.
chatLanguageModels.json
[
{
"name": "AI Prime Tech",
"vendor": "customendpoint",
"apiKey": "${input:aiprimeApiKey}",
"apiType": "messages",
"models": [
{
"id": "claude-sonnet-5",
"name": "Claude Sonnet 5",
"url": "https://aiprimetech.io/v1/messages",
"toolCalling": true,
"vision": true,
"maxInputTokens": 200000,
"maxOutputTokens": 32000
},
{
"id": "claude-opus-5-5",
"name": "Claude Opus 5.5",
"url": "https://aiprimetech.io/v1/messages",
"toolCalling": true,
"vision": true,
"maxInputTokens": 200000,
"maxOutputTokens": 32000
},
{
"id": "claude-haiku-4-5",
"name": "Claude Haiku 4.5",
"url": "https://aiprimetech.io/v1/messages",
"toolCalling": true,
"vision": true,
"maxInputTokens": 168000,
"maxOutputTokens": 32000
}
]
}
]| Champ | Pourquoi |
|---|---|
id | L’identifiant du modèle envoyé à la passerelle |
url | L’endpoint complet. VS Code utilise une URL se terminant par /messages telle quelle ; indiquez le chemin complet pour éviter toute ambiguïté |
toolCalling: true | Requis pour le mode agent. Un modèle sans cette option n’apparaît pas pour les agents |
maxInputTokens + maxOutputTokens | Leur somme ne doit pas dépasser la fenêtre de contexte du modèle |
apiKey: ${input:...} | VS Code demande la clé une seule fois et la stocke ; elle n’est donc pas inscrite dans le fichier |
Avec le type Messages, VS Code envoie la clé dans l’en-tête x-api-key , comme l’attend la passerelle. Les identifiants des modèles doivent correspondre exactement à ceux de la passerelle.
Modèles GPT avec la même clé
Le fournisseur Custom Endpoint prend également en charge les formats OpenAI. Pour ajouter des modèles GPT avec une clé du groupe Codex de la passerelle, ajoutez un second fournisseur avec "apiType": "chat-completions" et des URL de modèles de la forme https://aiprimetech.io/v1/chat/completions. Une clé ne donne accès qu’aux modèles de son propre groupe ; Claude et GPT nécessitent donc généralement des entrées distinctes avec des clés distinctes.
L’ancien paramètre github.copilot.chat.customOAIModels et le fournisseur **OpenAI Compatible** sont obsolètes au profit de Custom Endpoint. Transférez les anciennes entrées dans chatLanguageModels.json.
Dépannage
| Ce que vous voyez | Cause | Solution |
|---|---|---|
| Le modèle n’apparaît pas dans le sélecteur | Un rechargement est nécessaire, ou toolCalling vaut false, ou l’espace de travail est en mode restreint | Redémarrez VS Code, définissez toolCalling: true, faites confiance à l’espace de travail |
| La liste des fournisseurs ne contient pas Custom Endpoint | VS Code est antérieur à 1.122, ou BYOK est désactivé par votre organisation | Mettez VS Code à jour ; renseignez-vous auprès de l’administrateur sur la politique BYOK |
401 / clé API invalide | La clé stockée est incorrecte ou appartient à un autre endpoint | Icône d’engrenage à côté du fournisseur, puis **Mettre à jour la clé API** |
| Modèle non pris en charge | Le id ne correspond pas à un identifiant de modèle de la passerelle | Utilisez un identifiant du tableau ci-dessous |
| Erreurs de contexte ou de tokens | maxInputTokens ainsi que maxOutputTokens dépasse la fenêtre | Réduisez maxInputTokens |
Concurrency limit exceeded | Plusieurs agents ou fenêtres fonctionnent simultanément avec une même clé | Réduisez le nombre d’exécutions en parallèle |
Pour plus de détails, exécutez **Développeur : définir le niveau de journalisation**, choisissez **Trace**, puis ouvrez **Sortie** et sélectionnez **GitHub Copilot Chat**. La vue de débogage du chat affiche les requêtes exactes. Une ligne du journal indiquant que BYOK fournisseurs ont été désenregistrés parce que la politique les interdit signale une politique de l’organisation.
| Identifiant du modèle | À utiliser pour |
|---|---|
claude-sonnet-5 | Choix par défaut pour le développement et les tâches d’agents : rapide, performant, à prix intermédiaire. |
claude-opus-5-5 | Raisonnement plus difficile, refactorisations importantes, longues exécutions d’agents. |
claude-fable-5-1 | Le plus performant et le plus cher ; réservez-le aux tâches les plus difficiles. |
claude-haiku-4-5 | Économique et rapide : titres, résumés, classification, petites étapes. |
Vous préférez le terminal ? La même clé permet d’exécuter Claude Code dans VS Code via sa propre extension.
Questions fréquentes
Puis-je utiliser ma propre clé API Claude dans GitHub Copilot ?
Puis-je modifier l’URL de base d’Anthropic dans Copilot ?
Les modèles BYOK fonctionnent-ils en mode agent de Copilot ?
Ai-je besoin d’un abonnement Copilot pour utiliser mon propre modèle ?
Obtenez une clé API — aucun compte Anthropic ni inscription sur liste d’attente requis.
Obtenir votre clé APIAI Prime Tech est une passerelle API indépendante. Elle n’est ni affiliée à Anthropic, ni approuvée par Anthropic, ni revendeuse d’Anthropic. Claude et les noms de modèles associés sont des marques de leurs propriétaires respectifs.