Usando GitHub Copilot CLI

A interface de linha de comando (CLI) para GitHub Copilot permite que você use Copilot diretamente do terminal. Para saber mais, confira Sobre o GitHub Copilot CLI.

Pré-requisito

Instale CLI do Copilot. Confira Instalando o CLI do GitHub Copilot.

Usando CLI do Copilot

1. No terminal, navegue até uma pasta que contém o código com o qual você deseja trabalhar.

2. Insira copilot para iniciar CLI do Copilot.

          Copilot solicitará que você confirme se confia nos arquivos nesta pasta.
   

   Importante

   Durante esta CLI do GitHub Copilot sessão, Copilot pode tentar ler, modificar e executar arquivos dentro e abaixo dessa pasta. Você só deve continuar se confiar nos arquivos neste local. Para obter mais informações sobre diretórios confiáveis, consulte Sobre o GitHub Copilot CLI.

3. Escolha uma das opções:

          **1. Sim, prossiga**:
   
   
          Copilot pode trabalhar com os arquivos neste local somente para esta sessão.
   
   
          **2. Sim, e lembre-se desta pasta nas sessões futuras**:
   

   Você confia nos arquivos desta pasta para esta sessão e futuras sessões. Você não será perguntado novamente quando começar CLI do Copilot da pasta. Escolha essa opção somente se tiver certeza de que ela sempre será segura para Copilot trabalhar com arquivos neste local.

          **3. Não, sair (Esc)**:
   

   Encerre sua sessão CLI do Copilot.

4. Se você não estiver conectado GitHubno momento, será solicitado que você use o /login comando de barra. Insira esse comando e siga as instruções na tela para autenticar.

5. Insira um prompt na CLI.

   Essa pode ser uma pergunta de chat simples ou uma solicitação para Copilot executar uma tarefa específica, como corrigir um bug, adicionar um recurso a um aplicativo existente ou criar um novo aplicativo.

   Para obter alguns exemplos de prompts, consulte Sobre o GitHub Copilot CLI.

6. Quando Copilot quiser usar uma ferramenta que possa modificar ou executar arquivos,por exemplo, touch, chmod, node ou sed ele solicitará que você aprove o uso da ferramenta.

   Escolha uma das opções:

          **1. Sim**:
   

   Permitir que Copilot use esta ferramenta. Na próxima vez Copilot que quiser usar essa ferramenta, ela solicitará que você aprove novamente.

          **2. Sim, e aprove a FERRAMENTA para o restante da sessão em execução**:
   

   Permita Copilot usar essa ferramenta, com qualquer opção, sem perguntar novamente, para o restante da sessão em execução no momento. Todas as solicitações de permissão paralela pendentes do mesmo tipo serão aprovadas automaticamente. Você precisará aprovar o comando novamente em sessões futuras.

   Escolher essa opção é útil para muitas ferramentas, como chmod, por exemplo, evita que você precise aprovar comandos semelhantes repetidamente na mesma sessão. No entanto, esteja ciente das implicações de segurança dessa opção. Por exemplo, escolher essa opção para o comando rm permitiria Copilot excluir qualquer arquivo no diretório atual ou seus subdiretórios sem solicitar sua aprovação.

          **3. Não, e diga a Copilot o que fazer diferente (Esc)**:
   
   
          Copilot não executará o comando. Em vez disso, ele encerrará a operação atual e aguardará seu próximo prompt. Você pode dizer Copilot para continuar a tarefa, mas usando uma abordagem diferente.
   

   Por exemplo, se você pedir Copilot para criar um script bash, mas não quiser usar o script Copilot sugerido, poderá interromper a operação atual e inserir um novo prompt, como: Continue the previous task but include usage instructions in the script.

   Ao rejeitar uma solicitação de permissão de ferramenta, você também pode fornecer Copilot comentários embutidos sobre a rejeição para que ela possa adaptar sua abordagem sem parar totalmente.

Dicas

Otimize sua experiência com CLI do Copilot usando as dicas a seguir.

Parar uma operação atualmente em execução

Se você inserir um prompt e decidir que deseja parar Copilot de concluir a tarefa enquanto ela ainda estiver "Pensando", pressione Esc.

Usar o modo de planejamento

O modo de planejamento permite que você colabore com Copilot em um plano de implementação antes de qualquer código ser escrito. Pressione Shift+Tab para entrar e sair do modo de plano.

Incluir um arquivo específico no prompt

Para adicionar um arquivo específico ao prompt, use @ seguido pelo caminho relativo para o arquivo. Por exemplo: Explain @config/ci/ci-required-checks.yml ou Fix the bug in @src/app.js. Isso adiciona o conteúdo do arquivo ao seu prompt como contexto para Copilot.

