# Instalando a CLI do GitHub Copilot

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

Para saber mais sobre CLI do Copilot antes de instalá-lo, consulte [Sobre GitHub Copilot CLI](/pt/copilot/concepts/agents/about-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](/pt/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-policies-for-copilot-in-your-organization).

## 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 copy
npm install -g @github/copilot
```

> \[!NOTE]
> Se você tiver `ignore-scripts=true` no `~/.npmrc` arquivo, deverá usar o comando:
>
> ```shell copy
> npm_config_ignore_scripts=false npm install -g @github/copilot
> ```

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

```shell copy
npm install -g @github/copilot@prerelease
```

### Instalando com o WinGet (Windows)

```powershell copy
winget install GitHub.Copilot
```

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

```powershell copy
winget install GitHub.Copilot.Prerelease
```

### Instalando com o Homebrew (macOS e Linux)

```shell copy
brew install copilot-cli
```

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

```shell copy
brew install copilot-cli@prerelease
```

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

```shell copy
curl -fsSL https://gh.io/copilot-install | bash
```

Ou:

```shell copy
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 copy
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](https://github.com/github/copilot-cli/releases/).

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](/pt/copilot/how-tos/copilot-cli/set-up-copilot-cli/authenticate-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](https://github.com/settings/personal-access-tokens/new).
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](/pt/copilot/how-tos/use-copilot-agents/use-copilot-cli).