Enterprise Server 3.22 est actuellement disponible en tant que version candidate.

Configurer et utiliser l’interface CLI GitHub Copilot

Configurez un fournisseur de modèles pour votre GitHub Enterprise Server instance, puis connectez Copilot CLI les clients à l’instance.

Dans cet article

Remarque

Cette fonctionnalité est en cours de développement préversion technique et est susceptible de changer.

Vous pouvez configurer Copilot CLI pour fonctionner avec GitHub Enterprise Server dans des environnements déconnectés ou isolés du réseau, sans connectivité à GitHub Cloud. Un administrateur configure un fournisseur de modèle pour l’instance, et les utilisateurs se connectent Copilot CLI avec leurs GitHub Enterprise Server informations d’identification.

La configuration de cette fonctionnalité implique deux rôles :

  • Administrateur : configure le fournisseur de modèles dans l’instance à l’aide de GitHub Enterprise Serverghe-config. Il s’agit d’une configuration unique qui nécessite un accès SSH administratif.
  • Utilisateur final : définit des variables d’environnement sur un ordinateur local pour se connecter Copilot CLI à l’instance.

Prerequisites

  • Vous disposez d’un accès SSH administratif à l’instance GitHub Enterprise Server .
  • Vous disposez d’une clé API à partir d’un fournisseur LLM pris en charge.
  • Copilot CLI est installé sur les ordinateurs clients. Consultez « Installation du CLI GitHub Copilot ».
  • GitHub CLI (gh) est installé sur les ordinateurs clients. Consultez GitHub CLImanuel dans la GitHub CLI documentation.

Pour plus d’informations sur les fournisseurs pris en charge et les exigences de modèle, consultez Utilisation de vos propres modèles LLM dans GitHub Copilot CLI.

Configuration de votre GitHub Enterprise Server instance

Cette étape concerne l’opérateur ou l’administrateur de l’instance GitHub Enterprise Server .

Avec l’accès SSH administratif à l’instance GitHub Enterprise Server , configurez le fournisseur de modèles à l’aide des valeurs suivantes ghe-config . Après la configuration, exécutez ghe-config-apply pour appliquer les modifications.

