Pular para o conteúdo
Docs de V1
Configuração

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.

  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.

    Terminal
    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.

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

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:

    Terminal
    opencode serve --hostname 0.0.0.0 --port 4096

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

Para a melhor experiência web no Windows:

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

    Terminal
    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.

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:

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

  • 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/