Agent Host no VS Code: como deixar o Copilot trabalhando com a janela fechada e controlá-lo pelo celular

Desde VS Code 1.144 (28 de outubro de 2026), Copilot no VS Code roda por padrão no Agent Host, um processo separado: fechar a janela não interrompe mais o agente, e você pode acompanhá-lo pelo GitHub Mobile.

É a mudança que o GitHub anunciou na Universe. Parece pequena, mas muda o dia a dia com agentes: você inicia um refatoramento longo, fecha o projeto, se afasta da mesa e continua acompanhando pelo telefone. Aqui vai o que é o Agent Host, o que realmente sobrevive quando você fecha as coisas, como acessar sua sessão de outro dispositivo e que concessões de segurança isso traz.

O que é o Agent Host do Copilot no VS Code?

O Agent Host é um processo dedicado, separado de qualquer janela do VS Code, que executa os harnesses dos agentes (Copilot, Claude e Codex) e é proprietário de suas sessões. Como a sessão vive fora da janela, a mesma sessão pode ser exibida em várias janelas ao mesmo tempo e continua rodando quando a janela que a iniciou desaparece.

Fala o Agent Host Protocol (AHP), que é aberto: VS Code, a janela de Agentes e qualquer cliente que você construir são simplesmente clientes da mesma sessão ao vivo.

O harness do Copilot dentro do Agent Host é construído sobre o Copilot SDK, o mesmo runtime que usam o Copilot CLI e o app do GitHub Copilot. O objetivo declarado do GitHub é que o agente se comporte igual nos três produtos. (Explicamos por que o SDK importa a nível estratégico em GitHub Copilot Já Não Quer Ser um Copilot.)

O Copilot no VS Code já usa o Agent Host por padrão?

Sim, nas sessões novas. O harness do Copilot é o padrão para sessões novas tanto no editor quanto na janela de Agentes, e roda através do Agent Host.

Você escolhe o harness no controle Session Target antes do seu primeiro prompt. As demais opções continuam lá:

Harness Onde roda Ao fechar a janela
Copilot Agent Host (Copilot SDK) A sessão continua rodando
Local Extension host do VS Code A sessão é interrompida
Claude Claude Agent SDK, integrado no VS Code —
Codex Extensão OpenAI Codex, ou a integração experimental com o Agent Host —

O harness Local é o comportamento anterior: a janela é proprietária da sessão, então fechá-la interrompe o trabalho.

A sessão continua rodando se eu fechar VS Code?

Se você fechar a janela, sim. Se você sair da aplicação, não, pelo menos nas sessões gerenciadas pelo VS Code de desktop em sua própria máquina. A documentação é explícita: fechar uma janela do editor não é a mesma coisa que sair da aplicação, e para as sessões locais do Agent Host você precisa manter o VS Code aberto.

Duas regras a mais que vale a pena conhecer:

  • Reconectar a uma sessão não significa que o trabalho tenha continuado enquanto o host estava parado ou a máquina desligada. Se o laptop entrou em suspensão, o agente também.
  • Desconectar um cliente não interrompe uma tarefa em andamento. Para parar o agente, use a ação de parada da sessão.

Se você precisa de um trabalho que sobreviva a fechar o laptop, esse é outro produto: as sessões na nuvem, que são iniciadas a partir da janela de Agentes, rodam na infraestrutura do GitHub e podem ser continuadas a partir do VS Code, do app do Copilot, do GitHub Mobile, do github.com ou do Copilot CLI.

Como controlar o Copilot pelo celular?

Você registra sua máquina como um GitHub Environment, e a partir de então qualquer cliente com a mesma conta do GitHub, incluindo o GitHub Mobile, pode ver e trabalhar com as sessões dessa máquina. No momento da publicação desta nota, o GitHub Environments está em Preview.

De acordo com a documentação do VS Code:

  1. Na máquina onde está seu workspace, abra Remote Connections a partir da barra de título da janela de Agentes ou da área de entrada do Chat view.
  2. Selecione GitHub Environments. Com isso começa a compartilhação. Complete os avisos de login ou confirmação que aparecerem.
  3. Se quiser, renomeie o environment para reconhecê-lo em outros dispositivos.

A funcionalidade é controlada pela configuração chat.agentHost.githubEnvironments.enabled.

O changelog do GitHub descreve uma rota por terminal para a mesma coisa: abra um terminal na máquina, entre na pasta do projeto e execute:

code agent host --github-environment

Para se conectar a partir de outro VS Code (ou outro cliente de desktop), faça login com a mesma conta do GitHub, execute Connect to Environment… a partir da Command Palette, escolha a máquina e selecione a sessão existente. Use Refresh Environments se ela não aparecer.

A partir do telefone, de acordo com o GitHub, você pode revisar o progresso, dar instruções ou iniciar novas tarefas na sua máquina de desenvolvimento. No momento da publicação desta nota, nem o GitHub nem a documentação do VS Code haviam publicado instruções passo a passo para o lado do GitHub Mobile, e a documentação deixa claro que as ações disponíveis variam conforme o cliente.

Para parar de compartilhar, abra Remote Connections no host e selecione Off.

A condição não muda nunca: a máquina e seu Agent Host precisam continuar rodando.

