Открытый код

OpenCode на телефоне, на вашем собственном сервере

В OpenCode уже есть сервер и веб-интерфейс, и на них строятся приложения сообщества. Но безопасно довести порт с сервера до телефона они оставляют вам. Maude берёт эту часть на себя и ничего не открывает.

OpenCode на телефоне, на вашем собственном сервере

Короткий ответ

Собственного мобильного приложения у OpenCode нет. Обычные пути — opencode web в браузере телефона или приложение сообщества, подключённое к opencode serve, и в обоих случаях порт приходится открывать через локальную сеть, Tailscale или туннель. Maude устанавливает по SSH OpenCode фиксированной версии на ваш сервер и подключается через исходящий ретранслятор со сквозным шифрованием, так что никакой порт не открывается. OpenCode работает 24/7 с вашими ключами моделей или входом через ChatGPT или Copilot.

OpenCode — агент для кода с открытым исходным кодом (MIT), который работает почти с любым поставщиком моделей. Его любят те, кто не хочет привязываться к подписке одного вендора. К тому же он изначально рассчитан на удалённое управление: opencode serve запускает headless HTTP API, а opencode web добавляет поверх него браузерный интерфейс. Так что вопрос не в том, можно ли до него добраться с телефона, а в том, как сделать это безопасно и чтобы он продолжал работать.

Как пользоваться OpenCode с телефона

СпособКак он попадает на телефонЧем хорош
opencode web в мобильном браузереПривязать к 0.0.0.0 (или использовать --mdns) и открыть сетевой адресБыстро в той же сети Wi-Fi, ничего не нужно ставить на телефон
Приложения сообщества, например OpenCode MobileПодключить приложение к opencode serve через локальную сеть, Tailscale, туннель, обратный прокси или проброс порта по SSHБесплатный нативный клиент с открытым кодом, если вы уверенно чувствуете себя с сетями
SSH-приложение плюс tmuxЗайти на сервер по SSH и подключиться к терминальному интерфейсуПолный контроль без лишнего ПО, но терминальный интерфейс на экранной клавиатуре
MaudeСервер сам подключается к ретранслятору со сквозным шифрованием; входящий порт не нуженСервер, работающий 24/7 рядом с другими агентами, с подтверждениями и git

Первые два варианта хороши и ничего не стоят. OpenCode Mobile — проект сообщества, который прямо говорит, что не связан с OpenCode. Если вы пользуетесь OpenCode только дома в одной сети, opencode web может оказаться достаточно. Maude рассчитана на OpenCode на удалённом сервере, который должен работать, пока вас нет, рядом с другими агентами вроде Claude Code и Codex. Более широкий обзор — в нашей подборке мобильных приложений для агентов.

Безопасность: не открывайте 4096 в интернет

По умолчанию opencode serve слушает 127.0.0.1:4096, а opencode web выбирает случайный локальный порт. Это безопасное значение по умолчанию. Проблемы начинаются, когда его расширяют, чтобы достучаться с телефона. Как пишет сам OpenCode: «Если OPENCODE_SERVER_PASSWORD не задан, сервер не будет защищён». Открытый API OpenCode — это открытая оболочка на этой машине, потому что агент умеет выполнять команды.

Если вы настраиваете всё сами:

  • Всегда задавайте OPENCODE_SERVER_PASSWORD. Он включает HTTP basic auth и для serve, и для web.
  • Предпочитайте частную сеть вроде Tailscale публичному туннелю и никогда не привязывайтесь к 0.0.0.0 на VPS с публичным IP и без файрвола.
  • Если без публичного туннеля не обойтись, поставьте аутентификацию и перед ним.

Maude обходит этот вопрос. OpenCode остаётся локальным на сервере, демон Maude общается с ним через stdio по Agent Client Protocol, а до телефона демон добирается, сам подключаясь наружу к ретранслятору Maude. Трафик защищён сквозным шифрованием с ключом для каждого сервера, поэтому ретранслятор видит только шифротекст. SSH — запасной вариант. Самостоятельная настройка сети подробнее разобрана в нашем руководстве по tmux, mosh и Tailscale.

OpenCode на VPS 24/7

