Windows (WSL)

Rode o OpenCode no Windows usando o WSL para a melhor experiência.

Embora o OpenCode possa rodar diretamente no Windows, recomendamos usar o Windows Subsystem for Linux (WSL) (opens in a new tab) para a melhor experiência. O WSL fornece um ambiente Linux que funciona perfeitamente com os recursos do OpenCode.

Dica: O WSL oferece melhor desempenho do sistema de arquivos, suporte completo ao terminal e compatibilidade com as ferramentas de desenvolvimento das quais o OpenCode depende.

Configuração

Instale o WSL Se ainda não fez, instale o WSL (opens in a new tab) usando o guia oficial da Microsoft.
Instale o OpenCode no WSL Uma vez que o WSL esteja configurado, abra seu terminal WSL e instale o OpenCode usando um dos métodos de instalação.
```
curl -fsSL https://opencode.ai/install | bash
```
Use o OpenCode a partir do WSL Navegue até 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 no WSL

Se você prefere usar o app Desktop do OpenCode, mas quer rodar o servidor no WSL:

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
```
Conecte o app Desktop a http://localhost:4096

Nota: Se localhost não funcionar na sua configuração, conecte usando o endereço IP do WSL (a partir do 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:

Execute opencode web no terminal WSL em vez do PowerShell:
```
opencode web --hostname 0.0.0.0
```
Acesse a partir do seu navegador no Windows em http://localhost:<port> (o OpenCode imprime a URL)

Executar opencode web a partir do WSL garante o acesso adequado ao sistema de arquivos e a integração com o terminal, mantendo-se acessível a partir do seu navegador no Windows.

Acessando Arquivos do Windows

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

Dicas

Mantenha o OpenCode rodando no WSL para projetos armazenados em unidades do Windows - o acesso a arquivos é perfeito
Use a extensão WSL (opens in a new tab) do VS Code junto com o OpenCode para um fluxo de desenvolvimento integrado
Sua config e suas sessões do OpenCode são armazenadas dentro do ambiente WSL em ~/.local/share/opencode/

Solução de Problemas TUI