Conectando CLI do GitHub Copilot a VS Code

Conectar CLI do Copilot a VS Code oferece o melhor de ambos os ambientes: a velocidade e a flexibilidade de um fluxo de trabalho baseado em terminal, combinadas às ferramentas visuais avançadas do seu editor. Com uma conexão estabelecida, você pode:

•         **Use a seleção do editor como contexto** – selecione o código em VS Code e referencie-os diretamente em prompts da CLI, sem a necessidade de especificar caminhos de arquivo ou números de linha.
  

•         **Revisar as mudanças propostas como comparações** — Quando Copilot sugere edições de arquivo, elas aparecem como uma comparação lado a lado em VS Code para que você possa revisar, aceitar ou rejeitar cada alteração visualmente.
  

•         **Diagnóstico ao vivo do Surface** — Copilot pode acessar erros e avisos em tempo real de VS Code, para que ele possa encontrar e corrigir problemas que seu editor já detectou.
  

•         **Recuperar sessões entre ferramentas** — Exibir transcrições de sessão da CLI no VS Code e retomá-las no terminal integrado sem perder o contexto.
  

Conectando-se ao VS Code

CLI do Copilot pode se conectar automaticamente ao VS Code ao iniciar uma sessão de CLI. Além disso, durante uma sessão interativa, você pode optar por se conectar a qualquer espaço de trabalho que esteja aberto no VS Code no computador local.

Conexão automática na inicialização

Quando você inicia CLI do Copilot, ele verifica se o diretório de trabalho atual do qual você iniciou a CLI corresponde a qualquer pasta de workspace que você abriu em VS Code no modo confiável. Se houver uma correspondência, a linha de comando (CLI) se conectará à instância VS Code relevante. A conexão ocorre independentemente de onde você esteja usando CLI do Copilot: em um terminal interno em VS Codeou em um aplicativo de terminal externo em execução em uma janela separada.

Caso CLI do Copilot se conecte com êxito ao VS Code, a mensagem de ambiente exibida na inicialização incluirá "Visual Studio Code conectado" ou "Visual Studio Code – Insiders conectado".

Se você tiver o mesmo workspace aberto em mais de uma janela VS Code , a CLI se conectará a um deles automaticamente. Ele não pode se conectar a várias instâncias do IDE ao mesmo tempo. Se preferir se conectar a uma instância diferente do VS Code, você poderá alternar usando o /ide comando.

Conexão manual durante uma sessão interativa

Se você abrir um workspace no VS Code depois de iniciar o CLI do Copilot, ou se você iniciou a CLI de um diretório que não corresponde a nenhum workspace aberto, você pode usar o comando de barra /ide para se conectar manualmente a um workspace no VS Code. O espaço de trabalho ao qual você deseja se conectar deve estar atualmente aberto no modo confiável no VS Code.

Gerenciando a conexão com o comando de barra /ide

Use o /ide comando de barra em uma sessão interativa CLI do Copilot para fazer o seguinte:

•         **Exiba** o status da conexão atual, por exemplo, se você quiser verificar qual workspace está conectado no momento.
  

•         **Conecte-se** a um workspace VS Code diferente.
  

•         **Desconecte** de VS Code.
  

Você também pode alternar as seguintes configurações no /ide menu:

•         **Conectar-se automaticamente ao workspace do IDE correspondente** – controla se a CLI se conecta automaticamente a um workspace VS Code correspondente na inicialização.
  

•         **Abra as diferenças nas edições de arquivo no IDE** — controla se as alterações de arquivo propostas são mostradas como diferenças em uma guia do editor VS Code.
  

Usando o contexto de VS Code em prompts

Quando CLI do Copilot estiver conectado ao VS Code, ele receberá sua seleção de editor atual sempre que a seleção for alterada. A seleção é exibida na linha de comando da CLI, alinhada à direita. Esse indicador de seleção é atualizado sempre que você seleciona um código diferente em VS Code.

Isso permite que você selecione algum código em VS Code e, em seguida, use um prompt como por exemplo:

Debug this

Como alternativa, você pode selecionar algum código, mas perguntar Copilot sobre todo o arquivo:

Explain this file

Revisão de alterações de arquivo como difusões

Quando você solicita ao Copilot para fazer alterações em um arquivo no espaço de trabalho, o VS Code exibe as alterações propostas como um 'diff' em uma nova guia do editor. Isso facilita a visualização exata do que o Copilot está propondo. Use os botões aceitar (✓) ou rejeitar (✗) no canto superior direito da exibição diff para aplicar ou descartar as alterações. Depois de aceitar ou rejeitar a diferença, a permissão pendente de edição de arquivo será resolvida e a CLI continuará seu fluxo de trabalho.

Exibindo e retomando sessões da CLI em VS Code

Você pode ler a transcrição de qualquer sessão de CLI do Copilot para o workspace atual diretamente no VS Code.

1. Abra o painel lateral Copilot Chat em VS Code.

2. Clique no ícone Sessões () no canto superior direito do painel de chat para exibir a visualização Sessões.

   A visão de Sessões lista suas sessões Copilot mais recentes, com as mais recentes na parte superior.

3. Clique em uma sessão para ler o texto completo de entrada e saída. Para sessões da CLI, a transcrição é idêntica ao que foi exibido no terminal durante essa sessão.

Se você tiver executado uma sessão da CLI para o workspace atual que ainda não viu na visualização de Sessões, um ícone de ponto e uma contagem de não lida serão mostrados ao lado do ícone de Chat na barra de título VS Code. Clique para alternar a lista filtrada de sessões não lidas. Clique nele novamente para limpar o filtro e exibir todas as sessões.

Para continuar uma sessão da CLI no terminal integrado do VS Code, clique com o botão direito do mouse na sessão na visualização de Sessões e escolha Retomar no Terminal. Essa é uma maneira rápida de retomar o trabalho em um terminal externo sem perder o contexto de sessão.

Leitura adicional

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