Conectando CLI do GitHub Copilot a VS Code

A conexão CLI do CopilotVS Code oferece o melhor dos dois ambientes: a velocidade e a flexibilidade de um fluxo de trabalho baseado em terminal, combinado com as ferramentas visuais avançadas do editor. Com uma conexão estabelecida, você pode:

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

•         **Revise as alterações propostas como diffs** – quando Copilot sugere edições de arquivo, elas aparecem como diffs lado a lado no VS Code para que você possa revisar, aceitar ou rejeitar cada alteração visualmente.
  

•         **Diagnósticos em tempo real do Surface** — Copilot podem acessar erros e avisos em tempo real de VS Code, para que possam encontrar e corrigir problemas que o seu editor já detectou.
  

•         **Retomar sessões entre ferramentas** — exibir transcrições de sessões de CLI e retomá-las no terminal integrado sem perder o contexto.
  

Conectando-se a VS Code

          CLI do Copilot pode se conectar automaticamente ao VS Code quando você iniciar uma sessão da CLI. Além disso, durante uma sessão interativa, você pode optar por se conectar a qualquer espaço de trabalho que esteja atualmente aberto no VS Code na máquina 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 espaço de trabalho que você abriu em modo confiável do VS Code. Se houver uma correspondência, a CLI se conectará à instância relevante VS Code . A conexão ocorre independentemente de onde você estiver usando CLI do Copilot: em um terminal interno ou em VS Codeum aplicativo de terminal externo em execução em uma janela separada.

Se o CLI do Copilot se conectar com sucesso 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 VS Code janela, a CLI se conectará a uma delas 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 de VS Code, você poderá alternar usando o comando /ide.

Conexão manual durante uma sessão interativa

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

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

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

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

•         **Conecte-se** a um espaço de trabalho diferente VS Code.
  

•         **Desconectar** 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 correspondente VS Code na inicialização.
  

•           **Abrir diffs de edição de arquivos na IDE**: controla se as alterações de arquivos propostas são exibidas como diffs em uma guia do editor do VS Code.
  

Usando o contexto do VS Code em prompts.

Quando CLI do Copilot está conectado a VS Code, ele recebe a seleção atual do editor sempre que a seleção é alterada. A seleção é exibida abaixo do seu prompt na CLI, alinhada à direita. Esse indicador de seleção é atualizado sempre que você seleciona código diferente em VS Code.

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

Debug this

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

Explain this file

Revisando alterações de arquivos como diffs.

Quando você pede Copilot para fazer alterações em um arquivo na área de trabalho, VS Code exibe as alterações propostas como um diff em uma nova aba do editor. Isso facilita ver exatamente o que 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 do CLI do Copilot para o espaço de trabalho atual dentro do VS Code.

1. Abra a barra lateral do 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 visualização de sessões lista suas sessões mais recentes do Copilot, com a mais recente no topo.

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 espaço de trabalho atual que ainda não foi exibida na visualização Sessões, um ícone de ponto e uma contagem de não lidas serão exibidos ao lado do ícone de Chat na barra de título do 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 VS Codeterminal integrado, clique com o botão direito do mouse na sessão no modo de exibição 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)