Utilisation de vos propres modèles LLM dans GitHub Copilot CLI

Vous pouvez configurer Copilot CLI pour utiliser votre propre fournisseur LLM, également appelé BYOK (Bring Your Own Key), au lieu de GitHubmodèles hébergés. Cela vous permet de vous connecter à des points de terminaison compatibles OpenAI, Azure OpenAI ou Anthropic, y compris des modèles en cours d’exécution localement tels que Ollama.

Prerequisites

• Copilot CLI est installé. Consultez « Installation du CLI GitHub Copilot ».
• Vous disposez d’une clé API à partir d’un fournisseur LLM pris en charge ou vous disposez d’un modèle local en cours d’exécution (par exemple, Ollama).

Fournisseurs pris en charge

Copilot CLI prend en charge trois types de fournisseurs :

Type de fournisseur	Services compatibles
openai	OpenAI, Ollama, vLLM, Foundry Local et tout autre point de terminaison compatible avec l’API OpenAI Chat Completions. Il s’agit du type de fournisseur par défaut.
azure	Azure OpenAI Service.
anthropic	Anthropice (Modèles Claude).

Pour obtenir des exemples supplémentaires, exécutez copilot help providers dans votre terminal.

Configuration requise pour le modèle

Les modèles doivent prendre en charge l’appel d’outils (également appelé appel de fonction) et la diffusion en continu. Si un modèle ne prend pas en charge l’une ou l’autre des fonctionnalités, Copilot CLI retourne une erreur. Pour obtenir de meilleurs résultats, utilisez un modèle avec une fenêtre contextuelle d’au moins 128 000 jetons.

Configuration de votre fournisseur

Vous configurez votre fournisseur de modèles en définissant des variables d’environnement avant de commencer Copilot CLI.

Variable d'environnement	Obligatoire	Description
COPILOT_PROVIDER_BASE_URL	Oui	URL de base du point de terminaison d’API de votre fournisseur de modèles.
COPILOT_PROVIDER_TYPE	Non	Type de fournisseur : openai (par défaut), azureou anthropic.
COPILOT_PROVIDER_API_KEY	Non	Votre clé API pour le fournisseur. Non requis pour les fournisseurs qui n’utilisent pas l’authentification, comme une instance Ollama locale.
COPILOT_PROVIDER_BEARER_TOKEN	Non	Jeton Bearer utilisé pour l’authentification auprès du fournisseur lorsque l’authentification par clé API n’est pas utilisée.
COPILOT_PROVIDER_WIRE_API	Non	Spécifie le protocole d’API utilisé lors de la communication avec le fournisseur.
COPILOT_PROVIDER_AZURE_API_VERSION	Azure uniquement	Version de l’API OpenAI Azure utilisée pour les requêtes.
COPILOT_PROVIDER_MODEL_ID	Non	Le nom de modèle bien connu utilisé pour identifier les capacités du modèle et les limites de tokens.
COPILOT_PROVIDER_WIRE_MODEL	Non	Nom du modèle envoyé à l’API du fournisseur pour l’inférence. Pour Azure OpenAI, utilisez le nom du déploiement.
COPILOT_PROVIDER_MAX_PROMPT_TOKENS	Non	Nombre maximal de jetons d’invite autorisés dans une requête.
COPILOT_PROVIDER_MAX_OUTPUT_TOKENS	Non	Nombre maximal de jetons générés dans une réponse.
COPILOT_MODEL	Oui	Identificateur de modèle à utiliser. Vous pouvez également définir cela avec l’indicateur de --model ligne de commande.

Connexion à un point de terminaison compatible OpenAI

Procédez comme suit si vous vous connectez à OpenAI, Ollama, vLLM, Foundry Local ou tout autre point de terminaison compatible avec l’API OpenAI Chat Completions.

