Windows (WSL)

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

Embora o OpenCode possa ser executado 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.

💡

Por que WSL?

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

Configuração

Instale o WSL

Se você ainda não instalou, instale o WSL (opens in a new tab) usando o guia oficial da Microsoft.
Instale o OpenCode no WSL

Depois que o WSL estiver 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
```

Aplicativo Desktop + Servidor WSL

Se você prefere usar o aplicativo OpenCode Desktop mas quer executar 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 aplicativo Desktop a http://localhost:4096

Se localhost não funcionar na sua configuração, conecte usando o endereço IP do WSL (no WSL: hostname -I) e use http://<wsl-ip>:4096.

⚠️

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 pelo seu navegador Windows em http://localhost:<port> (o OpenCode exibe a URL)

Executar opencode web a partir do WSL garante acesso adequado ao sistema de arquivos e integração com o terminal, enquanto ainda permanece acessível pelo seu navegador Windows.

Acessando Arquivos do Windows

O WSL pode acessar todos os seus arquivos do Windows através do diretório /mnt/:

Drive C: → /mnt/c/
Drive D: → /mnt/d/
E assim por diante...

Exemplo:

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

💡

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 lá.

Dicas

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

Solução de Problemas Migrando para 1.0