{"meta":{"title":"Configuración y uso de la CLI de GitHub Copilot","intro":"Configure un proveedor de modelos para la GitHub Enterprise Server instancia y, a continuación, conecte los Copilot CLI clientes a la instancia.","product":"Administradores de empresa","breadcrumbs":[{"href":"/es/enterprise-server@3.22/admin","title":"Administradores de empresa"},{"href":"/es/enterprise-server@3.22/admin/github-copilot","title":"GitHub Copilot"},{"href":"/es/enterprise-server@3.22/admin/github-copilot/copilot-cli","title":"Copilot CLI"},{"href":"/es/enterprise-server@3.22/admin/github-copilot/copilot-cli/set-up-and-use-copilot-cli","title":"Configuración y uso Copilot CLI"}],"documentType":"article"},"body":"# Configuración y uso de la CLI de GitHub Copilot\n\nConfigure un proveedor de modelos para la GitHub Enterprise Server instancia y, a continuación, conecte los Copilot CLI clientes a la instancia.\n\n> \\[!NOTE]\n> Esta característica está en Versión preliminar técnica y está sujeta a cambios.\n\nPuede 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.\n\nLa configuración de esta característica implica dos roles:\n\n* **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.\n* **Usuario final**: establece variables de entorno en un equipo local para conectarse Copilot CLI a la instancia.\n\n## Prerequisites\n\n* Tiene acceso SSH administrativo a la GitHub Enterprise Server instancia.\n* Tiene una clave de API de un proveedor de LLM compatible.\n* 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).\n* GitHub CLI (`gh`) se instala en máquinas cliente. Consulte [GitHub CLI manual](https://cli.github.com/manual/) en la GitHub CLI documentación.\n\nPara 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).\n\n## Configuración de la GitHub Enterprise Server instancia\n\nEste paso es para el operador o el administrador de la GitHub Enterprise Server instancia.\n\nCon 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.\n\n| Nombre de la variable | Obligatorio | Options | Descripción |\n| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `app.copilot-proxy.enabled` | Sí | | |\n| `true`, `false` | Habilita o deshabilita la característica. | | |\n| `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`). |\n| `secrets.copilot-proxy.endpoint-key` | Sí | String | La clave de API del proveedor de origen. |\n| `app.copilot-proxy.provider-model-id` | Sí | String | Identificador de modelo de proveedor que Copilot CLI usa para buscar el modelo internamente. |\n| `app.copilot-proxy.provider-type` | Sí | | |\n| `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. | | |\n| `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. |\n| `app.copilot-proxy.provider-wire-api` | No | | |\n| `completions`, `responses` | Formato de la API de conexión para el proveedor. | | |\n| `app.copilot-proxy.provider-wire-model` | No | String | Invalida el identificador de modelo enviado al proveedor ascendente si difiere del identificador de modelo interno. |\n| `app.copilot-proxy.enable-upstream-probe` | No | | |\n| `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. | | |\n\nPor ejemplo, los siguientes comandos configuran un proveedor de OpenAI.\n\n```shell\nghe-config app.copilot-proxy.enabled true\nghe-config app.copilot-proxy.endpoint-url 'https://api.openai.com/v1'\nghe-config secrets.copilot-proxy.endpoint-key 'YOUR-API-KEY'\nghe-config app.copilot-proxy.provider-model-id 'gpt-5.5'\nghe-config app.copilot-proxy.provider-wire-model 'gpt-5.5'\nghe-config app.copilot-proxy.provider-type openai\nghe-config app.copilot-proxy.upstream-timeout 300\nghe-config app.copilot-proxy.enable-upstream-probe false\nghe-config-apply\n```\n\nReemplace por `YOUR-API-KEY` la clave de API real antes de aplicar la configuración.\n\n## Configuración del Copilot CLI cliente (usuario final)\n\nConfigure Copilot CLI para conectarse a la GitHub Enterprise Server instancia estableciendo las siguientes variables de entorno antes de iniciar Copilot CLI.\n\n| Variable del entorno | Obligatorio | Descripción |\n| ----------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- |\n| `COPILOT_PROVIDER_GHES_HOST` | Sí | Nombre de host de la GitHub Enterprise Server instancia. |\n| `COPILOT_PROVIDER_GHES_TOKEN` | Sí | Un personal access token para la instancia GitHub Enterprise Server. Este token autentica las solicitudes a la instancia. |\n| `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. |\n\n## Descripción de los tokens de cliente (usuario final)\n\nCopilot 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.\n\nSe 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)\"`.\n\nComo 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`.\n\nEl enfoque anterior funciona cuando se usa Copilot CLI de forma interactiva. Para la automatización, debe hacer algunas cosas de forma diferente:\n\n* Establezca `GH_ENTERPRISE_TOKEN` (o `GITHUB_ENTERPRISE_TOKEN`) en .personal access token\n* Establezca `GH_HOST` en el nombre de host del servidor.\n* Cuando existen credenciales de `gh auth login` y `GH_ENTERPRISE_TOKEN` para el mismo host, la variable de entorno tiene prioridad.\n\n## Configuración recomendada del usuario final\n\n1. Autentíquese GitHub CLI.\n\n ```shell\n gh auth login --hostname YOUR-GHES-HOSTNAME\n ```\n\n2. Establezca las variables de entorno necesarias para Copilot CLI.\n\n ```shell\n export COPILOT_PROVIDER_GHES_HOST=YOUR-GHES-HOSTNAME\n export COPILOT_PROVIDER_GHES_TOKEN=\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"\n export COPILOT_OFFLINE=true\n ```\n\n 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.\n\n ```shell\n export GH_HOST=YOUR-GHES-HOSTNAME\n export GH_ENTERPRISE_TOKEN=\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"\n ```\n\n3. Inicie Copilot CLI.\n\n```bash\ncopilot\n```\n\nPuede ejecutar toda esta configuración como un script.\n\n## Ejemplos\n\nSi 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.\n\n```shell\n • fabric-core-mcp — disabled\n • powerbi-mcp — disabled\n • slack — connected\n\n ● Current model: gpt-5.5\n\n ❯ Hello 13:31\n\n ● Hello!\n\n ❯ what is going on in github/codeql-action repo? 13:33\n\n ● I’ll check recent repository activity on the GHES host: repo metadata, open \n PRs/issues, and latest commits.\n\n $ Shell Fetch repo metadata 2 lines… 5s\n gh api --hostname \"$GH_HOST\" repos/github/codeql-action --jq '{name_with_own…\n```\n\n## Funcionalidades admitidas en GitHub Enterprise Server\n\nPara 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.\n\nLa siguiente tabla ofrece una visión general orientativa de lo que está disponible en la oferta GitHub Enterprise Server.\n\n| Capacidad | GitHub / GitHub Enterprise Cloud | GitHub Enterprise Server |\n| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n| Codificación asistida por IA (avisos, generación de código, depuración) | | |\n| Comandos de Shell y operaciones de archivos | | |\n| GitHub operaciones (problemas, solicitudes de incorporación de cambios, repositorios) a través de `gh` la CLI | | |\n| (requiere `gh` CLI autenticada en la instancia) | | |\n| GitHub Herramientas de servidor MCP | | |\n| Búsqueda web y captura web | | |\n| Copilot selección de modelos (GitHubmodelos hospedados) | | |\n| Informes de uso y telemetría | | |\n| Actualización automática | | |"}