Quando você começa a digitar um caminho de arquivo, os caminhos correspondentes são exibidos abaixo da caixa de prompt. Use as teclas de direção para selecionar um caminho e pressione Tab para concluir o caminho no prompt.

Trabalhar com arquivos em um local diferente

Para concluir uma tarefa, Copilot talvez seja necessário trabalhar com arquivos que estão fora do diretório de trabalho atual. Se um prompt que você inseriu Copilot em uma sessão interativa exigir modificar um arquivo fora do local atual, ele solicitará que você aprove o acesso ao diretório do arquivo.

Você também pode adicionar um diretório confiável manualmente a qualquer momento usando o comando de barra:

/add-dir /path/to/directory

Se todos os arquivos com os quais você deseja trabalhar estiverem em um local diferente, você poderá alternar o diretório de trabalho atual sem iniciar uma nova CLI do Copilot sessão usando os comandos barra /cwd ou /cd.

/cwd /path/to/directory

Executar comandos de shell

Você pode preparar sua entrada ! para executar comandos de shell diretamente, sem fazer uma chamada para o modelo.

!git clone https://github.com/github/copilot-cli

Retomar uma sessão interativa

Você pode usar a opção de linha de comando --resume ou o comando de barra /resume para selecionar e retomar uma sessão interativa da Interface de Linha de Comando, permitindo continuar exatamente de onde você parou, com o contexto salvo. Você pode iniciar uma agente de codificação Copilot sessão em GitHub, e em seguida, usar CLI do GitHub Copilot para levar essa sessão para seu ambiente local.

copilot --continue

Use instruções personalizadas

Você pode aprimorar Copiloto desempenho adicionando instruções personalizadas ao repositório no qual você está trabalhando. Instruções personalizadas são descrições em idioma natural salvas em arquivos Markdown no repositório. Elas são incluídas automaticamente nos prompts inseridos durante o trabalho nesse repositório. Isso ajuda a Copilot a entender melhor o contexto do seu projeto e como responder às suas solicitações.

O CLI do Copilot oferece suporte a:

• Instruções em todo o repositório no arquivo .github/copilot-instructions.md.
• Arquivos de instruções específicas de caminho: .github/instructions/**/*.instructions.md.
• Arquivos de agente, como AGENTS.md.

Para saber mais, confira Using GitHub Copilot CLI.

Utilize agentes personalizados

A agente personalizado é uma versão especializada de Copilot. Agentes personalizados ajudar Copilot a lidar com workflows exclusivos, convenções específicas de codificação e casos de uso especializados.

          CLI do Copilot inclui um grupo padrão agentes personalizados para tarefas comuns:

O modelo de IA que está sendo usado pela CLI pode optar por delegar uma tarefa a um processo de subagente subsidiário, que opera usando um agente personalizado com experiência específica, se julgar que isso resultaria em uma conclusão mais eficaz do trabalho. O modelo pode igualmente escolher lidar com o trabalho diretamente no agente principal.

Você pode definir sua própria agentes personalizados usando arquivos Markdown, chamados perfis de agente, que especificam qual experiência o agente deve ter, quais ferramentas ele pode usar e quaisquer instruções específicas sobre como ele deve responder.

Você pode definir agentes personalizados no nível de usuário, repositório ou organização/empresa:

          `.github/agents` diretório em seus repositórios locais e remotos | Projeto atual |

| Organização e nível empresarial agente personalizado | /agents diretório no repositório .github-private em uma organização ou corporação | Todos os projetos sob sua organização e conta empresarial |

No caso de conflitos de nomenclatura, um agente no nível do sistema substitui um agente no nível do repositório e o agente no nível do repositório substituiria um agente no nível da organização.

          Agentes personalizados pode ser usado de três maneiras:

• Usando o comando de barra na interface interativa da CLI para selecionar na lista de disponíveis agentes personalizados:

  /agent
  

• Chamando agente personalizado diretamente em um prompt:

  Use the refactoring agent to refactor this code block
  

          Copilot inferirá automaticamente o agente que você deseja usar.
  

• Especificando a opção agente personalizado de linha de comando que você deseja usar. Por exemplo:

  copilot --agent=refactor-agent --prompt "Refactor this code block"
  

Para saber mais, confira Criando agentes personalizados para agente de codificação Copilot.

Utilizar habilidades

Você pode criar habilidades para aprimorar a capacidade de Copilot executar tarefas especializadas com instruções, scripts e recursos.

Para saber mais, confira Criando habilidades de agente para CLI do GitHub Copilot.

Adicionar um servidor MCP

          CLI do Copilot vem com o GitHub servidor MCP já configurado. Esse servidor MCP permite que você interaja com recursos em GitHub.com— por exemplo, permitindo mesclar solicitações de pull da CLI.

