Русский
Документация
Windows (WSL)

Windows (WSL)

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

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

💡

Почему WSL?

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

Установка

  1. Установите WSL

    Если вы ещё этого не сделали, установите WSL (opens in a new tab), используя официальное руководство Microsoft.

  2. Установите OpenCode в WSL

    После настройки WSL откройте терминал WSL и установите OpenCode, используя один из методов установки.

    curl -fsSL https://opencode.ai/install | bash

  3. Используйте OpenCode из WSL

    Перейдите в каталог вашего проекта (доступ к файлам Windows через /mnt/c/, /mnt/d/ и т.д.) и запустите OpenCode.

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

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

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

  1. Запустите сервер в WSL с параметром --hostname 0.0.0.0, чтобы разрешить внешние подключения:

    opencode serve --hostname 0.0.0.0 --port 4096

  2. Подключите десктопное приложение к 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:

  1. Запустите opencode web в терминале WSL, а не в PowerShell:

    opencode web --hostname 0.0.0.0

  2. Откройте в браузере 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/
Устранение неполадокМиграция на 1.0