# Introdução à CLI do GitHub Copilot

Saiba rapidamente como usar CLI do GitHub Copilot.

## Introdução

```
          CLI do GitHub Copilot é um poderoso assistente de codificação de IA nativo do terminal que traz capacidades agenciais diretamente para sua linha de comando. Oferece CLI do Copilot flexibilidade profunda, GitHub integração de fluxo de trabalho e a capacidade de trabalhar de forma autônoma em tarefas complexas, mantendo o controle total do usuário.
```

Este guia ajudará você a começar a usar a CLI.

## Installation

Use um destes comandos:

* **Plataforma cruzada (npm)**

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

  ```bash copy
  npm install -g @github/copilot
  ```

* **Windows (WinGet)**

  ```bash copy
  winget install GitHub.Copilot
  ```

* **macOS/Linux (Homebrew)**

  ```bash copy
  brew install copilot-cli
  ```

## Iniciando a CLI pela primeira vez

1. No terminal, navegue até o diretório do projeto onde você deseja usar CLI do Copilot.

2. Inicie uma sessão interativa da CLI:

   ```bash
   copilot
   ```

3. Na interface da CLI, insira `/login` e siga os prompts na tela para autenticar com sua GitHub conta.

   Você só terá que fazer isso na primeira vez que usar CLI.

4. Quando solicitado, confirme se você confia que os arquivos no diretório atual são adequados para uso com uma ferramenta de IA.

   > \[!NOTE]

   ```
          Copilot não fará alterações em seus arquivos sem sua aprovação explícita.
   ```

5. Tente fazer uma pergunta a Copilot, por exemplo:

   ```copilot copy
   Give me an overview of this project.
   ```

## Atalhos principais para dominar

| Shortcut                     | Ação                                                     |
| ---------------------------- | -------------------------------------------------------- |
| <kbd>Esc</kbd>               | Cancelar a operação atual                                |
| <kbd>Ctrl</kbd>+<kbd>C</kbd> | Cancelar se estiver pensando em limpar a entrada ou sair |
| <kbd>Ctrl</kbd>+<kbd>L</kbd> | Limpar a tela                                            |
| `@`                          | Mencionar arquivos a serem incluídos no contexto         |
| `/`                          | Mostrar comandos de barra                                |
| `?`                          | Mostrar ajuda em formato de abas                         |
| <kbd>↑</kbd> e <kbd>↓</kbd>  | Navegar pelo histórico de comandos                       |

Para obter uma lista completa de atalhos e comandos disponíveis, insira:

```bash
/help
```

## Usando CLI do GitHub Copilot de forma não interativa

Você também pode inserir um comando em seu terminal e obter uma resposta diretamente de Copilot, sem iniciar uma sessão interativa.

Para fazer isso, passe um prompt para a CLI com o sinalizador `-p`. Por exemplo:

```bash
copilot -p "In Git, how can I apply a commit from another branch"
```

O `-p` sinalizador permite que você use CLI do GitHub Copilot programaticamente em scripts, por exemplo, para automatizar tarefas usando IA.

Você pode adicionar o sinalizador `-s` para informar à CLI que deve gerar apenas a resposta de Copilot, omitindo as informações de uso adicionais.

```bash
copilot -sp "YOUR PROMPT HERE"
```

Para obter detalhes de outros sinalizadores que você pode usar programaticamente e obter mais informações, digite:

```bash
copilot help
```

or:

```bash
copilot help TOPIC
```

onde TOPIC é um dos tópicos listados na saída da ajuda.

## Próximas etapas

Saiba mais sobre CLI do Copilot:

* [Sobre GitHub Copilot CLI](/pt/copilot/concepts/agents/about-copilot-cli)
* [Usando GitHub Copilot CLI](/pt/copilot/how-tos/use-copilot-agents/use-copilot-cli)
* [Práticas recomendadas para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/cli-best-practices)
* [Introdução a CLI do GitHub Copilot: um curso prático gratuito](https://developer.microsoft.com/blog/get-started-with-github-copilot-cli-a-free-hands-on-course)