{"meta":{"title":"Configurar e usar GitHub Copilot CLI","intro":"Configure um provedor de modelos para sua GitHub Enterprise Server instância e conecte Copilot CLI os clientes à instância.","product":"Administradores da empresa","breadcrumbs":[{"href":"/pt/enterprise-server@3.22/admin","title":"Administradores da empresa"},{"href":"/pt/enterprise-server@3.22/admin/github-copilot","title":"GitHub Copilot"},{"href":"/pt/enterprise-server@3.22/admin/github-copilot/copilot-cli","title":"Copilot CLI"},{"href":"/pt/enterprise-server@3.22/admin/github-copilot/copilot-cli/set-up-and-use-copilot-cli","title":"Configurar e usar Copilot CLI"}],"documentType":"article"},"body":"# Configurar e usar GitHub Copilot CLI\n\nConfigure um provedor de modelos para sua GitHub Enterprise Server instância e conecte Copilot CLI os clientes à instância.\n\n> \\[!NOTE]\n> Esse recurso está dentro versão prévia técnica e sujeito a alterações.\n\nVocê pode configurar Copilot CLI para funcionar com GitHub Enterprise Server em ambientes desconectados ou isolados da rede, sem conectividade com a nuvem GitHub. Um administrador configura um provedor de modelos para a instância e os usuários se conectam Copilot CLI com suas GitHub Enterprise Server credenciais.\n\nA configuração desse recurso envolve duas funções:\n\n* **Administrador**: configura o provedor de modelo na GitHub Enterprise Server instância usando `ghe-config`. Essa é uma configuração única que requer acesso SSH administrativo.\n* **Usuário final**: define variáveis de ambiente em um computador local para se conectar Copilot CLI à instância.\n\n## Pré-requisitos\n\n* Você tem acesso SSH administrativo à GitHub Enterprise Server instância.\n* Você tem uma chave de API de um provedor LLM com suporte.\n* Copilot CLI é instalado em computadores cliente. Consulte [Instalando a CLI do GitHub Copilot](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli).\n* GitHub CLI (`gh`) é instalado em computadores cliente. Consulte o [GitHub CLI manual](https://cli.github.com/manual/) na GitHub CLI documentação.\n\nPara obter informações sobre provedores com suporte e requisitos de modelo, consulte [Usando seus próprios modelos LLM na CLI do GitHub Copilot](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models).\n\n## Configurando sua GitHub Enterprise Server instância\n\nEsta etapa é para o operador ou administrador da GitHub Enterprise Server instância.\n\nCom acesso administrativo por SSH à instância GitHub Enterprise Server, configure o provedor do modelo usando os seguintes valores de `ghe-config`. Depois de configurar, execute `ghe-config-apply` para aplicar as alterações.\n\n| Nome da variável | Obrigatório | Opções | Description |\n| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------- |\n| `app.copilot-proxy.enabled` | Yes | | |\n| `true`, `false` | Habilita ou desabilita o recurso. | | |\n| `app.copilot-proxy.endpoint-url` | Yes | URI | A URL de base upstream completa, incluindo qualquer prefixo de versão (por exemplo, `https://api.openai.com/v1`). |\n| `secrets.copilot-proxy.endpoint-key` | Yes | String | A chave de API para o provedor upstream. |\n| `app.copilot-proxy.provider-model-id` | Yes | String | O ID do provedor de modelo que Copilot CLI usa para localizar o modelo internamente. |\n| `app.copilot-proxy.provider-type` | Yes | | |\n| `openai`, `azure`, `anthropic` | O tipo de provedor. OpenAI inclui OpenAI, Ollama, vLLM, Foundry Local e qualquer outro endpoint compatível com a API de Chat Completions da OpenAI. | | |\n| `app.copilot-proxy.upstream-timeout` | Não | Inteiro, em segundos | Tempo limite de leitura/envio em segundos para solicitações upstream. Se não estiver definido, retornará ao tempo limite padrão. |\n| `app.copilot-proxy.provider-wire-api` | Não | | |\n| `completions`, `responses` | O formato da API de fio para o provedor. | | |\n| `app.copilot-proxy.provider-wire-model` | Não | String | Substitui o identificador de modelo enviado ao provedor upstream se ele for diferente da ID do modelo interno. |\n| `app.copilot-proxy.enable-upstream-probe` | Não | | |\n| `true`, `false` | Ativa ou desativa a sonda upstream de inicialização. Por padrão, está habilitado. Quando desativada, a sonda de inicialização é ignorada. | | |\n\nPor exemplo, os comandos a seguir configuram um provedor 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\nSubstitua `YOUR-API-KEY` pela chave de API real antes de aplicar a configuração.\n\n## Configurando seu Copilot CLI cliente (usuário final)\n\nConfigure Copilot CLI para se conectar à sua GitHub Enterprise Server instância definindo as seguintes variáveis de ambiente antes de iniciar Copilot CLI.\n\n| Variável de ambiente | Obrigatório | Description |\n| ----------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------- |\n| `COPILOT_PROVIDER_GHES_HOST` | Yes | O nome do host da sua instância GitHub Enterprise Server. |\n| `COPILOT_PROVIDER_GHES_TOKEN` | Yes | Um personal access token para a GitHub Enterprise Server instância. Esse token autentica solicitações à instância. |\n| `COPILOT_OFFLINE` | Yes | Habilita o modo offline. O GitHub Enterprise Server provedor só estará ativo quando o modo offline estiver habilitado. |\n\n## Noções básicas sobre tokens de cliente (usuário final)\n\nCopilot CLI precisa de acesso à inferência de LLM, por isso `COPILOT_PROVIDER_GHES_TOKEN` é sempre necessário. Você também provavelmente desejará Copilot CLI executar GitHub operações como criar problemas, solicitações de pull e repositórios de pesquisa. Essas operações podem ser feitas por meio do GitHub CLI.\n\nÉ recomendável e preferencial que você execute `gh auth login --hostname YOUR-GHES-HOSTNAME`. Depois que ele for bem-sucedido, a próxima etapa será definir `COPILOT_PROVIDER_GHES_TOKEN` como o token gerado em `gh auth login --hostname YOUR-GHES-HOSTNAME`. É mais seguro recuperar o token dinamicamente em vez de copiá-lo de `~/.config/gh/hosts.yml`. Você pode fazer isso usando `COPILOT_PROVIDER_GHES_TOKEN=\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"`.\n\nComo alternativa, você pode gerar um personal access token em sua GitHub Enterprise Server instância, definir esse token como `COPILOT_PROVIDER_GHES_TOKEN`e usar o mesmo token ao executar `gh auth login --hostname YOUR-GHES-HOSTNAME`.\n\nA abordagem acima funciona quando você está usando Copilot CLI interativamente. Para automação, você precisa fazer algumas coisas de forma diferente:\n\n* Definir `GH_ENTERPRISE_TOKEN` (ou `GITHUB_ENTERPRISE_TOKEN`) como personal access token.\n* Defina `GH_HOST` como o nome do host do servidor.\n* Quando as credenciais `GH_ENTERPRISE_TOKEN` e `gh auth login` existirem para o mesmo host, a variável de ambiente prevalece.\n\n## Configuração recomendada do usuário final\n\n1. Autenticar GitHub CLI.\n\n ```shell\n gh auth login --hostname YOUR-GHES-HOSTNAME\n ```\n\n2. Defina as variáveis de ambiente exigidas por 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 Se você estiver autenticado com `gh auth login` várias contas, poderá definir `GH_HOST` como nome de host do servidor e definir `GH_ENTERPRISE_TOKEN` (ou `GITHUB_ENTERPRISE_TOKEN`) como `\"$(gh auth token --hostname YOUR-GHES-HOSTNAME)\"`. Isso garante que GitHub CLI aponte para sua instância GitHub Enterprise Server.\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 o Copilot CLI.\n\n```bash\ncopilot\n```\n\nVocê pode executar toda essa configuração como um script.\n\n## Examples\n\nSe ambas GitHub Enterprise Server e suas Copilot CLI configurações estiverem corretas, você deverá ver respostas como as seguintes em sua Copilot CLI sessão.\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## Capacidades compatíveis com GitHub Enterprise Server\n\nPara obter as informações mais atualizadas sobre os recursos do Copilot CLI, consulte [GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli) como a fonte principal de referência. Em geral, qualquer funcionalidade que dependa da conectividade com GitHub os serviços de nuvem não está disponível na GitHub Enterprise Server configuração offline.\n\nA tabela a seguir fornece uma visão geral indicativa do que está disponível na oferta GitHub Enterprise Server.\n\n| Capacidade | GitHub / GitHub Enterprise Cloud | GitHub Enterprise Server |\n| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n| Programação assistida por IA (prompts, geração de código, depuração) | | |\n| Comandos do Shell e operações de arquivo | | |\n| GitHub operações (problemas, PRs, repositórios) via `gh` CLI | | |\n| (requer `gh` CLI autenticada na instância) | | |\n| GitHub Ferramentas do servidor MCP | | |\n| Pesquisa na Web e busca na Web | | |\n| Copilot seleção de modelos (GitHubmodelos hospedados) | | |\n| Relatórios de telemetria e uso | | |\n| Atualização automática | | |"}