Skip to main content

Como instalar a CLI do GitHub Copilot

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

Quem pode usar esse recurso?

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

Observação

CLI do GitHub Copilot está em visualização pública com proteção de dados e está sujeito a alterações.

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

Pré-requisitos

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

Se você tiver acesso ao GitHub Copilot por meio de sua organização ou empresa, não poderá usar a CLI do Copilot se o proprietário da organização ou o administrador corporativo tiver desabilitado nas configurações da organização ou empresa. Confira Gerenciar políticas e recursos do GitHub Copilot na sua organização.

Como instalar ou atualizar a 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 do GitHub.com

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

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

Autenticando com CLI do Copilot

Na primeira inicialização, se você não estiver conectado ao GitHub, será solicitado que você use o /login comando de barra. Insira esse comando e siga as instruções na tela para autenticar.

Autenticar com um personal access token

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

  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. Adicione o token ao seu ambiente usando a variável de ambiente GH_TOKEN ou GITHUB_TOKEN (em ordem de precedência).

Próximas etapas

Agora você pode usar o Copilot na linha de comando. Confira Como usar a CLI do GitHub Copilot.