Web

Использование OpenCode в браузере.

OpenCode может работать как веб-приложение в вашем браузере, предоставляя тот же мощный опыт AI-кодирования без необходимости использования терминала.

Начало работы

Запустите веб-интерфейс командой:

opencode web

Это запускает локальный сервер на 127.0.0.1 со случайным доступным портом и автоматически открывает OpenCode в вашем браузере по умолчанию.

⚠️

Если OPENCODE_SERVER_PASSWORD не установлен, сервер будет незащищён. Это допустимо для локального использования, но должно быть настроено для сетевого доступа.

Для лучшего опыта запускайте opencode web из WSL, а не из PowerShell. Это обеспечивает правильный доступ к файловой системе и интеграцию с терминалом.

Конфигурация

Вы можете настроить веб-сервер с помощью флагов командной строки или в файле конфигурации.

Порт

По умолчанию OpenCode выбирает доступный порт. Вы можете указать порт:

opencode web --port 4096

Имя хоста

По умолчанию сервер привязывается к 127.0.0.1 (только localhost). Чтобы сделать OpenCode доступным в сети:

opencode web --hostname 0.0.0.0

При использовании 0.0.0.0 OpenCode отобразит как локальный, так и сетевой адреса:

Local access: http://localhost:4096
Network access: http://192.168.1.100:4096

Обнаружение mDNS

Включите mDNS, чтобы сделать сервер обнаруживаемым в локальной сети:

opencode web --mdns

Это автоматически устанавливает имя хоста на 0.0.0.0 и объявляет сервер как opencode.local.

Вы можете настроить доменное имя mDNS для запуска нескольких экземпляров в одной сети:

opencode web --mdns --mdns-domain myproject.local

CORS

Чтобы разрешить дополнительные домены для CORS (полезно для пользовательских фронтендов):

opencode web --cors https://example.com

Аутентификация

Для защиты доступа установите пароль с помощью переменной окружения OPENCODE_SERVER_PASSWORD:

OPENCODE_SERVER_PASSWORD=secret opencode web

Имя пользователя по умолчанию opencode, но может быть изменено через OPENCODE_SERVER_USERNAME.

Использование веб-интерфейса

После запуска веб-интерфейс предоставляет доступ к вашим сессиям OpenCode.

Сессии

Просматривайте и управляйте сессиями с главной страницы. Вы можете видеть активные сессии и запускать новые.

Статус сервера

Нажмите «See Servers», чтобы просмотреть подключённые серверы и их статус.

Подключение терминала

Вы можете подключить терминальный TUI к работающему веб-серверу:

# Запустить веб-сервер
opencode web --port 4096
 
# В другом терминале подключить TUI
opencode attach http://localhost:4096

Это позволяет использовать веб-интерфейс и терминал одновременно, разделяя одни и те же сессии и состояние.

Файл конфигурации

Вы также можете настроить параметры сервера в файле конфигурации opencode.json:

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

Флаги командной строки имеют приоритет над настройками файла конфигурации.

CLI IDE