Ir para o conteúdo
Promovaweb

Modelos, login e acesso ao GitHub Copilot CLI

StayCloudVPS Agêntica

O mesmo ambiente do SetupVibe, agora numa VPS

Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

Criar minha VPS na StayCloud

Link de parceiro da Promovaweb.

Black Friday até 30/11

30%off

nos 2 primeiros meses do plano mensal da VPS

  • Backup diário grátis para sempre
  • Servidores em São Paulo no datacenter da Ascenty
  • Datacenter Tier III manutenção sem parada
  • Acesso root com disco SSD NVMe
  • Réplica do backup em Ashburn, nos EUA

O GitHub Copilot CLI roda no Linux, no macOS e no Windows e usa os modelos hospedados pelo GitHub com uma assinatura ativa do GitHub Copilot, pessoal ou liberada pela sua organização. Cada interação consome créditos de IA conforme os tokens processados e o modelo escolhido, que você troca durante a sessão ou substitui por um provedor próprio.

Sumário da página

  1. A assinatura vem antes da instalação
  2. Entrar com o login do GitHub
  3. Escolher o modelo da sessão
  4. Créditos consumidos por interação
  5. Um provedor de modelo próprio
  6. Sem login no GitHub, com recursos a menos

A assinatura vem antes da instalação

O CLI é um cliente do GitHub Copilot. O uso com os modelos hospedados pelo GitHub exige uma assinatura ativa do Copilot, com planos e preços publicados no site oficial do GitHub. O acesso recebido pela organização ou pela empresa depende de uma política. Com o Copilot CLI desligado pelo dono da organização ou pelo administrador da empresa, o CLI não funciona para aquele usuário, mesmo com a assinatura ativa.

O programa roda no Linux, no macOS e no Windows, pelo PowerShell ou pelo Windows Subsystem for Linux. No Windows, a documentação exige o PowerShell na versão 6 ou superior. O GitHub distribui o CLI pelo npm, com o pacote @github/copilot, pelo Homebrew no macOS e no Linux, pelo WinGet no Windows, por um script de instalação e pelos executáveis publicados nas releases do repositório github/copilot-cli. Cada canal tem também uma versão de pré-lançamento.

O código não é aberto. O arquivo de licença do repositório concede o direito de instalar e rodar o software e de redistribuir cópias sem modificação dentro de uma aplicação que tenha função própria além do CLI. A mesma licença proíbe modificar o programa, criar obras derivadas e distribuí-lo sozinho. O repositório público guarda o README, o changelog, as releases e o espaço para issues e discussões.

Entrar com o login do GitHub

Na primeira execução sem login, o CLI sugere o comando /login. O método padrão para uso interativo é o OAuth, com dois fluxos. O fluxo pelo navegador abre a autorização no GitHub e conclui num retorno local. O fluxo por código de dispositivo mostra um código de uso único para você digitar em github.com/login/device. O navegador é o padrão no computador local. O código de dispositivo é o padrão em SSH, Codespaces, dev containers e CI. O comando copilot login faz o mesmo fora da conversa, com as opções --web-flow e --device-code para forçar um dos fluxos.

O token do OAuth fica no chaveiro do sistema, sob o serviço copilot-cli. Quando o chaveiro não está disponível, como num servidor Linux sem o libsecret, o CLI oferece guardar o token em texto puro em ~/.copilot/config.json. Para pipelines e containers, a recomendação é outra: definir um token numa variável de ambiente, que o CLI usa sem perguntar nada.

  1. COPILOT_GITHUB_TOKEN

    Variável própria do CLI, a primeira consultada.

  2. GH_TOKEN

    Variável compartilhada com o GitHub CLI e outras ferramentas.

  3. GITHUB_TOKEN

    Variável injetada pelo GitHub Actions, consultada depois do GH_TOKEN.

  4. Chaveiro do sistema

    O token salvo pelo login OAuth no serviço copilot-cli.

  5. gh auth token

    O login do GitHub CLI, usado como último recurso.

A ordem de busca do token de acesso. O primeiro encontrado vence, então uma variável de ambiente esquecida passa por cima do login feito com copilot login.