Como rodar o agente em outra máquina com VS Code Remote SSH ou um tunnel?

A janela de Agentes pode se conectar a um Agent Host na mesma máquina ou em um host por SSH, dev tunnel ou WSL. O agente usa então o código, as ferramentas e as dependências dessa máquina, e continua rodando mesmo que você se desconecte ou feche o VS Code localmente.

Por SSH

Selecione New (Ctrl+N no Windows/Linux, ⌘N no macOS), escolha SSH no dropdown de environments e digite uma string de conexão como user@hostname. O VS Code instala a CLI necessária na máquina remota quando necessário.

Com um vscode tunnel (dev tunnels)

Na máquina remota, execute code tunnel (ou code-insiders tunnel) e autentique-se da primeira vez. Depois selecione New, escolha Dev Tunnels, o tipo de conta e o tunnel. Você também pode levantar um host independente diretamente com code agent host --tunnel.

A partir do navegador

Com um tunnel rodando, abra https://insiders.vscode.dev/agents, escolha Continue with GitHub e selecione seu host. O navegador se conecta apenas através de dev tunnels ou GitHub Environments, não diretamente por SSH.

A máquina remota precisa estar ligada e acessível. Conectar a uma máquina desligada não a liga.

É seguro expor sua máquina assim?

É um modelo de proprietário confiável, e a documentação é direta sobre as concessões:

  • As ações da sessão são replicadas no GitHub, e o conteúdo da conversa não tem criptografia de ponta a ponta.
  • Qualquer cliente conectado obtém acesso de proprietário às sessões, ferramentas e recursos do workspace do host.
  • Um dev tunnel anônimo permite que qualquer pessoa que encontre a URL inicie sessões de agente em sua máquina. Sempre exija autenticação com GitHub ou Microsoft.

Se a máquina guarda credenciais ou código de clientes que você não pode expor, combine com o sandbox local, que chegou à disponibilidade geral em 7 de outubro para as sessões do Agent Host: Sandbox local do GitHub Copilot.

Copilot CLI ou VS Code: o que muda com o Agent Host?

A diferença diminui. O harness do Copilot no VS Code usa o mesmo Copilot SDK que o Copilot CLI, e uma máquina registrada como GitHub Environment expõe suas sessões também ao Copilot CLI. Você pode começar no editor e retomar a partir do terminal, ou vice-versa.

Instalando o Copilot CLI também passa pelo VS Code: no Windows, a partir do instalador do VS Code; no macOS, ao adicionar o VS Code ao PATH; no Linux, executando copilot.

O que não muda: o SDK compartilhado não garante ferramentas, modelos, permissões nem personalizações idênticas entre produtos. Escolha por interface, não espere paridade total.

O que não funciona igual que com o harness Local?

O harness do Copilot não substitui simplesmente cada fluxo de trabalho do harness Local. A documentação lista estas limitações:

  • As sessões do harness do Copilot não têm acesso a todas as ferramentas integradas ou fornecidas por extensões.
  • Nem todas as sessões nem todos os settings pessoais são sincronizados.
  • As ferramentas de extensões funcionam apenas em chats da janela do editor onde essa extensão roda.

Antes de mover um fluxo do qual você depende, verifique se suas ferramentas e servidores MCP estão disponíveis no harness do Copilot. Se não estiverem, o harness Local continua a um clique em Session Target.

O Copilot pode usar seus apps de desktop (Copilot computer use)?

De forma experimental, sim, no macOS e Windows. Ative chat.agentHost.computerUse.enabled em Settings, reinicie o VS Code e execute /computer on em uma sessão do Copilot que rode em seu computador (/computer off o desativa novamente). Cada aplicação requer sua aprovação; no macOS você concede as permissões do sistema uma única vez. A configuração é compartilhada com o Copilot CLI e o app do GitHub Copilot, e as organizações podem desativá-la por política.

Você pode construir seu próprio cliente para o Agent Host?

Sim, para isso existe o protocolo aberto. O Agent Host Protocol v1.0 já está publicado. Execute code agent host para levantar um host independente em localhost, protegido com um connection token, e conecte-se com uma das bibliotecas cliente para TypeScript, Rust, Go, Kotlin ou Swift. Se o VS Code já tiver um host rodando, code agent endpoints retorna seus endpoints.

Status em 3 de novembro de 2026: o Agent Host e o harness do Copilot por padrão estão publicados na 1.144, sem rótulo de preview. O GitHub Environments está em Preview. Computer use, as sessões na nuvem e os Dev Containers no Agent Host são experimentais.


E você? Que tarefa deixaria rodando no Copilot enquanto se afasta da mesa?

Onde você deixa seu agente de código rodando hoje?
  • Na minha máquina, com a janela do editor aberta
  • Em um servidor remoto, por SSH ou tunnel
  • Na nuvem, com um cloud agent
  • Prefiro outra opção (conte-nos qual)
0 votantes

Comente abaixo ou, se este artigo chegou até você por email, responda diretamente ao email: sua resposta é publicada aqui.

Relacionado: Sandbox local do GitHub Copilot: como ativá-lo na CLI, no app e no VS Code (e o que não bloqueia)