GitHub Copilot CLI: Instalação e Padrões de Uso Diário

O GitHub Copilot CLI é uma ferramenta de linha de comando que traz sugestões com IA diretamente para o seu terminal. Em vez de alternar para o navegador ou IDE, você pode pedir ao Copilot para explicar comandos, gerar one-liners shell ou criar fluxos de trabalho Git. Este artigo cobre o processo de instalação para Windows e macOS e descreve os padrões de uso diário que economizam mais tempo. Você aprenderá a autenticar, usar os três subcomandos principais e evitar armadilhas comuns de configuração.

O que o GitHub Copilot CLI Faz e Por Que Você Precisa Dele

O GitHub Copilot CLI é uma extensão baseada em Node.js da ferramenta GitHub CLI. Ele é executado dentro do seu terminal e interpreta prompts em português claro para gerar comandos shell, comandos Git ou explicações de comandos existentes. Ele não substitui o plugin Copilot da IDE; em vez disso, preenche a lacuna quando você está trabalhando fora de um editor, por exemplo, ao depurar um servidor ou gerenciar um repositório Git pela linha de comando.

A ferramenta requer uma assinatura ativa do GitHub Copilot. Tanto o Copilot Individual quanto o Copilot Business incluem acesso. Você também precisa ter o GitHub CLI gh instalado e autenticado. O CLI usa o mesmo modelo que alimenta o Copilot no VS Code, então a qualidade das sugestões é comparável.

Quando Usar o Copilot CLI vs Copilot na IDE

Use o Copilot CLI quando você já estiver no terminal e precisar de um comando rápido, como encontrar todos os arquivos modificados na última semana ou fazer rebase de um branch. Use o plugin da IDE quando estiver escrevendo código dentro de um arquivo. As duas ferramentas se complementam, e muitos desenvolvedores executam ambas simultaneamente.

Passos para Instalar o GitHub Copilot CLI no Windows e macOS

1. Instale o Node.js 18 ou superior
   Baixe a versão LTS de nodejs.org. No Windows, use o instalador .msi. No macOS, use o instalador .pkg ou Homebrew com brew install node. Verifique com node --version e npm --version.
2. Instale o GitHub CLI (gh)
   No Windows, baixe o .msi de cli.github.com. No macOS, execute brew install gh. Verifique com gh --version.
3. Autentique o gh com sua conta do GitHub
   Execute gh auth login e siga as instruções. Selecione HTTPS como protocolo e escolha autenticar via navegador ou token. Sua conta deve ter uma assinatura ativa do Copilot.
4. Instale a extensão Copilot CLI
   Execute npm install -g @githubnext/github-copilot-cli. No macOS ou Linux, talvez seja necessário usar sudo antes do comando. No Windows, execute o terminal como Administrador se encontrar erros de permissão.
5. Verifique a instalação
   Execute gh copilot --version. Se a versão for exibida, a instalação está completa. Se você vir um erro, certifique-se de que o Node.js e o gh estão no seu PATH.

Configuração Pós-Instalação

Após instalar, você pode criar aliases de shell para acesso mais rápido. Adicione o seguinte ao seu arquivo de perfil do shell (~/.bashrc, ~/.zshrc ou ~/.config/fish/config.fish):

alias '??'='gh copilot suggest'
alias 'git?'='gh copilot suggest -t git'
alias '???'='gh copilot explain'

Reinicie o terminal ou recarregue o arquivo com source ~/.zshrc. Esses aliases permitem digitar ?? para sugestões de shell, git? para sugestões Git e ??? para explicações.

Padrões de Uso Diário para o Copilot CLI

A ferramenta tem três subcomandos principais. Cada um atende a um fluxo de trabalho diário diferente. Os padrões a seguir mostram como usá-los de forma eficiente.

Padrão 1: Explicando Comandos com ???

Quando você encontrar um comando complexo em um script ou no terminal de um colega, digite ??? seguido do comando. Por exemplo:

