Windows (WSL)

Запускайте opencode в Windows через WSL.

opencode можно запускать напрямую в Windows, но для лучшего опыта мы рекомендуем Windows Subsystem for Linux (WSL). WSL дает Linux-среду, которая отлично работает с возможностями opencode.

Настройка

Установите WSL

Если вы еще не сделали этого, установите WSL по официальному руководству Microsoft.
Установите opencode в WSL

После настройки WSL откройте терминал WSL и установите opencode одним из способов установки.
Окно терминала
```
curl -fsSL https://opencode.ai/install | bash
```
Запускайте opencode из WSL

Перейдите в каталог проекта (к файлам Windows можно обращаться через /mnt/c/, /mnt/d/ и т.д.) и запустите opencode.
Окно терминала
```
cd /mnt/c/Users/YourName/project
opencode
```

Десктопное приложение + сервер в WSL

Если вы предпочитаете opencode Desktop, но хотите запускать сервер в WSL:

Запустите сервер в WSL с параметром --hostname 0.0.0.0, чтобы разрешить внешние подключения:
Окно терминала
```
opencode serve --hostname 0.0.0.0 --port 4096
```
Подключите десктопное приложение к http://localhost:4096

При использовании --hostname 0.0.0.0 задайте OPENCODE_SERVER_PASSWORD, чтобы защитить сервер.

OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0

Веб-клиент + WSL

Для лучшего веб-опыта в Windows:

Запускайте opencode web в терминале WSL, а не в PowerShell:
Окно терминала
```
opencode web --hostname 0.0.0.0
```
Открывайте в браузере Windows адрес http://localhost:<port> (opencode выведет URL)

Запуск opencode web из WSL обеспечивает корректный доступ к файловой системе и интеграцию с терминалом, при этом интерфейс остается доступным из браузера Windows.

Доступ к файлам Windows

WSL может получать доступ ко всем вашим файлам Windows через каталог /mnt/:

C: drive → /mnt/c/
D: drive → /mnt/d/
И так далее

Пример:

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

Советы

Даже для проектов на дисках Windows запускайте opencode в WSL, чтобы получить более плавный доступ к файлам
Используйте opencode вместе с расширением WSL для VS Code для единого рабочего процесса
Конфигурация и сессии opencode хранятся в среде WSL по пути ~/.local/share/opencode/