Windows (WSL)

Запуск OpenCode в Windows с использованием WSL для наилучшего опыта.

Хотя OpenCode может работать непосредственно в Windows, мы рекомендуем использовать Windows Subsystem for Linux (WSL) (opens in a new tab) для наилучшего опыта. WSL предоставляет среду Linux, которая бесшовно работает с функциями OpenCode.

Совет: WSL обеспечивает лучшую производительность файловой системы, полную поддержку терминала и совместимость с инструментами разработки, на которые опирается OpenCode.

Настройка

Установите WSL Если вы ещё этого не сделали, установите WSL (opens in a new tab), используя официальное руководство 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

Примечание: Если localhost не работает в вашей конфигурации, подключайтесь, используя IP-адрес WSL (из WSL: hostname -I) и используйте http://<wsl-ip>: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: → /mnt/c/
Диск D: → /mnt/d/
И так далее...

Пример:

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

Совет: Для наиболее плавного опыта рассмотрите возможность клонирования/копирования вашего репозитория в файловую систему WSL (например, под ~/code/) и запуска OpenCode там.

Советы

Держите OpenCode запущенным в WSL для проектов, хранящихся на дисках Windows — доступ к файлам бесшовный
Используйте расширение WSL (opens in a new tab) для VS Code вместе с OpenCode для интегрированного рабочего процесса разработки
Ваша конфигурация и сессии OpenCode хранятся в среде WSL по адресу ~/.local/share/opencode/

Устранение неполадок TUI