O que é o GitHub Copilot CLI?
O GitHub Copilot CLI é um agente de codificação com IA por linha de comando publicado pelo GitHub, descrito em sua própria página de produto. Ele roda dentro do seu terminal em vez de um editor, e pode ler seu repositório, propor alterações, executar comandos de shell que você aprovar, e responder perguntas sobre seu código por meio de uma interface no estilo de chat. Por padrão, cada uma dessas solicitações é processada por um modelo hospedado na infraestrutura do GitHub, acessado pela rede com suas credenciais do GitHub — a CLI não distribui nem executa pesos de modelo localmente.
- Função principal: um assistente de codificação agêntico que vive no terminal — lê arquivos do projeto, propõe e aplica alterações, e pode executar comandos com sua confirmação
- Inferência padrão: baseada em nuvem, via modelos próprios do GitHub, condicionada a um nível de assinatura do GitHub Copilot
- Caminho local opcional: a configuração BYOK (quatro variáveis de ambiente) pode redirecionar as chamadas de modelo para um servidor autogerenciado na sua própria máquina ou rede — Ollama, vLLM, Foundry Local, ou qualquer endpoint compatível
- Desenvolvedor: GitHub (uma subsidiária da Microsoft)
- Distribuição: o pacote npm
@github/copilot, também disponível via Homebrew e WinGet
Histórico do Copilot CLI
O GitHub Copilot CLI estende a linha de produtos Copilot do GitHub para o terminal, seguindo o mesmo modelo de conta e assinatura de suas integrações com editor e chat.
- 1O Copilot CLI é lançado como agente de codificação em terminal
Why it matters: O GitHub estendeu o Copilot além do editor com um agente independente de linha de comando, instalável via npm, Homebrew ou WinGet e autenticado com credenciais existentes do GitHub. - 2Suporte a BYOK e provedores de modelos personalizados é adicionado
Why it matters: O GitHub publicou documentação para conectar o Copilot CLI a servidores de modelos autogerenciados — Ollama, vLLM e Foundry Local — por meio de variáveis de ambiente, dando à CLI um caminho de inferência local opcional, separado de seus modelos em nuvem padrão, conforme a [documentação BYOK](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models) do GitHub. - 3AI Credits unificam a contabilização de uso em todas as superfícies do Copilot
Why it matters: O GitHub consolidou a contabilização de uso para que Copilot Chat, modo agente, revisão de código e Copilot CLI consumam todos da mesma cota mensal de AI Credits nos planos individuais pagos, em vez de medir o uso da CLI separadamente.
O que você pode fazer com o GitHub Copilot CLI?
O conjunto de recursos do Copilot CLI é centrado em codificação agêntica no terminal, conforme a documentação e a página de produto oficiais do GitHub.
- Chat agêntico em terminal — uma interface conversacional no seu terminal que pode ler arquivos, propor alterações em múltiplos arquivos e explicar código, iniciada com o comando
copilot - Execução de comandos com aprovação — o Copilot CLI pode sugerir e executar comandos de shell, mas pede confirmação antes de executar qualquer coisa que altere seu sistema ou repositório
- Consciência do repositório — lê os arquivos e a estrutura do seu projeto para basear suas respostas e alterações no seu código real, em vez de sugestões genéricas
- Modelos em nuvem por padrão — de fábrica, as solicitações são processadas pelos modelos próprios do GitHub, autenticadas via sua conta e nível de assinatura do GitHub
- BYOK / provedores de modelos personalizados — quatro variáveis de ambiente (
COPILOT_PROVIDER_BASE_URL,COPILOT_MODEL,COPILOT_PROVIDER_TYPE,COPILOT_PROVIDER_API_KEY) permitem redirecionar o Copilot CLI para outro backend de modelo, incluindo servidores locais autogerenciados - Provedores locais compatíveis — Ollama, vLLM e Foundry Local são citados explicitamente na documentação BYOK do GitHub, além de "qualquer endpoint compatível com OpenAI Chat Completions"
- Requisitos de modelo para BYOK — o modelo ao qual você conectar o Copilot CLI precisa ser compatível com chamadas de ferramentas e streaming; o GitHub recomenda uma janela de contexto de 128 mil tokens para um comportamento agêntico confiável
Exemplos de uso: três formas de usar o Copilot CLI
Estes são fluxos de trabalho concretos baseados na própria documentação do GitHub, não casos de uso hipotéticos.
Usar o Copilot CLI com seus modelos em nuvem padrão
Instale com npm install -g @github/copilot, execute copilot, e autentique-se com sua conta existente do GitHub. A partir daí, toda solicitação vai para os modelos hospedados pelo GitHub via rede — este é o comportamento padrão, e não exige configuração extra, apenas um nível de assinatura do GitHub Copilot que inclua acesso à CLI.
Conectar o Copilot CLI a um modelo Ollama local via BYOK
Inicie o Ollama e carregue um modelo compatível com chamadas de ferramentas e streaming (um modelo com contexto de 128 mil tokens é recomendado). Defina COPILOT_PROVIDER_BASE_URL para seu endpoint local do Ollama e COPILOT_MODEL para o nome do modelo; COPILOT_PROVIDER_API_KEY não é necessária para uma instância local do Ollama. Inicie copilot — as solicitações agora vão para seu servidor Ollama local em vez dos modelos em nuvem do GitHub.
Conectar o Copilot CLI a um servidor vLLM ou Foundry Local autogerenciado
Execute vLLM ou Foundry Local em seu próprio hardware ou rede, expondo um endpoint compatível com OpenAI. Defina COPILOT_PROVIDER_BASE_URL para esse endpoint e COPILOT_MODEL para o nome do modelo servido; defina COPILOT_PROVIDER_TYPE apenas se o endpoint não for compatível com OpenAI por padrão. Assim, a inferência permanece dentro da sua própria infraestrutura em vez da do GitHub.
Instalação e primeiros passos com o Copilot CLI
O Copilot CLI é instalado como um pacote de linha de comando, não como um aplicativo para download. Conforme a documentação do GitHub, instale-o com npm, Homebrew ou WinGet, e depois autentique-se com sua conta existente do GitHub.
Método | Comando / Notas |
|---|---|
| npm (todas as plataformas) | npm install -g @github/copilot |
| Homebrew (macOS/Linux) | Disponível via Homebrew — veja a documentação de instalação do GitHub para a fórmula exata |
| WinGet (Windows) | Disponível via WinGet — veja a documentação de instalação do GitHub para o ID exato do pacote |
| Iniciar | copilot (autentica com suas credenciais existentes do GitHub) |
Uma conta do GitHub é necessária de qualquer forma. Usar os modelos em nuvem padrão exige adicionalmente um nível de assinatura do GitHub Copilot que inclua acesso à CLI (o nível Free é suficiente, com uso limitado). Configurar o caminho local/BYOK exige adicionalmente que você mesmo execute o Ollama, vLLM ou Foundry Local — o Copilot CLI não instala nem gerencia um servidor de modelo local para você.
Preços do GitHub Copilot CLI
O acesso ao Copilot CLI depende de uma assinatura do GitHub Copilot, não é vendido separadamente. Os níveis abaixo refletem os planos individuais e empresariais publicados pelo GitHub; verifique os preços atuais em github.com/features/copilot/plans antes de decidir, já que os níveis e as cotas de créditos mudam.
Free
- Preço:
- US$ 0
- AI Credits / O que inclui:
- 2.000 completions de código e 50 solicitações de chat por mês; o acesso ao Copilot CLI está incluído, limitado por essas cotas
Pro
- Preço:
- US$ 10/mês
- AI Credits / O que inclui:
- US$ 15/mês em AI Credits, compartilhados entre Copilot Chat, modo agente, revisão de código e Copilot CLI
Pro+
- Preço:
- US$ 39/mês
- AI Credits / O que inclui:
- US$ 70/mês em AI Credits, compartilhados no mesmo conjunto de recursos
Max
- Preço:
- US$ 100/mês
- AI Credits / O que inclui:
- US$ 200/mês em AI Credits, compartilhados no mesmo conjunto de recursos
Business
- Preço:
- US$ 19/usuário/mês
- AI Credits / O que inclui:
- Plano para equipes; verifique a cota atual de AI Credits na página de preços do GitHub
Enterprise
- Preço:
- US$ 39/usuário/mês
- AI Credits / O que inclui:
- Plano para organizações; verifique a cota atual de AI Credits na página de preços do GitHub
AI Credits são um único pool compartilhado por plano individual pago — o uso intenso do Copilot CLI consome a mesma cota que Copilot Chat, modo agente e revisão de código, não um orçamento separado só para a CLI. O caminho BYOK/modelo local não consome nenhum AI Credit do GitHub, já que o GitHub não executa o modelo — mas você é responsável pelos custos de hospedagem que sua própria configuração de Ollama, vLLM ou Foundry Local exigir. Esses números eram precisos no momento da review; o GitHub já mudou os preços do Copilot antes e pode mudar novamente — verifique o link acima em vez de tratar esta tabela como permanente.
GitHub Copilot CLI vs. Aider
O GitHub Copilot CLI e o Aider são ambos agentes de codificação com IA em terminal, mas adotam padrões quase opostos sobre onde a inferência acontece e como você paga por ela.
Inferência padrão
- GitHub Copilot CLI:
- Nuvem, via modelos hospedados pelo GitHub
- Aider:
- Nuvem, via a chave de API que você configurar — ou totalmente local via Ollama e servidores similares
Caminho de modelo local
- GitHub Copilot CLI:
- Configuração BYOK opcional (quatro variáveis de ambiente) apontando para Ollama, vLLM ou Foundry Local
- Aider:
- Suporte nativo a modelos locais via Ollama e outros servidores compatíveis com OpenAI, sem necessidade de modo BYOK separado
Licença
- GitHub Copilot CLI:
- Proprietária, código fechado
- Aider:
- Código aberto (Apache-2.0); veja a review do Aider da PromptQuorum
Acesso / preços
- GitHub Copilot CLI:
- Condicionado a uma assinatura do GitHub Copilot, de Free a US$ 100/mês
- Aider:
- A ferramenta em si é gratuita; você só paga pela API ou pelo processamento local que usar
Integração com o GitHub
- GitHub Copilot CLI:
- Integração nativa e de primeira parte com conta e repositório do GitHub
- Aider:
- Funciona com qualquer repositório Git; não exige integração específica com o GitHub
Se um fluxo de trabalho totalmente local e capaz de funcionar offline é a prioridade, o Aider trata isso como padrão de primeira classe, em vez de uma etapa de configuração opcional — veja a review do Aider da PromptQuorum para sua configuração exata de modelos locais.
Para quem é o GitHub Copilot CLI?
Se o Copilot CLI se encaixa depende de você estar confortável com a inferência em nuvem por padrão, e de quanto esforço está disposto a dedicar ao caminho BYOK caso queira modelos locais.
Use o GitHub Copilot CLI se
- Seu código e fluxo de trabalho já vivem no GitHub e você quer um agente de terminal diretamente ligado a essa conta
- Você está confortável com inferência hospedada em nuvem por padrão e quer os próprios modelos do GitHub sem configuração extra
- Você precisa especificamente do caminho BYOK para se conectar a um servidor local Ollama, vLLM ou Foundry Local por motivos de conformidade ou uso offline, e está confortável em configurar as variáveis de ambiente você mesmo
- Você já paga por, ou se qualifica para o nível Free de, uma assinatura do GitHub Copilot e quer que o acesso à CLI esteja incluído nesse mesmo plano
Espere, ou procure outra opção, se
- Você quer uma ferramenta que trate inferência local e offline como padrão, em vez de uma etapa de configuração opcional — veja a comparação com o Aider acima
- Você quer o código-fonte do agente subjacente aberto para inspeção — o Copilot CLI é de código fechado
- Você precisa que o uso da CLI com modelos em nuvem fique totalmente fora da contabilização de AI Credits do GitHub — o Copilot CLI não tem um nível em nuvem separado do pool de créditos compartilhado
- Você não está disposto a executar e manter seu próprio servidor Ollama, vLLM ou Foundry Local — o Copilot CLI não gerencia um ambiente de execução de modelo local para você
Concorrentes e alternativas
O GitHub Copilot CLI está no mesmo segmento que vários outros agentes de codificação com IA em terminal. Esta review é o complemento aprofundado da entrada do GitHub Copilot CLI no Local LLM Software Directory — consulte essa página para o catálogo completo.
- Aider — um agente de codificação em terminal de código aberto com modelos locais como opção de primeira classe, não opcional; veja a review do Aider e a comparação direta acima.
- OpenCode — outro agente de codificação em terminal; veja a review do OpenCode da PromptQuorum.
- Shell-GPT — um assistente de IA de linha de comando mais leve; veja a review do Shell-GPT.
- Tabby — um assistente de codificação com IA autogerenciado, feito para rodar totalmente na sua própria infraestrutura; veja a review do Tabby.
Erros comuns ao avaliar o GitHub Copilot CLI
A maior parte da confusão sobre o Copilot CLI vem de misturar onde a interface roda com onde o modelo de IA roda, ou de mal-entendidos sobre como funcionam os AI Credits compartilhados e os requisitos de BYOK.
Erro 1: assumir que "roda em um terminal local" significa "executa inferência local"
A interface do Copilot CLI roda na sua máquina, mas por padrão o modelo em si roda nos servidores do GitHub, acessados pela rede. A inferência local só acontece se você configurar o caminho BYOK (quatro variáveis de ambiente) para apontar o Copilot CLI para um servidor que você mesmo executa, como o Ollama. Não descreva a configuração padrão como executando modelos de IA localmente — ela não executa, até que você a configure dessa forma.
Erro 2: esperar que o BYOK funcione com qualquer modelo
Um modelo ao qual você conecta o Copilot CLI via BYOK precisa ser compatível com chamadas de ferramentas e streaming; o GitHub recomenda uma janela de contexto de 128 mil tokens. Um modelo sem suporte a chamadas de ferramentas não funcionará corretamente com os recursos agênticos do Copilot CLI, mesmo que o endpoint em si se conecte com sucesso.
Erro 3: tratar o uso do Copilot CLI como ilimitado em um plano pago
Os níveis individuais pagos medem o Copilot CLI contra o mesmo pool mensal de AI Credits usado pelo Copilot Chat, modo agente e revisão de código. O uso intenso da CLI pode esgotar essa cota compartilhada mais rápido do que o esperado se você também estiver usando outros recursos do Copilot no mesmo período de faturamento.
Erro 4: assumir que o Copilot CLI exige uma assinatura paga
O nível Free do GitHub Copilot inclui acesso ao Copilot CLI, junto com 2.000 completions de código e 50 solicitações de chat por mês — um plano pago não é estritamente necessário para experimentar a CLI, apenas para elevar esses limites de uso.
Perguntas frequentes
O que é o GitHub Copilot CLI?
O GitHub Copilot CLI (github.com/features/copilot/cli) é o agente de codificação com IA por linha de comando do GitHub. Ele roda no seu terminal, lê seu repositório, e pode propor alterações e executar comandos que você aprovar, com uma interface no estilo de chat.
O GitHub Copilot CLI executa modelos de IA localmente por padrão?
Não. Por padrão, ele envia solicitações pela rede para os modelos hospedados pelo GitHub. Ele roda em um terminal local, mas isso não é o mesmo que executar inferência local.
O GitHub Copilot CLI pode usar modelos locais como o Ollama?
Sim, por meio de uma configuração BYOK (bring-your-own-key) definida com quatro variáveis de ambiente: COPILOT_PROVIDER_BASE_URL e COPILOT_MODEL (obrigatórias), além de COPILOT_PROVIDER_TYPE e COPILOT_PROVIDER_API_KEY (opcionais). O GitHub cita explicitamente Ollama, vLLM e Foundry Local como provedores locais compatíveis.
O GitHub Copilot CLI é gratuito?
O nível Free do GitHub Copilot (US$ 0) inclui acesso ao Copilot CLI, limitado a 2.000 completions de código e 50 solicitações de chat por mês. Os níveis pagos vão de Pro (US$ 10/mês) a Max (US$ 100/mês) para indivíduos, e de Business (US$ 19/usuário/mês) a Enterprise (US$ 39/usuário/mês) para equipes — verifique os preços atuais em github.com/features/copilot/plans.
Qual licença o GitHub Copilot CLI usa?
Proprietária e de código fechado. Não há repositório de código-fonte público, então nenhuma contagem de estrelas do GitHub se aplica a esta ferramenta.
Como instalo o GitHub Copilot CLI?
Execute npm install -g @github/copilot, ou instale via Homebrew ou WinGet, depois inicie com o comando copilot e autentique-se com sua conta existente do GitHub.
Quais provedores de modelos locais o GitHub Copilot CLI suporta?
Ollama, vLLM e Foundry Local são citados explicitamente na documentação BYOK do GitHub, além de qualquer endpoint compatível com OpenAI Chat Completions.
O que são AI Credits e como se aplicam ao Copilot CLI?
AI Credits são uma cota mensal de uso nos planos individuais pagos, compartilhada entre Copilot Chat, modo agente, revisão de código e Copilot CLI. Pro, Pro+ e Max incluem US$ 15, US$ 70 e US$ 200 por mês, respectivamente.
Quais são os requisitos para um modelo local em BYOK?
O modelo precisa ser compatível com chamadas de ferramentas e streaming; o GitHub recomenda uma janela de contexto de 128 mil tokens para um comportamento agêntico confiável.
Como o GitHub Copilot CLI se compara ao Aider?
O Aider trata modelos locais como uma opção nativa de primeira classe e é de código aberto; o Copilot CLI usa modelos em nuvem por padrão e exige uma configuração BYOK separada para uso local, além de ser de código fechado. Veja a comparação completa acima.