Modelos, login e acesso ao GitHub Copilot CLI
VPS 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.
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
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.
COPILOT_GITHUB_TOKEN
Variável própria do CLI, a primeira consultada.
GH_TOKEN
Variável compartilhada com o GitHub CLI e outras ferramentas.
GITHUB_TOKEN
Variável injetada pelo GitHub Actions, consultada depois do GH_TOKEN.
Chaveiro do sistema
O token salvo pelo login OAuth no serviço copilot-cli.
gh auth token
O login do GitHub CLI, usado como último recurso.
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.