# Instalando a CLI do GitHub Copilot

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

Para saber mais sobre Copilot CLI antes de instalá-lo, consulte [Sobre GitHub Copilot CLI](/pt/copilot/concepts/agents/copilot-cli/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 Copilot CLI 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/how-tos/administer-copilot/manage-for-organization/manage-policies).

## Instalar ou atualizar Copilot CLI

Você pode instalar Copilot CLI 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 or later.

```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 --cask copilot-cli
```

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

```shell copy
brew install --cask 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 Copilot CLI

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 **Proprietário do recurso**, selecione sua **conta pessoal**. Não selecione uma organização. A permissão **Copilot Solicitações** só está disponível em fine-grained personal access tokens de propriedade do usuário.
3. Em **Acesso ao Repositório**, selecione o nível de acesso apropriado para seu caso de uso:
   * **Repositórios públicos** se você precisar trabalhar apenas com repositórios públicos.
   * **Todos os repositórios** se você precisar de acesso em todos os seus repositórios atuais e futuros.
   * **Selecione apenas repositórios** se quiser restringir o acesso a repositórios específicos.
4. Em **Permissões**, selecione a guia **Conta** .
5. Clique em **Adicionar permissões** e selecione **Copilot Solicitações**.
6. Clique em **Gerar token**.
7. 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/copilot-cli/use-copilot-cli/overview).

Para obter uma lista de comandos para Copilot CLI, incluindo o comando a ser atualizado, consulte [referência de comando da CLI GitHub Copilot](/pt/copilot/reference/copilot-cli-reference/cli-command-reference).