Configuración y uso de la CLI de GitHub Copilot

Nota:

Esta característica está en Versión preliminar técnica y está sujeta a cambios.

Puede configurar Copilot CLI para que funcione con GitHub Enterprise Server en entornos desconectados o aislados de la red, sin conectividad a la nube de GitHub. Un administrador configura un proveedor de modelos para la instancia y los usuarios se conectan Copilot CLI con sus GitHub Enterprise Server credenciales.

La configuración de esta característica implica dos roles:

Administrador: configura el proveedor de modelos en la GitHub Enterprise Server instancia mediante ghe-config. Se trata de una configuración única que requiere acceso SSH administrativo.
Usuario final: establece variables de entorno en un equipo local para conectarse Copilot CLI a la instancia.

Prerequisites

Tiene acceso SSH administrativo a la GitHub Enterprise Server instancia.
Tiene una clave de API de un proveedor de LLM compatible.
Copilot CLI se instala en las máquinas cliente. Consulte Instalación de la CLI de GitHub Copilot.
GitHub CLI (gh) se instala en máquinas cliente. Consulte GitHub CLI manual en la GitHub CLI documentación.

Para obtener información sobre los proveedores admitidos y los requisitos del modelo, consulte Uso de sus propios modelos LLM en la herramienta GitHub Copilot CLI.

Configuración de la GitHub Enterprise Server instancia

Este paso es para el operador o el administrador de la GitHub Enterprise Server instancia.

Con acceso administrativo por SSH a la instancia GitHub Enterprise Server, configure el proveedor del modelo con los siguientes valores ghe-config. Después de configurar, ejecute ghe-config-apply para aplicar los cambios.

Nombre de la variable	Obligatorio	Options	Descripción
`app.copilot-proxy.enabled`	Sí
`true`, `false`	Habilita o deshabilita la característica.
`app.copilot-proxy.endpoint-url`	Sí	URI	Dirección URL base ascendente completa, incluido cualquier prefijo de versión (por ejemplo, `https://api.openai.com/v1`).
`secrets.copilot-proxy.endpoint-key`	Sí	String	La clave de API del proveedor de origen.
`app.copilot-proxy.provider-model-id`	Sí	String	Identificador de modelo de proveedor que Copilot CLI usa para buscar el modelo internamente.
`app.copilot-proxy.provider-type`	Sí
`openai`, , `azure`, `anthropic`	Tipo de proveedor. OpenAI incluye OpenAI, Ollama, vLLM, Foundry Local y cualquier otro punto de conexión compatible con la API de finalizaciones de chat de OpenAI.
`app.copilot-proxy.upstream-timeout`	No	Número entero, en segundos	Tiempo de espera de lectura y envío en segundos para las solicitudes ascendentes. Si no se establece, retroceda al tiempo de espera predeterminado.
`app.copilot-proxy.provider-wire-api`	No
`completions`, `responses`	Formato de la API de conexión para el proveedor.
`app.copilot-proxy.provider-wire-model`	No	String	Invalida el identificador de modelo enviado al proveedor ascendente si difiere del identificador de modelo interno.
`app.copilot-proxy.enable-upstream-probe`	No
`true`, `false`	Habilita o deshabilita el sondeo ascendente de inicio. El valor predeterminado es estar habilitado. Cuando está deshabilitado, se omite el sondeo de inicio.

Por ejemplo, los siguientes comandos configuran un proveedor de 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

Reemplace por YOUR-API-KEY la clave de API real antes de aplicar la configuración.

Configuración del Copilot CLI cliente (usuario final)

Configure Copilot CLI para conectarse a la GitHub Enterprise Server instancia estableciendo las siguientes variables de entorno antes de iniciar Copilot CLI.

Variable del entorno	Obligatorio	Descripción
`COPILOT_PROVIDER_GHES_HOST`	Sí	Nombre de host de la GitHub Enterprise Server instancia.
`COPILOT_PROVIDER_GHES_TOKEN`	Sí	Un personal access token para la instancia GitHub Enterprise Server. Este token autentica las solicitudes a la instancia.
`COPILOT_OFFLINE`	Sí	Habilita el modo sin conexión. El GitHub Enterprise Server proveedor solo está activo cuando el modo sin conexión está habilitado.

