Windows (WSL)

Embora o opencode possa rodar direto no Windows, recomendamos usar Windows Subsystem for Linux (WSL) para a melhor experiência. 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.

---

Configuração

1. Instale o WSL

   Se ainda não 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 métodos de instalação.

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

3. Use o opencode pelo WSL

   Vá para o diretório 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 você 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 conexões externas:

   opencode serve --hostname 0.0.0.0 --port 4096

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

Nota

Se localhost não 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 experiência 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 integração com o terminal, continuando acessível no navegador do Windows.

---

Acessar arquivos do Windows

O WSL pode acessar todos os arquivos do Windows pelo diretório /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 experiência mais fluida, considere clonar/copiar seu repositório para o sistema de arquivos do WSL (por exemplo em ~/code/) e executar o opencode por lá.

---

Dicas

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