A documentação faz um alerta sobre essa ordem: uma variável de ambiente sobrepõe em silêncio o token salvo. Com o GH_TOKEN definido para outra ferramenta, o Copilot CLI usa esse token no lugar do login que você fez. Vale remover as variáveis que você não pretende entregar ao CLI. Entre os tokens aceitos estão o OAuth, o token fine-grained com a permissão Copilot Requests e o token de usuário de GitHub App. O token clássico, com prefixo ghp_, não é aceito.

O CLI também aceita login pela Microsoft Entra, em prévia pública no Windows e no macOS desde a 1.0.113, para usuários corporativos gerenciados.

Escolher o modelo da sessão

O comando /model lista os modelos disponíveis e troca o modelo da sessão. A troca vale na hora, se o agente estiver parado, ou ao fim da resposta em andamento. Ela continua valendo quando você retoma a sessão. As outras sessões não mudam. A opção --model escolhe o modelo pela linha de comando. O /config model grava um modelo padrão para as sessões futuras. Configurações do projeto, políticas do administrador e opções explícitas podem passar por cima desse padrão.

Os modelos mais recentes aceitam uma janela de contexto de um milhão de tokens e níveis de raciocínio configuráveis. Depois de escolher um desses modelos, você decide entre o tamanho padrão e a janela estendida. A documentação recomenda o tamanho e o raciocínio normais no dia a dia e os maiores só em tarefas complexas, porque processam mais tokens.

Créditos consumidos por interação

Cada interação com o CLI, na conversa ou no modo programático, consome créditos de IA de acordo com os tokens processados. O consumo varia com o modelo usado. A tabela de modelos e preços fica na documentação de cobrança do GitHub. O teto de crédito de cada resposta, definido em --max-ai-credits ou no /limits, junto do comando /context, que mostra a ocupação da janela, dá a você uma noção do gasto de uma tarefa longa.

Um provedor de modelo próprio

O CLI também aceita um provedor de modelo seu no lugar dos modelos hospedados pelo GitHub. A configuração usa variáveis de ambiente: COPILOT_PROVIDER_BASE_URL com o endereço da API, COPILOT_PROVIDER_TYPE com openai, azure ou anthropic, COPILOT_PROVIDER_API_KEY com a chave, quando o provedor exige, além de COPILOT_MODEL com o modelo. O tipo openai atende qualquer endpoint compatível, inclusive o Ollama e o vLLM rodando localmente.

O modelo precisa aceitar chamadas de ferramenta e streaming, senão o CLI devolve erro. A documentação recomenda uma janela de pelo menos 128 mil tokens. O comando copilot help providers mostra os detalhes da configuração. A integração com os modelos da licença do Microsoft 365 Copilot aparece como prévia pública e mantém as sessões dos dois serviços separadas.

Sem login no GitHub, com recursos a menos

Com um provedor próprio, ou com um login da Microsoft Entra ligado ao GitHub Enterprise Managed Users, o CLI funciona sem autenticação no GitHub. Nessa configuração ficam de fora o /delegate, que depende do agente de nuvem do Copilot, o servidor MCP do GitHub e a busca de código do GitHub. A documentação sugere combinar as duas autenticações quando você quer o seu modelo e os recursos do GitHub na mesma sessão.

Com a variável COPILOT_OFFLINE igual a true, o CLI não contata os servidores do GitHub, não tenta autenticar e desliga a telemetria. As únicas requisições de rede vão para o provedor configurado. O isolamento só é completo quando esse provedor roda na mesma rede fechada, como um modelo instalado no seu próprio servidor. Os comandos e as operações de arquivo rodam na sua máquina, exceto numa sessão iniciada com --cloud, que trabalha num ambiente isolado hospedado pelo GitHub. O histórico das conversas também pode ficar guardado na sua máquina.

Continue na comunidade

Leve ao Discord da Promovaweb a mudança que o Copilot CLI propôs e o teste que ainda falha. A comparação das mudanças e a saída do comando mostram à comunidade o comportamento do seu projeto.