Conectando CLI do GitHub Copilot a VS Code

Conecte CLI do Copilot a VS Code para compartilhar o contexto, as configurações de confiança e a saída.

Neste artigo

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 workspace 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 CLI do Copilot se conectar com êxito com 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.

Observação

Se você estiver usando GitHub Codespaces, uma sessão da CLI em execução localmente não poderá se conectar a um VS Code workspace em execução no codespace remoto. No entanto, você pode se conectar quando usa a CLI dentro do codespace, isto é, dentro VS Code do terminal interno ou em uma sessão SSH no host do codespace remoto.

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 workspace ao qual você deseja se conectar deve estar aberto no modo confiável.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:

  • 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.
  • Abra edições de diferenças de arquivo no IDE — controla se as alterações de arquivo propostas são mostradas como diferenças em uma VS Code guia do editor.

Usando VS Code o contexto 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 na linha de comando da 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

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

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.

Observação

  • A exibição de diferenciação não será mostrada se você tiver permitido Copilot a edição de arquivos sem sua aprovação, por exemplo, usando as --allow-all opções de linha de comando ou os --yolo ou /allow-all comandos de barra /yolo. Em vez disso, as alterações propostas são aplicadas diretamente ao arquivo no workspace sem mostrar diferenças, e o comando continua imediatamente com o conteúdo do arquivo atualizado.
  • Se você preferir não usar a visualização de diferenças no VS Code, poderá desativar esse recurso no menu /ide. Quando você desativa isso, as alterações de arquivo propostas são exibidas na CLI.

Exibindo e retomando sessões da CLI em VS Code

Você pode ler a transcrição de qualquer CLI do Copilot da sessão para o espaço de trabalho atual a partir de 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 Sessões exibe suas sessões mais recentes Copilot, 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 foi exibido no modo de exibição Sessões, um ícone de ponto e uma contagem não lida serão mostrados ao lado do ícone de Chat na VS Code barra de título. 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.

Captura de tela do indicador de sessões não lidas em VS Code.

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