Descripción de los tokens de cliente (usuario final)

Copilot CLI necesita acceso a la inferencia de LLM, por lo que COPILOT_PROVIDER_GHES_TOKEN siempre es necesario. También es muy probable que quiera usar Copilot CLI para realizar operaciones de GitHub, como crear incidencias, solicitudes de extracción y buscar en repositorios. Estas operaciones se pueden realizar a través de GitHub CLI.

Se recomienda y se prefiere ejecutar gh auth login --hostname YOUR-GHES-HOSTNAME. Después de que se realice correctamente, el siguiente paso es establecer COPILOT_PROVIDER_GHES_TOKEN en el token generado en gh auth login --hostname YOUR-GHES-HOSTNAME. Es más seguro recuperar el token dinámicamente en lugar de copiarlo desde ~/.config/gh/hosts.yml. Puede hacerlo mediante COPILOT_PROVIDER_GHES_TOKEN="$(gh auth token --hostname YOUR-GHES-HOSTNAME)".

Como alternativa, puede generar un personal access token en la GitHub Enterprise Server instancia, establecer ese token como COPILOT_PROVIDER_GHES_TOKENy usar el mismo token al ejecutar gh auth login --hostname YOUR-GHES-HOSTNAME.

El enfoque anterior funciona cuando se usa Copilot CLI de forma interactiva. Para la automatización, debe hacer algunas cosas de forma diferente:

Establezca GH_ENTERPRISE_TOKEN (o GITHUB_ENTERPRISE_TOKEN) en .personal access token
Establezca GH_HOST en el nombre de host del servidor.
Cuando existen credenciales de gh auth login y GH_ENTERPRISE_TOKEN para el mismo host, la variable de entorno tiene prioridad.

Configuración recomendada del usuario final

Autentíquese GitHub CLI.

gh auth login --hostname YOUR-GHES-HOSTNAME

Establezca las variables de entorno necesarias para 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 ha iniciado sesión con gh auth login en varias cuentas, puede configurar GH_HOST con el nombre de host de su servidor y establecer GH_ENTERPRISE_TOKEN (o GITHUB_ENTERPRISE_TOKEN) en "$(gh auth token --hostname YOUR-GHES-HOSTNAME)". Esto garantiza que tenga GitHub CLI como destino la GitHub Enterprise Server instancia.
```
export GH_HOST=YOUR-GHES-HOSTNAME
export GH_ENTERPRISE_TOKEN="$(gh auth token --hostname YOUR-GHES-HOSTNAME)"
```
Inicie Copilot CLI.

copilot

Puede ejecutar toda esta configuración como un script.

Ejemplos

Si tanto GitHub Enterprise Server como la configuración de Copilot CLI son correctos, debería ver respuestas como las siguientes en su sesión de 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…

Funcionalidades admitidas en GitHub Enterprise Server

Para obtener la información más actualizada sobre las funciones de Copilot CLI, consulte GitHub Copilot CLI como fuente principal y autorizada. En general, cualquier funcionalidad que se base en la conectividad con GitHub los servicios en la nube no está disponible en la GitHub Enterprise Server configuración sin conexión.

La siguiente tabla ofrece una visión general orientativa de lo que está disponible en la oferta GitHub Enterprise Server.

Capacidad	GitHub / GitHub Enterprise Cloud	GitHub Enterprise Server
Codificación asistida por IA (avisos, generación de código, depuración)
Comandos de Shell y operaciones de archivos
GitHub operaciones (problemas, solicitudes de incorporación de cambios, repositorios) a través de `gh` la CLI
(requiere `gh` CLI autenticada en la instancia)
GitHub Herramientas de servidor MCP
Búsqueda web y captura web
Copilot selección de modelos (GitHubmodelos hospedados)
Informes de uso y telemetría
Actualización automática

En este artículo