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.
npm install -g @github/copilot
npm install -g @github/copilot
Observação
Se você tiver ignore-scripts=true no ~/.npmrc arquivo, deverá usar o comando:
npm_config_ignore_scripts=false npm install -g @github/copilot
npm_config_ignore_scripts=false npm install -g @github/copilot
Para instalar a versão de pré-lançamento:
npm install -g @github/copilot@prerelease
npm install -g @github/copilot@prerelease
Instalando com o WinGet (Windows)
winget install GitHub.Copilot
winget install GitHub.Copilot
Para instalar a versão de pré-lançamento:
winget install GitHub.Copilot.Prerelease
winget install GitHub.Copilot.Prerelease
Instalando com o Homebrew (macOS e Linux)
brew install copilot-cli
brew install copilot-cli
Para instalar a versão de pré-lançamento:
brew install copilot-cli@prerelease
brew install copilot-cli@prerelease
Instalando com o script de instalação (macOS e Linux)
curl -fsSL https://gh.io/copilot-install | bash
curl -fsSL https://gh.io/copilot-install | bash
Ou:
wget -qO- https://gh.io/copilot-install | bash
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:
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash
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.
- Visite Fine-grained personal access tokens.
- Em "Permissões", clique em Adicionar permissões e selecione Copilot Solicitações.
- Clique em Gerar token.
- Adicione o token ao seu ambiente usando a variável de ambiente
GH_TOKENouGITHUB_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.