VS Code IDE

O VS Code IDE serve para editar o código do workspace do Agent a partir do seu computador. Depois da configuração, você pode usar Abrir VSCode no Buda para conectar diretamente ao workspace.

Quando usar VS Code IDE

Use o VS Code IDE quando quiser a experiência completa do IDE local:

• Editar projetos com vários arquivos
• Usar extensões do VS Code
• Revisar mudanças Git
• Depurar código frontend ou backend
• Permitir que um Agent e uma pessoa desenvolvedora trabalhem no mesmo workspace

Se você só precisa visualizar uma página web, o WebPreview geralmente é mais rápido.

Fluxo básico

1. Instale o VS Code localmente e depois instale a extensão VS Code Remote SSH.
2. Instale websocat localmente e confirme que ele funciona no terminal.
3. Cole sua chave pública SSH local no diálogo do Buda.
4. Copie a configuração SSH do diálogo e adicione ao ~/.ssh/config neste computador.
5. Clique em Abrir VS Code, ou selecione o Host pelo VS Code Remote SSH.

Instalar websocat

No macOS, use Homebrew:

brew install websocat

No Windows e Linux, você pode usar Cargo:

cargo install websocat

Você também pode baixar o binário correspondente em websocat Releases e adicioná-lo ao PATH local.

Depois da instalação, rode localmente:

websocat --version

Se o comando não for encontrado, websocat não está no seu PATH.

Encontrar sua chave pública SSH

Arquivos comuns de chave pública:

~/.ssh/id_ed25519.pub
~/.ssh/id_rsa.pub

Veja a chave pública localmente:

cat ~/.ssh/id_ed25519.pub

Copie a linha completa de saída e cole em Adicionar chave pública SSH no diálogo do Buda.

Se você ainda não tem uma SSH key, crie uma:

ssh-keygen -t ed25519 -C "your-email@example.com"

Depois abra o arquivo .pub gerado.

Configurar VS Code Remote SSH

O diálogo do Buda gera um bloco de configuração SSH que começa com Host buda-agent-.... Adicione esse bloco a:

~/.ssh/config

Depois rode este comando no VS Code:

Remote-SSH: Connect to Host

Selecione o Host mostrado no diálogo do Buda.

Q&A

O VS Code diz que não encontrou websocat. O que fazer?

Rode websocat --version localmente. Se o comando não existir, reinstale o websocat ou adicione o diretório do websocat ao PATH.

A conexão mostra Permission denied. O que fazer?

Confirme que você colou no Buda o conteúdo do arquivo de chave pública, o arquivo .pub. Não cole a chave privada. Chaves públicas normalmente começam com ssh-ed25519 ou ssh-rsa.

Tenho várias SSH keys. Preciso de IdentityFile?

Normalmente, não. A configuração SSH gerada pelo Buda não força um IdentityFile; o VS Code pode usar o SSH agent local ou a key padrão.

Se você tem várias SSH keys e o VS Code escolhe a key errada, adicione estas linhas ao Host gerado pelo diálogo:

Host buda-agent-xxxx
  IdentityFile ~/.ssh/id_ed25519
  IdentitiesOnly yes

Troque buda-agent-xxxx pelo Host gerado no diálogo e ~/.ssh/id_ed25519 pelo caminho da sua chave privada.

O VS Code fica conectando. O que devo verificar?

Verifique primeiro:

• A configuração SSH do Buda está salva no ~/.ssh/config local
• websocat --version funciona no terminal local
• A extensão VS Code Remote SSH está instalada
• O workspace do Buda ainda está rodando

Se ainda falhar, reabra o diálogo de VS Code no Buda e copie a configuração mais recente.

Páginas relacionadas

• WebPreview