# Introdução à CLI do GitHub Copilot

Saiba rapidamente como usar GitHub Copilot CLI.

## Introduction

GitHub Copilot CLI é um poderoso assistente de codificação de IA nativo do terminal que traz capacidades agenciais diretamente para sua linha de comando. Oferece Copilot CLI 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 or later.

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

* **Windows (WinGet)**

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

* **macOS/Linux (Homebrew)**

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

## Iniciando a CLI pela primeira vez

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

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ó precisará fazer isso na primeira vez que usar a 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.
   ```

   Se quiser, você pode falar seu prompt em vez de digitá-lo. Consulte [Usar entrada de voz com Copilot CLI](/pt/copilot/how-tos/copilot-cli/use-copilot-cli/voice-input).

## Atalhos principais para dominar

| Atalho                       | Ação                                                   |
| ---------------------------- | ------------------------------------------------------ |
| <kbd>Esc</kbd>               | Cancelar a operação atual                              |
| <kbd>Ctrl</kbd>+<kbd>C</kbd> | Cancelar se estiver pensando, 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 GitHub Copilot CLI 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 GitHub Copilot CLI 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 Copilot CLI:

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