Сам OpenCode лёгкий. Сколько нужно серверу, решают сборки и тесты вашего проекта; о выборе размера — в нашем руководстве по VPS для агентов. С Maude настройка выглядит так:

  1. Добавьте сервер в приложении по адресу, вставкой команды ssh … или сканированием QR-кода из curl -fsSL https://maude.pilotdev.fr/setup | sh. Подойдёт любая машина с Linux или macOS, x86-64 или ARM.
  2. Приложение разворачивает свой демон по SSH. Демон устанавливает OpenCode фиксированной проверенной версии со сверкой контрольной суммы с релизом, в том числе сборки для Alpine (musl) и для старых процессоров без AVX2. Он же поддерживает OpenCode в актуальном состоянии.
  3. Войдите к поставщику с телефона (следующий раздел) и начните сессию в папке проекта, при желании в отдельном git worktree.

С этого момента сессии работают на сервере независимо от того, открыто ли приложение. Когда OpenCode просит разрешения что-то выполнить, запрос появляется карточкой в чате, во входящих и push-уведомлением с кнопками Разрешить и Отклонить. Два основных агента OpenCode соответствуют чипу режима в Maude: Build (по умолчанию, все инструменты) и Plan (ограниченный агент для анализа, который спрашивает перед любой правкой или командой). /compact работает, а в каждой сессии есть «Файлы», Git (проверка diff, коммит, push, pull request через gh) и настоящий терминал.

Модели и ключи

Сила OpenCode в том, что он не привязан к одному поставщику моделей. В Maude войти можно с телефона любым из этих способов:

  • ChatGPT Plus/Pro — через headless-вход OpenCode по коду устройства.
  • GitHub Copilot — через device flow GitHub.
  • Ключ API Anthropic или OpenRouter — вставляется в приложении и хранится OpenCode на сервере.

Поставщики, которых вы уже настроили на сервере через opencode auth login, тоже обнаруживаются и используются. Ещё один вариант — собственные шлюзы OpenCode. OpenCode Zen — оплата по факту за модели, проверенные командой OpenCode, включая несколько бесплатных моделей на ограниченное время. OpenCode Go — подписка на популярные открытые модели для кода за $10 в месяц, а Go Plus за $40 даёт более высокие лимиты. Модель выбирается для каждой сессии чипом над полем ввода. Maude не включает никакого использования моделей.

Как OpenCode соотносится с агентами вендоров по цене и поведению, смотрите в статье Claude Code, Codex или OpenCode. Простаивающую сессию также можно передать другому агенту. Новый агент получает сводку: план, затронутые файлы, состояние git и последние сообщения, а при переключении обратно OpenCode продолжит свою собственную сессию.

Кому что подходит

OpenCode дома в одной сети: opencode web с паролем бесплатен, и его достаточно. Нужен удобный нативный клиент и вас не смущает Tailscale: попробуйте приложение сообщества. OpenCode на удалённом сервере, работающий 24/7, без порта, который нужно защищать, и с другими агентами в тех же входящих: для этого и существует Maude.

Часто задаваемые вопросы

Есть ли официальное мобильное приложение OpenCode?
От проекта OpenCode — нет: он выпускает терминальный интерфейс, настольное приложение и веб-интерфейс. Есть мобильные клиенты от сообщества, например OpenCode Mobile, которые заявляют, что не связаны с OpenCode. Maude — ещё один вариант, и она сама запускает OpenCode на вашем сервере.
Безопасно ли пользоваться opencode web с телефона?
Да, в сети, которой вы доверяете. Привяжите его к локальной сети или tailnet, задайте OPENCODE_SERVER_PASSWORD, чтобы включить basic auth, и не открывайте его на публичном IP. Без пароля OpenCode предупреждает, что сервер не защищён, и любой, кто до него доберётся, сможет заставить агента выполнять команды.
Какие модели может использовать OpenCode?
Почти любые. Он подключается ко многим поставщикам с вашими ключами API, умеет входить через ChatGPT или GitHub Copilot и имеет собственные шлюзы — OpenCode Zen (оплата по факту) и OpenCode Go (подписка). Модель выбирается для каждой сессии.
Нужна ли для OpenCode подписка?
Нет. OpenCode бесплатен и распространяется с открытым кодом по лицензии MIT. Вы платите тому поставщику моделей, которым пользуетесь, или ничего — за бесплатные модели, которые OpenCode предлагает на ограниченное время. Для работы через Maude нужна подписка Maude на приложение.

Что изменилось

  • — Страница опубликована. Лицензия OpenCode, настройки сервера по умолчанию, рекомендации по паролю и цены Go/Zen сверены в этот день с документацией opencode.ai.

Управляйте агентами с телефона

Maude запускает Claude Code, Codex, OpenCode, Grok Build и Antigravity на вашем собственном сервере — 7 дней бесплатно на iPhone, iPad и Android.

Download Maude on the App Store Get Maude on Google Play