Instalando a CLI do GitHub Copilot

Saiba como instalar CLI do Copilot para que você possa usar Copilot diretamente da linha de comando.

Quem pode usar esse recurso?

CLI do GitHub Copilot está disponível com todos os Copilot planos. Se você receber Copilot de uma organização, a CLI do Copilot política deverá ser habilitada nas configurações da organização.

Neste artigo

Para saber mais sobre CLI do Copilot antes de instalá-lo, consulte Sobre GitHub Copilot CLI.

Pré-requisitos

  •         **Uma assinatura ativaGitHub Copilot**. Veja [Copilot os planos](https://github.com/features/copilot/plans?ref_product=copilot&ref_type=engagement&ref_style=text).
  • (No Windows) PowerShell v6 ou superior

Se você tiver acesso a GitHub Copilot através da sua organização ou empresa, não poderá usar CLI do Copilot se o proprietário da sua organização ou o administrador empresarial o tiver desabilitado nas configurações da organização ou da empresa. Consulte Gerenciando políticas e recursos para GitHub Copilot em sua organização.

Instalar ou atualizar CLI do Copilot

Você pode instalar CLI do Copilot usando WinGet (Windows), Homebrew (macOS e Linux), npm (todas as plataformas) ou um script de instalação (macOS e Linux).

Instalando com o npm (todas as plataformas)

Pré-requisito: Node.js 22 ou mais recente.

Shell
npm install -g @github/copilot

Observação

Se você tiver ignore-scripts=true no ~/.npmrc arquivo, deverá usar o comando:

Shell
npm_config_ignore_scripts=false npm install -g @github/copilot

Para instalar a versão de pré-lançamento:

Shell
npm install -g @github/copilot@prerelease

Instalando com o WinGet (Windows)

PowerShell
winget install GitHub.Copilot

Para instalar a versão de pré-lançamento:

PowerShell
winget install GitHub.Copilot.Prerelease

Instalando com o Homebrew (macOS e Linux)

Shell
brew install copilot-cli

Para instalar a versão de pré-lançamento:

Shell
brew install copilot-cli@prerelease

Instalando com o script de instalação (macOS e Linux)

Shell
curl -fsSL https://gh.io/copilot-install | bash

Ou:

Shell
wget -qO- https://gh.io/copilot-install | bash

Para executar como root e instalar para /usr/local/bin, use | sudo bash.

Para instalar em um diretório personalizado, defina a variável de PREFIX ambiente. Tem como padrão /usr/local quando executado como root ou $HOME/.local quando executado como um usuário não root.

Para instalar uma versão específica, defina a variável de VERSION ambiente. Ele usa como padrão a versão mais recente.

Por exemplo, para instalar a versão v0.0.369 em um diretório personalizado:

Shell
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash

Baixar de GitHub.com

Você pode baixar os executáveis diretamente do o copilot-cli repositório.

Baixe o executável para sua plataforma, descompacte-o e execute.

Autenticação com CLI do Copilot

Na primeira inicialização, se você não estiver conectado ao GitHubserá solicitado que você use o comando de barra /login. Insira esse comando e siga as instruções na tela para autenticar. Para obter mais informações sobre o processo de autenticação, consulte Autenticando GitHub Copilot CLI.

Autenticando com um personal access token

Você também pode autenticar usando um fine-grained personal access token com a permissão "Copilot Solicitações" permission habilitada.

  1. Visite Fine-grained personal access tokens.
  2. Em "Permissões", clique em Adicionar permissões e selecione Copilot Solicitações.
  3. Clique em Gerar token.
  4. 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).

Próximas etapas

Agora você pode usar Copilot na linha de comando. Consulte Usando GitHub Copilot CLI.