{"meta":{"title":"Autenticando GitHub Copilot CLI","intro":"Autentique-se CLI do Copilot para que você possa usar Copilot diretamente da linha de comando.","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":"CLI do Copilot"},{"href":"/pt/copilot/how-tos/copilot-cli/set-up-copilot-cli","title":"Configurar a CLI do Copilot"},{"href":"/pt/copilot/how-tos/copilot-cli/set-up-copilot-cli/authenticate-copilot-cli","title":"Autenticar Copilot CLI"}],"documentType":"article"},"body":"# Autenticando GitHub Copilot CLI\n\nAutentique-se CLI do Copilot para que você possa usar Copilot diretamente da linha de comando.\n\n## Sobre a autenticação\n\nSe você usar suas próprias chaves de API do provedor LLM (BYOK), GitHub a autenticação não será necessária.\n\nA autenticação é necessária para qualquer outro CLI do GitHub Copilot uso.\n\nQuando a autenticação é necessária, CLI do Copilot dá suporte a três métodos. O método usado depende se você está trabalhando interativamente ou em um ambiente automatizado.\n\n* **Fluxo do dispositivo OAuth**: o método padrão e recomendado para uso interativo. Quando você executa `/login` em CLI do Copilot, a CLI gera um código único e direciona você a se autenticar no navegador. Essa é a maneira mais simples de autenticar. Consulte [Autenticação com OAuth](#authenticating-with-oauth).\n* variáveis de ambiente: As recomendadas para pipelines de CI/CD, contêineres e ambientes não interativos. Você define um token com suporte como uma variável de ambiente (`COPILOT_GITHUB_TOKEN`ou `GH_TOKEN``GITHUB_TOKEN`) e a CLI o usa automaticamente sem solicitar. Consulte [Autenticação com variáveis de ambiente](#authenticating-with-environment-variables).\n* **\n GitHub CLI fallback**: se você tiver GitHub CLI (`gh`) (observação: a `gh` CLI, não `copilot`) instalada e autenticada, CLI do Copilot poderá usar seu token automaticamente. Esse é o método de prioridade mais baixo e é ativado somente quando nenhuma outra credencial é encontrada. Consulte [Autenticação com GitHub CLI](#authenticating-with-github-cli).\n\nDepois de autenticado, CLI do Copilot lembra o logon e usa automaticamente o token para todas as Copilot solicitações de API. Você pode fazer logon com várias contas e a CLI se lembrará da conta usada pela última vez. O tempo de vida e a expiração do token dependem de como o token foi criado nas configurações de sua conta ou organização.\n\n## Uso não autenticado\n\nSe você configurar CLI do Copilot para usar suas próprias CHAVES de API do provedor LLM (BYOK), GitHub a autenticação **não será necessária**. \n CLI do Copilot pode se conectar diretamente ao provedor configurado sem uma GitHub conta ou token.\n\nNo entanto, sem GitHub autenticação, os seguintes recursos **não estão disponíveis**:\n\n* `/delegate`: requer agente de nuvem Copilot, que é executado nos servidores de GitHub\n* GitHub Servidor MCP: requer autenticação para acessar GitHub APIs\n* GitHub Pesquisa de Código: requer autenticação para consultar GitHubo índice de pesquisa\n\nVocê pode combinar o BYOK com a autenticação GitHub para unir o melhor dos dois mundos: seu modelo preferido para respostas de IA e o acesso a recursos hospedados em GitHub, como `/delegate` e pesquisa de código.\n\n### Modo offline\n\n Se você definir a variável de ambiente `COPILOT_OFFLINE` para `true`, CLI do Copilot será executada sem entrar em contato com os servidores de GitHub. No modo offline:\n\n* Nenhuma GitHub autenticação será tentada.\n* A CLI só faz solicitações de rede para seu provedor BYOK configurado.\n* A telemetria está totalmente desabilitada.\n\nO modo offline é **totalmente isolado da Internet** apenas quando o provedor BYOK é local ou está no mesmo ambiente isolado (por exemplo, um modelo executado localmente, sem acesso à rede externa). Se `COPILOT_PROVIDER_BASE_URL` apontar para um endpoint remoto ou acessível pela Internet, os prompts e o contexto de código continuarão a ser enviados pela rede para esse fornecedor. Sem o modo offline, mesmo ao usar BYOK sem GitHub autenticação, a telemetria ainda é enviada normalmente.\n\n### Tipos de token com suporte\n\n| Tipo de token | Prefixo | Suportado | Anotações |\n|----------------------------|---------------|-----------|--------------------------------------------------------|\n| Token OAuth (fluxo de dispositivo) | `gho_` | Yes | Método padrão por meio de `copilot login` |\n| PAT refinado | `github_pat_` | Yes | Deve incluir permissões necessárias **Solicitações do Copilot** |\n| GitHub aplicativo usuário-para-servidor | `ghu_` | Yes | Por meio da variável de ambiente |\n| PAT clássico | `ghp_` | Não | Não há suporte para CLI do Copilot |\n\n### Como Copilot CLI armazena credenciais\n\nPor padrão, a CLI armazena o token OAuth no conjunto de chaves do sistema operacional sob o nome `copilot-cli`do serviço:\n\n| Plataforma | Conjunto de chaves |\n|---|---|\n| macOS | Acesso às Chaves |\n| Windows | Gerenciador de Credenciais |\n| Linux | libsecret (GNOME Keyring, KWallet) |\n\nSe o keychain do sistema não estiver disponível – por exemplo, em um servidor Linux sem interface gráfica e sem `libsecret` instalado – a CLI solicitará que você armazene o token em um arquivo de configuração de texto simples em `~/.copilot/config.json`.\n\nAo executar um comando, CLI do Copilot verifique se há credenciais na seguinte ordem:\n\n1. Variável de ambiente `COPILOT_GITHUB_TOKEN`\n1. Variável de ambiente `GH_TOKEN`\n1. Variável de ambiente `GITHUB_TOKEN`\n1. Token OAuth do keychain do sistema\n1. Fallback do GitHub CLI (`gh auth token`)\n\n> [!NOTE]\n> * Uma variável de ambiente substitui silenciosamente um token OAuth armazenado. Se você definir `GH_TOKEN` para outra ferramenta, a CLI usará esse token em vez do token OAuth de `copilot login`. Para evitar um comportamento inesperado, desconjunta variáveis de ambiente que você não pretende que a CLI use.\n> * Quando você configura variáveis de ambiente do provedor BYOK (por exemplo, `COPILOT_PROVIDER_BASE_URL`, ), `COPILOT_PROVIDER_API_KEY`CLI do Copilot usa-as para solicitações de modelo de IA, independentemente do status GitHub de autenticação. \n GitHub Os tokens são necessários apenas para recursos hospedados em GitHub.\n\n## Autenticação com OAuth\n\nO fluxo do dispositivo OAuth é o método de autenticação padrão para uso interativo. Você pode autenticar executando `/login` a partir de CLI do Copilot ou `copilot login` através de seu terminal.\n\n### Autenticar com `/login`\n\n1. De CLI do Copilot, execute `/login`.\n\n ```bash copy\n /login\n ```\n\n1. Selecione a conta com a qual você deseja autenticar. Para GitHub Enterprise Cloud com residência de dados, informe o nome do host da sua instância\n\n ```text\n What account do you want to log into?\n 1. GitHub.com\n 2. GitHub Enterprise Cloud with data residency (*.ghe.com)\n ```\n\n1. A CLI exibe um código de usuário único, copia-o automaticamente para a sua área de transferência e abre o seu navegador.\n\n ```text\n Waiting for authorization...\n Enter one-time code: 1234-5678 at https://github.com/login/device\n Press any key to copy to clipboard and open browser...\n ```\n\n1. Navegue até a URL de verificação em `https://github.com/login/device` se o navegador não abrir automaticamente.\n1. Cole o código único no campo na página.\n1. Se sua organização usar o SSO do SAML, clique em **Authorize** ao lado de cada organização à qual você deseja conceder access.\n1. Examine as permissões solicitadas e clique em **Authorize GitHub Copilot CLI**.\n1. Retorne ao terminal. A CLI exibe uma mensagem de êxito quando a autenticação é concluída.\n\n ```text\n Signed in successfully as Octocat. You can now use Copilot.\n ```\n\n### Autenticar com `copilot login`\n\n1. No terminal, execute `copilot login`. Se você estiver usando GitHub Enterprise Cloud com residência de dados, forneça o nome do host da instância.\n\n ```bash copy\n copilot login\n ```\n\n Para GitHub Enterprise Cloud:\n\n ```bash copy\n copilot login --host HOSTNAME\n ```\n\n A CLI exibe um código de usuário único, copia-o automaticamente para a sua área de transferência e abre o seu navegador.\n\n ```text\n To authenticate, visit https://github.com/login/device and enter code 1234-5678.\n ```\n\n1. Navegue até a URL de verificação em `https://github.com/login/device` se o navegador não abrir automaticamente.\n1. Cole o código único no campo na página.\n1. Se sua organização usar o SSO do SAML, clique em **Authorize** ao lado de cada organização à qual você deseja conceder access.\n1. Examine as permissões solicitadas e clique em **Authorize GitHub Copilot CLI**.\n1. Retorne ao terminal. A CLI exibe uma mensagem de êxito quando a autenticação é concluída.\n\n ```text\n Signed in successfully as Octocat.\n ```\n\n## Autenticação com variáveis de ambiente\n\nPara ambientes não interativos, você pode autenticar definindo uma variável de ambiente com um token com suporte. Isso é ideal para pipelines de CI/CD, contêineres ou servidores sem cabeça.\n\n1. Visite [Fine-grained personal access tokens](https://github.com/settings/personal-access-tokens/new).\n1. Em \"Permissões\", clique em **Adicionar permissões** e selecione **Copilot Solicitações**.\n1. Clique em **Gerar token**.\n1. Exporte o token na configuração do terminal ou do ambiente. Use a variável de ambiente `COPILOT_GITHUB_TOKEN`, `GH_TOKEN` ou `GITHUB_TOKEN` (em ordem de precedência).\n\n## Autenticação com GitHub CLI\n\nSe você tiver GitHub CLI instalado e autenticado, CLI do Copilot poderá usar seu token como um fallback. Esse método tem a prioridade mais baixa e é ativado somente quando nenhuma variável de ambiente é definida e nenhum token armazenado é encontrado.\n\n1. \n GitHub CLI Verifique se ele está autenticado.\n\n ```bash copy\n gh auth status\n ```\n\n Se você usar GitHub Enterprise Cloud com residência de dados, verifique se o nome do host correto está autenticado.\n\n ```bash copy\n gh auth status --hostname HOSTNAME\n ```\n\n1. Execute `copilot`. A CLI do Copilot usa o token GitHub CLI automaticamente.\n1. Execute `/user` para verificar sua conta autenticada na CLI.\n\n## Como alternar entre contas\n\n CLI do Copilot dá suporte a várias contas. Você pode listar as contas disponíveis e alternar entre elas de dentro da CLI. Para listar as contas disponíveis, execute `/user list` no CLI do Copilot prompt. Para alternar para uma conta diferente, digite `/user switch` no prompt.\n\nPara adicionar outra conta, execute `copilot login` em uma nova sessão de terminal ou execute o comando de logon de dentro da CLI e autorize com a outra conta.\n\n## Sair e remover credenciais\n\nPara sair, digite `/logout` no prompt CLI do Copilot. Isso remove o token armazenado localmente, mas não o revoga no GitHub.\n\nPara revogar a autorização GitHub do aplicativo OAuth e impedir que ela seja usada em outro lugar, siga estas etapas.\n\n1. Navegue até **Configurações** > **Aplicativos** > **Aplicativos OAuth autorizados**.\n1. Navegue até a página de configurações:\n 1. No canto superior direito de qualquer página em GitHub, clique na sua imagem de perfil. \n 1. Clique em **Configurações**.\n1. Na barra lateral esquerda, clique em **Aplicativos**.\n1. Em **Authorized OAuth Apps**, clique em ao lado de **GitHub CLI** para expandir o menu e selecionar **Revoke**."}