# Configuración y uso de la CLI de GitHub Copilot
Configure un proveedor de modelos para la GitHub Enterprise Server instancia y, a continuación, conecte los Copilot CLI clientes a la instancia.
> \[!NOTE]
> 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](/es/enterprise-cloud@latest/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli).
* GitHub CLI (`gh`) se instala en máquinas cliente. Consulte [GitHub CLI manual](https://cli.github.com/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](/es/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models).
## 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.
```shell
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_TOKEN`y 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
1. Autentíquese GitHub CLI.
```shell
gh auth login --hostname YOUR-GHES-HOSTNAME
```
2. Establezca las variables de entorno necesarias para Copilot CLI.
```shell
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.
```shell
export GH_HOST=YOUR-GHES-HOSTNAME
export GH_ENTERPRISE_TOKEN="$(gh auth token --hostname YOUR-GHES-HOSTNAME)"
```
3. Inicie Copilot CLI.
```bash
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.
```shell
• 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](/es/enterprise-cloud@latest/copilot/how-tos/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 | | |