Настройка и использование интерфейса командной строки GitHub Copilot

Примечание.

Эта функция уже присутствует Technical Preview и может измениться.

Вы можете настроить Copilot CLI работу с GitHub Enterprise Server отключенными или воздушными средами без подключения к облаку GitHub . Администратор настраивает поставщика моделей для экземпляра, а пользователи подключаются Copilot CLI к своим GitHub Enterprise Server учетным данным.

Настройка этой функции включает две роли:

Администратор: настраивает поставщика моделей в экземпляре GitHub Enterprise Server с помощью ghe-config. Это одноразовая настройка, требующая административного доступа SSH.
Конечный пользователь: задает переменные среды на локальном компьютере для подключения Copilot CLI к экземпляру.

Prerequisites

У вас есть административный SSH-доступ к экземпляру GitHub Enterprise Server .
У вас есть ключ API от поддерживаемого поставщика LLM.
Copilot CLI устанавливается на клиентских компьютерах. См . раздел AUTOTITLE.
GitHub CLI (gh) устанавливается на клиентских компьютерах. См GitHub CLI . руководство в GitHub CLI документации.

Сведения о поддерживаемых поставщиках и требованиях к модели см. в разделе Использование собственных моделей LLM в GitHub Copilot CLI.

Настройка экземпляра GitHub Enterprise Server

Этот шаг предназначен для оператора или администратора экземпляра GitHub Enterprise Server .

При использовании административного доступа SSH к экземпляру настройте поставщика моделей GitHub Enterprise Server с помощью следующих ghe-config значений. После настройки запустите ghe-config-apply , чтобы применить изменения.

Имя переменной	Обязательный	Options	Description
`app.copilot-proxy.enabled`	Да
`true`, `false`	Включает или отключает функцию.
`app.copilot-proxy.endpoint-url`	Да	URI	Полный базовый URL-адрес вышестоящей версии, включая префикс любой версии (например, `https://api.openai.com/v1`).
`secrets.copilot-proxy.endpoint-key`	Да	String	Ключ API для вышестоящего поставщика.
`app.copilot-proxy.provider-model-id`	Да	String	Идентификатор модели поставщика, который Copilot CLI используется для внутреннего поиска модели.
`app.copilot-proxy.provider-type`	Да
`openai`, `azure`, `anthropic`	Тип поставщика. OpenAI включает OpenAI, Ollama, vLLM, Foundry Local и любую другую конечную точку, совместимую с API завершения чата OpenAI.
`app.copilot-proxy.upstream-timeout`	Нет	Целое число в секундах	Время ожидания чтения и отправки в секундах для исходящих запросов. Если значение не задано, возвращается к времени ожидания по умолчанию.
`app.copilot-proxy.provider-wire-api`	Нет
`completions`, `responses`	Формат API провода для поставщика.
`app.copilot-proxy.provider-wire-model`	Нет	String	Переопределяет идентификатор модели, отправленный поставщику вышестоящей модели, если он отличается от идентификатора внутренней модели.
`app.copilot-proxy.enable-upstream-probe`	Нет
`true`, `false`	Включает или отключает запуск вышестоящей пробы. По умолчанию включено. При отключении проба запуска пропускается.

Например, следующие команды настраивают поставщика 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

Замените YOUR-API-KEY реальным ключом API перед применением конфигурации.

Copilot CLI Настройка клиента (конечный пользователь)

Настройте Copilot CLI подключение к GitHub Enterprise Server экземпляру, задав следующие переменные среды перед запуском Copilot CLI.

Переменная среды	Обязательный	Description
`COPILOT_PROVIDER_GHES_HOST`	Да	Имя узла экземпляра GitHub Enterprise Server .
`COPILOT_PROVIDER_GHES_TOKEN`	Да	A personal access token для экземпляра GitHub Enterprise Server . Этот маркер проверяет подлинность запросов к экземпляру.
`COPILOT_OFFLINE`	Да	Включает автономный режим. Поставщик GitHub Enterprise Server активен только в том случае, если включен автономный режим.

Общие сведения о маркерах клиента (конечный пользователь)

Copilot CLI требуется доступ к выводу LLM, поэтому COPILOT_PROVIDER_GHES_TOKEN всегда требуется. Кроме того, вам потребуется Copilot CLI выполнить GitHub такие операции, как создание проблем, запросов на вытягивание и репозитории поиска. Такие операции можно выполнить с помощью .GitHub CLI

Рекомендуется и предпочтительнее выполняться gh auth login --hostname YOUR-GHES-HOSTNAME. После успешного выполнения следующий шаг — задать COPILOT_PROVIDER_GHES_TOKEN маркер, созданный в gh auth login --hostname YOUR-GHES-HOSTNAME. Более безопасно получить маркер динамически, а не копировать его из ~/.config/gh/hosts.yml. Это можно сделать с помощью COPILOT_PROVIDER_GHES_TOKEN="$(gh auth token --hostname YOUR-GHES-HOSTNAME)".

Кроме того, можно создать personal access token экземпляр GitHub Enterprise Server , задать этот маркер как COPILOT_PROVIDER_GHES_TOKENи использовать тот же маркер при выполнении gh auth login --hostname YOUR-GHES-HOSTNAME.

Приведенный выше подход работает при интерактивном использовании Copilot CLI . Для автоматизации необходимо выполнить несколько действий по-разному:

Задайте ( GH_ENTERPRISE_TOKEN или GITHUB_ENTERPRISE_TOKEN) значение personal access token.
Задайте GH_HOST имя узла сервера.
GH_ENTERPRISE_TOKEN Если оба и gh auth login учетные данные существуют для одного узла, переменная среды имеет приоритет.

Примеры

Если оба GitHub Enterprise Server и ваши Copilot CLI конфигурации верны, в сеансе должны отображаться ответы, как показано ниже 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…

Поддерживаемые возможности в GitHub Enterprise Server

Для большинства up-to-date сведения о Copilot CLI функциях см. в GitHub Copilot CLI в качестве основного источника истины. Как правило, любая возможность, которая зависит от подключения к GitHub облачным службам, недоступна в автономной GitHub Enterprise Server конфигурации.

В следующей таблице представлен обзор возможностей, доступных в GitHub Enterprise Server предложении.

Capability	GitHub / GitHub Enterprise Cloud	GitHub Enterprise Server
Код с поддержкой искусственного интеллекта (запросы, создание кода, отладка)
Команды оболочки и операции с файлами
GitHub операции (проблемы, PR, репозитории) через `gh` CLI
(требуется `gh` Интерфейс командной строки, прошедший проверку подлинности в экземпляре)
GitHub Инструменты серверов MCP
Поиск в Интернете и веб-получение
Copilot Выбор модели (GitHubразмещенные модели)
Отчеты телеметрии и использования
Автоматическое обновление