Windows (WSL)

Embora o opencode possa rodar direto no Windows, recomendamos usar Windows Subsystem for Linux (WSL) para a melhor experiencia. O WSL oferece um ambiente Linux que funciona de forma integrada com os recursos do opencode.

Por que WSL?

O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a terminal e compatibilidade com as ferramentas de desenvolvimento das quais o opencode depende.

---

Configuracao

1. Instale o WSL

   Se ainda nao instalou, instale o WSL usando o guia oficial da Microsoft.

2. Instale o opencode no WSL

   Depois de configurar o WSL, abra o terminal do WSL e instale o opencode usando um dos metodos de instalacao.

   curl -fsSL https://opencode.ai/install | bash

3. Use o opencode pelo WSL

   Va para o diretorio do seu projeto (acesse arquivos do Windows via /mnt/c/, /mnt/d/ etc.) e execute o opencode.

   cd /mnt/c/Users/YourName/project
   opencode

---

App desktop + servidor WSL

Se voce prefere usar o app desktop do opencode, mas quer rodar o servidor no WSL:

1. Inicie o servidor no WSL com --hostname 0.0.0.0 para permitir conexoes externas:

   opencode serve --hostname 0.0.0.0 --port 4096

2. Conecte o app desktop em http://localhost:4096

Nota

Se localhost nao funcionar no seu ambiente, conecte usando o IP do WSL (no WSL: hostname -I) e use http://<wsl-ip>:4096.

Cuidado

Ao usar --hostname 0.0.0.0, defina OPENCODE_SERVER_PASSWORD para proteger o servidor.

OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0

---

Cliente web + WSL

Para a melhor experiencia web no Windows:

1. Execute opencode web no terminal WSL em vez do PowerShell:

   opencode web --hostname 0.0.0.0

2. Acesse pelo navegador do Windows em http://localhost:<port> (o opencode mostra a URL)

Executar opencode web a partir do WSL garante acesso correto ao sistema de arquivos e integracao com o terminal, continuando acessivel no navegador do Windows.

---

Acessar arquivos do Windows

O WSL pode acessar todos os arquivos do Windows pelo diretorio /mnt/:

• Unidade C: → /mnt/c/
• Unidade D: → /mnt/d/
• E assim por diante…

Exemplo:

cd /mnt/c/Users/YourName/Documents/project
opencode

Dica

Para uma experiencia mais fluida, considere clonar/copiar seu repositorio para o sistema de arquivos do WSL (por exemplo em ~/code/) e executar o opencode por la.

---

Dicas

• Mantenha o opencode rodando no WSL para projetos armazenados em unidades do Windows - o acesso aos arquivos fica fluido
• Use a extensao WSL do VS Code junto com o opencode para um fluxo de desenvolvimento integrado
• Sua configuracao e suas sessoes do opencode ficam armazenadas no ambiente WSL em ~/.local/share/opencode/