Nom de la variableObligatoireOptionsDescription
app.copilot-proxy.enabledOui
true, falseActive ou désactive la fonctionnalité.
app.copilot-proxy.endpoint-urlOuiURIURL de base en amont complète, y compris n’importe quel préfixe de version (par exemple, https://api.openai.com/v1).
secrets.copilot-proxy.endpoint-keyOuiChaîneClé API pour le fournisseur en amont.
app.copilot-proxy.provider-model-idOuiChaîneID de modèle du fournisseur qu’utilise Copilot CLI pour retrouver le modèle en interne.
app.copilot-proxy.provider-typeOui
openai, azure, anthropicType de fournisseur. OpenAI inclut OpenAI, Ollama, vLLM, Foundry Local et tout autre point de terminaison compatible avec l’API OpenAI Chat Completions.
app.copilot-proxy.upstream-timeoutNonNombre entier, en secondesDélai d’expiration de lecture/d’envoi, en secondes, pour les requêtes en amont. Si ce n’est pas le cas, revenez au délai d’expiration par défaut.
app.copilot-proxy.provider-wire-apiNon
completions, responsesFormat de l’API filaire pour le fournisseur.
app.copilot-proxy.provider-wire-modelNonChaîneRemplace l’identificateur de modèle envoyé au fournisseur en amont s’il diffère de l’ID de modèle interne.
app.copilot-proxy.enable-upstream-probeNon
true, falseActive ou désactive la sonde upstream au démarrage. La valeur par défaut est activée. Lorsqu’elle est désactivée, la sonde de démarrage est ignorée.

Par exemple, les commandes suivantes configurent un fournisseur OpenAI.

ghe-config app.copilot-proxy.enabled true
ghe-config app.copilot-proxy.endpoint-url 'https://api.openai.com/v1'
ghe-config secrets.copilot-proxy.endpoint-key 'YOUR-API-KEY'
ghe-config app.copilot-proxy.provider-model-id 'gpt-5.5'
ghe-config app.copilot-proxy.provider-wire-model 'gpt-5.5'
ghe-config app.copilot-proxy.provider-type openai
ghe-config app.copilot-proxy.upstream-timeout 300
ghe-config app.copilot-proxy.enable-upstream-probe false
ghe-config-apply

Remplacez YOUR-API-KEY par la clé API réelle avant d’appliquer la configuration.

Configuration de votre Copilot CLI client (utilisateur final)

Configurez Copilot CLI pour vous connecter à votre GitHub Enterprise Server instance en définissant les variables d’environnement suivantes avant de commencer Copilot CLI.

Variable d'environnementObligatoireDescription
COPILOT_PROVIDER_GHES_HOSTOuiNom d’hôte de votre GitHub Enterprise Server instance.
COPILOT_PROVIDER_GHES_TOKENOuiUn personal access token pour l’instance GitHub Enterprise Server. Ce jeton authentifie les demandes auprès de l’instance.
COPILOT_OFFLINEOuiActive le mode hors connexion. Le fournisseur est actif uniquement lorsque le GitHub Enterprise Server mode hors connexion est activé.

Comprendre les jetons client (utilisateur final)

Copilot CLI a besoin d’accéder à l’inférence LLM, donc COPILOT_PROVIDER_GHES_TOKEN est toujours requis. Vous voudrez également très probablement que Copilot CLI effectue des opérations GitHub telles que créer des issues, des pull requests et rechercher des dépôts. Ces opérations peuvent être effectuées via le GitHub CLI.

Il est recommandé, et préférable, que vous exécutiez gh auth login --hostname YOUR-GHES-HOSTNAME. Une fois l’opération réussie, l’étape suivante consiste à définir COPILOT_PROVIDER_GHES_TOKEN sur le jeton généré dans gh auth login --hostname YOUR-GHES-HOSTNAME. Il est plus sécurisé de récupérer le jeton dynamiquement plutôt que de le copier à partir de ~/.config/gh/hosts.yml. Vous pouvez le faire à l’aide de COPILOT_PROVIDER_GHES_TOKEN="$(gh auth token --hostname YOUR-GHES-HOSTNAME)".

Vous pouvez également générer un personal access token jeton sur votre GitHub Enterprise Server instance, définir ce jeton COPILOT_PROVIDER_GHES_TOKENet utiliser le même jeton lors de l’exécution gh auth login --hostname YOUR-GHES-HOSTNAME.

L’approche ci-dessus fonctionne lorsque vous utilisez Copilot CLI de manière interactive. Pour l’automatisation, vous devez effectuer quelques opérations différemment :

  • Réglez GH_ENTERPRISE_TOKEN (ou GITHUB_ENTERPRISE_TOKEN) sur personal access token.
  • Définissez GH_HOST le nom d’hôte de votre serveur.
  • Lorsque les informations d’identification GH_ENTERPRISE_TOKEN et gh auth login existent pour le même hôte, la variable d’environnement prend le pas.

  1. Authentifiez GitHub CLI.

    gh auth login --hostname YOUR-GHES-HOSTNAME

  2. Définissez les variables d’environnement requises par Copilot CLI.

    export COPILOT_PROVIDER_GHES_HOST=YOUR-GHES-HOSTNAME
export COPILOT_PROVIDER_GHES_TOKEN="$(gh auth token --hostname YOUR-GHES-HOSTNAME)"
export COPILOT_OFFLINE=true

    Si vous êtes authentifié auprès de plusieurs comptes avec gh auth login, vous pouvez définir GH_HOST sur le nom d’hôte de votre serveur et définir GH_ENTERPRISE_TOKEN (ou GITHUB_ENTERPRISE_TOKEN) sur "$(gh auth token --hostname YOUR-GHES-HOSTNAME)". Cela garantit que GitHub CLI cible votre instance GitHub Enterprise Server.

    export GH_HOST=YOUR-GHES-HOSTNAME
export GH_ENTERPRISE_TOKEN="$(gh auth token --hostname YOUR-GHES-HOSTNAME)"

  3. Démarrez Copilot CLI.

copilot

Vous pouvez exécuter l’ensemble de cette configuration en tant que script.

Examples

Si les configurations GitHub Enterprise Server et de votre Copilot CLI sont correctes, vous devriez voir des réponses du type suivant dans votre session Copilot CLI.

     • fabric-core-mcp — disabled
     • powerbi-mcp — disabled
     • slack — connected

 ● Current model: gpt-5.5

 ❯ Hello                                                                   13:31

 ● Hello!

 ❯ what is going on in github/codeql-action repo?                          13:33

 ● I’ll check recent repository activity on the GHES host: repo metadata, open 
   PRs/issues, and latest commits.

 $ Shell Fetch repo metadata 2 lines…                                         5s
   gh api --hostname "$GH_HOST" repos/github/codeql-action --jq '{name_with_own…

Fonctionnalités prises en charge sur GitHub Enterprise Server

Pour obtenir les informations les plus récentes sur les fonctionnalités de Copilot CLI, consultez GitHub Copilot CLI comme source de référence. En général, toute fonctionnalité qui s’appuie sur la connectivité aux GitHub services cloud n’est pas disponible dans la GitHub Enterprise Server configuration hors connexion.

Le tableau suivant donne un aperçu général des éléments disponibles dans l’offre GitHub Enterprise Server.

CapacitéGitHub / GitHub Enterprise CloudGitHub Enterprise Server
Codage assisté par l’IA (invites, génération de code, débogage)
Commandes shell et opérations de fichier
GitHub opérations (problèmes, demandes de tirage, dépôts) via gh l’interface CLI
(nécessite gh CLI authentifiée auprès de l’instance)
GitHub Outils serveur MCP
Recherche sur le web et récupération de pages web
Copilot sélection de modèles (GitHubmodèles hébergés)
Rapports de télémétrie et d’utilisation
Mise à jour automatique