??? find . -type f -name "log" -exec rm {} \;

O Copilot retorna uma explicação em português claro do que cada parte faz. Esse padrão é útil durante revisões de código ou ao aprender nova sintaxe de shell.

Padrão 2: Gerando Comandos Shell com ??

Para gerar um comando shell, digite ?? e descreva o que você deseja. Por exemplo:

?? listar todos os arquivos modificados nos últimos 7 dias

O Copilot sugere um ou mais comandos. Revise a saída e pressione Enter para executar o comando selecionado ou Escape para cancelar. Esse padrão economiza tempo quando você não se lembra das flags exatas.

Padrão 3: Gerando Comandos Git com git?

Para tarefas específicas do Git, use o alias git?. Por exemplo:

git? squash os últimos 3 commits em um só

O Copilot retorna o comando git rebase exato com as flags apropriadas. Esse padrão é especialmente útil para operações menos frequentes, como rebase interativo ou cherry-pick.

Erros Comuns, Limitações e Coisas a Evitar

Copilot CLI Não Retorna Sugestões

Se você digitar um prompt e não obtiver saída, verifique sua autenticação. Execute gh auth status para confirmar que você está logado. Verifique também se sua assinatura do Copilot está ativa visitando github.com/settings/copilot. Se você usa uma conta gerenciada pela empresa, seu administrador pode ter desabilitado o acesso via CLI.

Sugestões Imprecisas ou Perigosas

O Copilot CLI pode sugerir comandos que excluem arquivos ou modificam configurações do sistema. Sempre revise o comando sugerido antes de pressionar Enter. A ferramenta mostra um aviso para comandos destrutivos, mas você ainda deve ler a saída com cuidado. Nunca direcione a saída diretamente para sudo sem inspeção.

Aliases Não Funcionam Após Reiniciar o Terminal

Se o alias ?? parar de funcionar após fechar o terminal, certifique-se de que você adicionou o alias ao arquivo de perfil correto. No macOS com zsh, use ~/.zshrc. No Windows com PowerShell, crie uma função em vez de um alias. Para PowerShell, adicione isto ao seu perfil:

function ?? { gh copilot suggest @args }
function git? { gh copilot suggest -t git @args }
function ??? { gh copilot explain @args }

Execute notepad $PROFILE para abrir o arquivo de perfil no Windows.

Copilot CLI Ignora Contexto de Prompts Anteriores

Cada prompt é independente. A ferramenta não se lembra da sua pergunta anterior. Se precisar de uma continuação, você deve reafirmar o contexto. Por exemplo, não digite ?? agora mostre apenas os 10 primeiros após um prompt anterior. Em vez disso, digite ?? listar os 10 primeiros arquivos do resultado anterior.

GitHub Copilot CLI vs GitHub Copilot no VS Code: Principais Diferenças

Item	GitHub Copilot CLI	GitHub Copilot no VS Code
Ambiente	Terminal (shell, Git)	Editor de código (IDE)
Método de entrada	Prompts em linguagem natural digitados no terminal	Comentários de código inline e código parcial
Tipo de saída	Comandos shell, comandos Git, explicações	Completions de código, corpos de função, docstrings
Consciência de contexto	Sem memória entre prompts	Usa o arquivo aberto e o código ao redor como contexto
Instalação	Requer Node.js, npm e gh CLI	Extensão integrada do VS Code
Melhor para	Tarefas rápidas no terminal, operações Git, aprender comandos	Escrever e editar arquivos de código

As duas ferramentas atendem a casos de uso diferentes. Muitos desenvolvedores usam ambas: Copilot CLI para fluxos de trabalho no terminal e Copilot no VS Code para escrever código.

Agora você pode instalar o GitHub Copilot CLI e usar os três subcomandos principais para acelerar seu trabalho no terminal. Comece executando ??? para explicar um comando que você encontrar hoje. Para uso avançado, tente encadear o subcomando git? com uma flag --target para limitar as sugestões a um branch remoto específico do Git.