Para estender a funcionalidade disponível para você em CLI do Copilot, você pode adicionar mais servidores MCP:

1. Use o seguinte comando de barra:

   /mcp add
   

2. Preencha os detalhes do servidor de MCP que você deseja adicionar, usando a tecla Tab para mover-se entre os campos.

3. Pressione Ctrl+S para salvar os detalhes.

Os detalhes dos servidores de MCP configurados são armazenados no arquivo mcp-config.json, que está localizado, por padrão, no diretório ~/.copilot. Esse local pode ser alterado definindo a variável de ambiente COPILOT_HOME. Para obter informações sobre a estrutura JSON de uma definição de servidor, consulte Estendendo o agente de codificação do GitHub Copilot com o protocolo de contexto do modelo (MCP).

Gerenciamento de contexto

          CLI do Copilot fornece vários comandos de barra para ajudá-lo a monitorar e gerenciar sua janela de contexto:

* /usage: permite exibir suas estatísticas de sessão, incluindo:

• A quantidade de solicitações premium usadas na sessão atual

• A duração da sessão

• O total de linhas de código editadas

• Um detalhamento do uso de token por modelo

•         `/context`: fornece uma visão geral visual do uso atual de tokens.
  

•         `/compact`: compacta manualmente o histórico de conversas para liberar espaço de contexto
  
          CLI do GitHub Copilot compacta automaticamente seu histórico em segundo plano quando sua conversa se aproxima de 95% do limite de token, sem interromper o fluxo de trabalho.
  

Habilitar todas as permissões

Para situações em que você confia Copilot para ser executado livremente, você pode usar os sinalizadores --allow-all ou --yolo para habilitar todas as permissões de uma só vez.

Alternar a visibilidade do raciocínio

Pressione Ctrl+T para mostrar ou ocultar o processo de raciocínio do modelo enquanto ele gera uma resposta. Essa configuração persiste entre sessões, permitindo que você observe como Copilot funciona por meio de problemas complexos.

Saiba mais

Para obter uma lista completa das opções de linha de comando e comandos de barra com CLI do Copilotos quais você pode usar, siga um destes procedimentos:

• Insira ? na caixa de prompt em uma sessão interativa.
• Insira copilot help no terminal.

Para obter informações adicionais, use um dos seguintes comandos em seu terminal:

•         **Definições da configuração**:
  

  copilot help config

  Você pode ajustar as definições de configuração editando o arquivo config.json, que está localizado, por padrão, no diretório ~/.copilot. Esse local pode ser alterado definindo a variável de ambiente COPILOT_HOME.

•         **Variáveis de ambiente** que afetam CLI do Copilot:
  

  copilot help environment

•         **Níveis de log disponíveis**:
  

  copilot help logging

•         **Permissões** para permitir ou negar o uso da ferramenta:
  

  copilot help permissions

Comentários

Se você tiver algum comentário sobre a CLI do GitHub Copilot, informe-nos usando o comando de barra /feedback em uma sessão interativa e escolhendo uma das opções. Você pode preencher uma pesquisa de comentários privada, enviar um relatório de bugs ou sugerir um novo recurso.

Próximas etapas

          CLI do Copilot pode operar como um assistente de conversação, respondendo perguntas e ajudando você a escrever código interativamente. Além do chat, CLI do Copilot dá suporte a uma variedade de modos agente que permitem delegar tarefas com maior autonomia.

Você pode trabalhar com agentes CLI do Copilot para dar suporte a um ciclo de vida completo de uma tarefa, desde delegar trabalho à revisão de resultados:

•         **Delegar tarefas de forma autônoma**: execute CLI do Copilot no modo piloto automático para concluir tarefas de várias etapas sem exigir aprovação em cada etapa. Confira [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/delegate-tasks-to-cca).
  

•         **Invocar agentes personalizados**: invoque agentes especializados adaptados a tarefas específicas, como revisão de código, documentação ou auditorias de segurança. Confira [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/invoke-custom-agents).
  

•         **Orientar agentes**: guiar e refinar o comportamento do agente durante a execução da tarefa para manter o trabalho no rumo certo. Consulte [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/steer-agents).
  

•         **Solicite uma revisão de código**: use CLI do Copilot para obter uma revisão da IA de suas alterações de código. Confira [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/agentic-code-review).
  

Leitura adicional

•         [AUTOTITLE](/copilot/how-tos/copilot-cli/cli-best-practices)
  

•         [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference)
  

•         [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-config-dir-reference)
  

•         [AUTOTITLE](/copilot/reference/copilot-cli-reference/acp-server)