1. Définissez des variables d’environnement pour votre fournisseur. Par exemple, pour une instance Ollama locale :

   export COPILOT_PROVIDER_BASE_URL=http://localhost:11434
   export COPILOT_MODEL=YOUR-MODEL-NAME
   

   Remplacez YOUR-MODEL-NAME par le nom du modèle que vous avez extrait dans Ollama (par exemple). llama3.2

2. Pour un point de terminaison OpenAI distant, définissez également votre clé API.

   export COPILOT_PROVIDER_BASE_URL=https://api.openai.com/v1
   export COPILOT_PROVIDER_API_KEY=YOUR-OPENAI-API-KEY
   export COPILOT_MODEL=YOUR-MODEL-NAME
   

   Remplacez YOUR-OPENAI-API-KEY par votre clé API OpenAI et YOUR-MODEL-NAME par le modèle que vous souhaitez utiliser (par exemple). gpt-4o

3. Démarrez Copilot CLI.

copilot

Connexion à Azure OpenAI

1. Définissez les variables d’environnement pour Azure OpenAI.

   export COPILOT_PROVIDER_BASE_URL=https://YOUR-RESOURCE-NAME.openai.azure.com
   export COPILOT_PROVIDER_TYPE=azure
   export COPILOT_PROVIDER_API_KEY=YOUR-AZURE-API-KEY
   export COPILOT_PROVIDER_AZURE_API_VERSION=YOUR-AZURE-API-VERSION
   export COPILOT_PROVIDER_MODEL_ID=YOUR-MODEL-NAME
   export COPILOT_PROVIDER_WIRE_MODEL=YOUR-DEPLOYMENT-NAME
   export COPILOT_MODEL=YOUR-DEPLOYMENT-NAME
   

   Remplacez les espaces réservés suivants :

   • YOUR-RESOURCE-NAME : nom de votre ressource OpenAI Azure
   • YOUR-DEPLOYMENT-NAME: nom du déploiement qui reçoit les requêtes
   • YOUR-MODEL-NAME: modèle sous-jacent associé au déploiement (par exemple, gpt-4o)
   • YOUR-AZURE-API-VERSION: version de l’API OpenAI Azure
   • YOUR-AZURE-API-KEY : votre clé API OpenAI Azure

variables d’environnement spécifiques à Azure

Variable	Description
COPILOT_PROVIDER_MODEL_ID	Le nom du modèle bien connu.
Copilot CLI utilise cette valeur pour identifier les fonctionnalités du modèle et les limites de jeton.
COPILOT_PROVIDER_WIRE_MODEL	Le nom du déploiement Azure OpenAI. Azure OpenAI achemine les requêtes par le biais de déploiements plutôt que directement par le biais de noms de modèles.

1. Démarrez Copilot CLI.

copilot

Connexion à Anthropic

1. Définissez les variables d’environnement pour Anthropic :

   export COPILOT_PROVIDER_TYPE=anthropic
   export COPILOT_PROVIDER_BASE_URL=https://api.anthropic.com
   export COPILOT_PROVIDER_API_KEY=YOUR-ANTHROPIC-API-KEY
   export COPILOT_MODEL=YOUR-MODEL-NAME
   

   Remplacez YOUR-ANTHROPIC-API-KEY par votre clé API Anthropic et VOTRE-MODEL-NAME par le modèle Claude que vous souhaitez utiliser (par exemple, claude-opus-4-5).

2. Démarrez Copilot CLI.

copilot

Exécution en mode hors connexion

Vous pouvez exécuter Copilot CLI en mode hors connexion pour l’empêcher de contacter GitHubles serveurs. Ceci est conçu pour les environnements isolés où l'interface en ligne de commande (CLI) doit communiquer uniquement avec votre fournisseur de modèles local ou sur site.

1. Configurez vos variables d’environnement de fournisseur comme décrit dans Configuration de votre fournisseur.

2. Définissez la variable d’environnement en mode hors connexion :

   export COPILOT_OFFLINE=true
   

3. 1. Démarrez Copilot CLI.

copilot