{"meta":{"title":"Usando seus próprios modelos LLM na CLI do GitHub Copilot","intro":"Use um modelo de um provedor externo de sua escolha Copilot fornecendo sua própria chave de API.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/how-tos","title":"Instruções"},{"href":"/pt/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/customize-copilot","title":"Personalizar Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models","title":"Usar seu próprio provedor de modelos"}],"documentType":"article"},"body":"# Usando seus próprios modelos LLM na CLI do GitHub Copilot\n\nUse um modelo de um provedor externo de sua escolha Copilot fornecendo sua própria chave de API.\n\nVocê pode configurar o Copilot CLI para usar seu próprio provedor de LLM, também chamado BYOK (Bring Your Own Key), em vez de modelos hospedados pelo GitHub. Isso permite que você se conecte a pontos de extremidade compatíveis com o OpenAI, o OpenAI do Azure ou o Anthropic, incluindo modelos executados localmente, como o Ollama.\n\n> \\[!NOTE]\n> Este artigo é para usuários que desejam configurar sua própria chave de API do provedor LLM em seu computador local. Para configurar modelos personalizados para usuários em uma empresa, consulte [Habilitar modelos personalizados para GitHub Copilot em sua empresa](/pt/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models).\n\n## Pré-requisitos\n\n* Copilot CLI está instalado. Consulte [Instalando a CLI do GitHub Copilot](/pt/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli).\n* Você tem uma chave de API de um provedor LLM com suporte ou um modelo local em execução (como o Ollama).\n\n## Provedores com suporte\n\nCopilot CLI dá suporte a três tipos de provedor:\n\n| Tipo de provedor | Serviços compatíveis                                                                                                                                         |\n| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `openai`         | OpenAI, Ollama, vLLM, Foundry Local e qualquer outro ponto de extremidade compatível com a API Chat Completions da OpenAI. Esse é o tipo de provedor padrão. |\n| `azure`          | Serviço OpenAI do Azure.                                                                                                                                     |\n| `anthropic`      | Anthropic (modelos de Claude).                                                                                                                               |\n\nPara obter exemplos adicionais, execute `copilot help providers` em seu terminal.\n\n## Requisitos de modelo\n\nOs modelos devem dar suporte à **chamada de ferramentas** (também denominada chamada de funções) e ao **streaming**. Se um modelo não der suporte a nenhuma das funcionalidades, Copilot CLI retornará um erro. Para obter melhores resultados, use um modelo com uma janela de contexto de pelo menos 128 mil tokens.\n\n## Configurando seu provedor\n\nConfigure seu provedor de modelo definindo variáveis de ambiente antes de iniciar Copilot CLI.\n\n| Variável de ambiente        | Obrigatório | Descrição                                                                                                                         |\n| --------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- |\n| `COPILOT_PROVIDER_BASE_URL` | Sim         | A URL base do ponto de extremidade de API do provedor do seu model                                                                |\n| `COPILOT_PROVIDER_TYPE`     | No          | O tipo de provedor: `openai` (padrão) `azure`ou `anthropic`.                                                                      |\n| `COPILOT_PROVIDER_API_KEY`  | No          | Sua chave de API para o provedor. Não é necessário para provedores que não usam autenticação, como uma instância de Ollama local. |\n| `COPILOT_MODEL`             | Sim         | O identificador de modelo a ser usado. Você também pode definir isso com o `--model` sinalizador de linha de comando.             |\n\n## Conectando-se a um endpoint compatível com OpenAI\n\nUse as etapas a seguir se estiver se conectando a OpenAI, Ollama, vLLM, Foundry Local ou qualquer outro ponto de extremidade compatível com a API de Conclusões de Chat do OpenAI.\n\n1. Defina variáveis de ambiente para seu provedor. Por exemplo, para uma instância local do Ollama:\n\n   ```shell\n   export COPILOT_PROVIDER_BASE_URL=http://localhost:11434\n   export COPILOT_MODEL=YOUR-MODEL-NAME\n   ```\n\n   Substitua `YOUR-MODEL-NAME` pelo nome do modelo que você extraiu no Ollama (por exemplo, `llama3.2`).\n\n2. Para um ponto de extremidade remoto do OpenAI, defina a sua chave de API também.\n\n   ```shell\n   export COPILOT_PROVIDER_BASE_URL=https://api.openai.com/v1\n   export COPILOT_PROVIDER_API_KEY=YOUR-OPENAI-API-KEY\n   export COPILOT_MODEL=YOUR-MODEL-NAME\n   ```\n\n   Substitua `YOUR-OPENAI-API-KEY` por sua chave de API OpenAI e `YOUR-MODEL-NAME` pelo modelo que você deseja usar (por exemplo, `gpt-4o`).\n\n3. Inicie o Copilot CLI.\n\n```bash\ncopilot\n```\n\n## Conectando-se ao Azure OpenAI\n\n1. Defina as variáveis de ambiente para Azure OpenAI.\n\n   ```shell\n   export COPILOT_PROVIDER_BASE_URL=https://YOUR-RESOURCE-NAME.openai.azure.com/openai/deployments/YOUR-DEPLOYMENT-NAME\n   export COPILOT_PROVIDER_TYPE=azure\n   export COPILOT_PROVIDER_API_KEY=YOUR-AZURE-API-KEY\n   export COPILOT_MODEL=YOUR-DEPLOYMENT-NAME\n   ```\n\n   Substitua os seguintes espaços reservados:\n\n   * `YOUR-RESOURCE-NAME`: nome do recurso Azure OpenAI\n   * `YOUR-DEPLOYMENT-NAME`: o nome da implantação do modelo\n   * `YOUR-AZURE-API-KEY`: sua chave de API Azure OpenAI\n\n2. Inicie o Copilot CLI.\n\n```bash\ncopilot\n```\n\n## Conectando-se ao Anthropic\n\n1. Defina as variáveis de ambiente para Anthropic:\n\n   ```shell\n   export COPILOT_PROVIDER_TYPE=anthropic\n   export COPILOT_PROVIDER_BASE_URL=https://api.anthropic.com\n   export COPILOT_PROVIDER_API_KEY=YOUR-ANTHROPIC-API-KEY\n   export COPILOT_MODEL=YOUR-MODEL-NAME\n   ```\n\n   Substitua `YOUR-ANTHROPIC-API-KEY` por sua chave de API Anthropic e seu MODEL-NAME pelo modelo Claude que você deseja usar (por exemplo, `claude-opus-4-5`).\n\n2. Inicie o Copilot CLI.\n\n```bash\ncopilot\n```\n\n## Em execução no modo offline\n\nVocê pode executar Copilot CLI no modo offline para impedir que ele entre em contato com GitHubservidores. Isso foi projetado para ambientes isolados, onde a CLI deve se comunicar apenas com o seu provedor de modelo local.\n\n> \\[!IMPORTANT]\n> O modo offline só garante o isolamento total da rede se o provedor também for local ou dentro do mesmo ambiente isolado. Se `COPILOT_PROVIDER_BASE_URL` apontar para um endpoint remoto, suas solicitações e o contexto do código ainda serão enviados pela rede para esse provedor.\n\n1. Configure as variáveis de ambiente do provedor, conforme descrito na configuração do provedor.\n\n2. Defina a variável de ambiente do modo offline:\n\n   ```shell\n   export COPILOT_OFFLINE=true\n   ```\n\n3. 1. Inicie o Copilot CLI.\n\n```bash\ncopilot\n```"}