OpenCode на облачном сервере: установка и serve
На 2026-10-20 OpenCode можно установить на облачный сервер QCode, держать его запущенным через opencode serve и вызывать модели ключом QCode. Облачные серверы и AI-сервисы продаются отдельно, общими у них остаются только аккаунт и баланс.
Обновлено 2026-10-20
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard / AMEX или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре пункта развёртывания
Headless HTTP-сервер
Официальная документация server: opencode serve запускает headless HTTP-сервер с OpenAPI endpoint; порт по умолчанию 4096, адрес прослушивания по умолчанию 127.0.0.1.
Полный root-доступ
Облачный сервер QCode — это KVM-хост с выделенным публичным IPv4 и полным root-доступом; системой и данными управляете вы.
Длительность пробного периода
Пробный период длится 1 день (24 часа) и оплачивается по выбранной конфигурации. В течение этого срока в панели можно перевести сервер на 1, 3, 6 или 12 месяцев; иначе по окончании сервер удаляется, данные не сохраняются.
Выбирается при заказе
При заказе можно указать публичный SSH-ключ и включить «только вход по ключу» (отключить вход root по паролю). Веб-консоли пока нет: если потерять закрытый ключ, вернуться на сервер можно только переустановкой системы, а данные при этом будут стёрты.
Что можно запустить на сервере
Чтобы запустить OpenCode на облачном сервере QCode, закажите KVM-хост с root-доступом, установите OpenCode официальным скриптом, пропишите эндпоинты QCode в opencode.json и запустите opencode serve внутри tmux. Облачный сервер QCode — это зарубежная машина, которая продаётся отдельно, с выделенным публичным IPv4; это продукт, отдельный от AI-сервиса, и общие у них только аккаунт и баланс. В документации QCode перечислены Гонконг, Япония, Корея, США и Германия, в каждом регионе одна или несколько линий.
Что говорят официальные страницы
Официальная документация OpenCode server (opencode.ai/docs/server, документация OpenCode 1) сообщает, что opencode serve — это headless HTTP-сервер; порт по умолчанию 4096, адрес прослушивания 127.0.0.1, их можно изменить через --hostname и --port. Если задать OPENCODE_SERVER_PASSWORD, включается HTTP basic auth, имя пользователя по умолчанию opencode. Страница OpenCode в документации QCode показывает эндпоинты QCode в ~/.config/opencode/opencode.json.
Хронология
Страница OpenCode в документации QCode проверена 2026-10-20; в неё добавлен раздел об OpenCode 2.
Пакет OpenCode 2 @opencode/cli в npm получил версию 2.1.0. opencode.ai/docs по-прежнему содержит документацию OpenCode 1, документация OpenCode 2 находится на opencode.ai/v2/docs.
Документация облачных серверов QCode и страница Cloud проверены 2026-10-20: размер можно увеличить онлайн, для каждого сервера доступно до 3 снимков, а на странице заказа можно по желанию указать публичный SSH-ключ.
Подтверждено vs не подтверждено
Подтверждено (дословно по официальным страницам)
Облачные серверы QCode: зарубежная машина продаётся отдельно, KVM, полный root, 1 выделенный публичный IPv4 на сервер (назначается, когда сервер готов; изменить нельзя), Гонконг, Япония, Корея, США и Германия, платный пробный период 1 день (24 часа), переход на 1, 3, 6 или 12 месяцев во время пробного периода, онлайн-увеличение размера, до 3 снимков на сервер. OpenCode: opencode serve — headless HTTP-сервер, по умолчанию 127.0.0.1:4096, OPENCODE_SERVER_PASSWORD включает basic auth; официальный установочный скрипт OpenCode 1 — curl -fsSL https://opencode.ai/install.
Не подтверждено и официально не опубликовано
На GitHub есть сообщение пользователя (#56668, создано 2026-10-18, версия в отчёте — Desktop 2.0.32, на 2026-10-20 всё ещё open): в десктопном приложении первое SSH-подключение к новому удалённому серверу может занять несколько минут на скачивание или отправку удалённого OpenCode server, а диалог показывает только Connecting over SSH…, и кажется, что программа зависла. Это сообщение пользователя, а не официальный вывод.
Два способа запуска
opencode serve
Headless HTTP-сервис для других клиентов или скриптов. По умолчанию слушает только 127.0.0.1; для удалённого доступа измените адрес через --hostname и защитите его с помощью OPENCODE_SERVER_PASSWORD.
Локальный TUI
Официальная документация server говорит, что запуск opencode поднимает и TUI, и server; TUI — клиент, который обращается к server. opencode serve запускает отдельный server.
Шаги развёртывания
① Закажите облачный сервер QCode: выберите регион, линию, конфигурацию, систему и срок; для пробного периода выберите 1 день. На шаге сети всегда включён 1 выделенный публичный IPv4; на шаге с root-паролем можно по желанию указать публичный SSH-ключ. ② Когда сервер готов, войдите командой ssh root@IP_сервера; root-пароль вы задали при заказе. ③ Установите OpenCode по официальной странице установки: curl -fsSL https://opencode.ai/install | bash. Официальная страница подаёт этот скрипт как способ установки OpenCode 1; в документации QCode сказано, что конфигурация provider / options.baseURL со страницы OpenCode работает и в OpenCode 1, и в OpenCode 2. У OpenCode 2 другая команда установки, а с командой по умолчанию две версии рядом не устанавливаются (см. последний вопрос). ④ Запишите эндпоинты QCode в ~/.config/opencode/opencode.json и сохраните ключ через opencode auth login. ⑤ Держите процесс в tmux: tmux new -s opencode, запустите OPENCODE_SERVER_PASSWORD=your-password opencode serve (по умолчанию он слушает только 127.0.0.1:4096), нажмите Ctrl+B, затем D для отсоединения; вернуться можно через tmux attach -t opencode.
Подключение OpenCode к QCode
Настройка OpenCode по документации QCode: файл ~/.config/opencode/opencode.json, baseURL провайдера Anthropic — https://api.qcode.cc/claude/v1, провайдера OpenAI — https://api.qcode.cc/openai/v1. Ключ записывается через opencode auth login или /connect; в OpenCode 1 он хранится в ~/.local/share/opencode/auth.json, а OpenCode 2 держит его в SQLite и импортирует старый auth.json. Перед использованием нужно включить разрешение API direct access: по умолчанию оно отключено, а включить его для купленного API-ключа можно через онлайн-поддержку или письмом на hi@qcode.cc. Оплата по токенам, цены по моделям указаны на /models. Не хотите платить помесячно? «Разовые пакеты» — от $4 за разовый объём квоты, который нужно израсходовать за 7–90 дней. Если у вас уже есть личный тариф и квоты не хватает, докупите бустер-пакет.
Частые вопросы
Как установить OpenCode на облачный сервер?
Используйте скрипт с официальной страницы установки OpenCode: curl -fsSL https://opencode.ai/install | bash. Официальная страница подаёт его как способ установки OpenCode 1. У OpenCode 2 другая команда установки — см. последний вопрос.
Остановится ли opencode serve после отключения SSH?
Если запустить его на переднем плане, процесс завершится вместе с соединением. Документация QCode описывает tmux (в её примере сессия называется agent, имя можно выбрать любое, здесь используется opencode): tmux new -s opencode создаёт сессию, запустите в ней opencode serve, нажмите Ctrl+B, затем D для отсоединения; вернуться можно через tmux attach -t opencode. Сессии tmux сохраняются после случайного разрыва или отсоединения.
Как настроить OpenCode на вызов моделей ключом QCode?
Следуйте документации QCode: в ~/.config/opencode/opencode.json укажите https://api.qcode.cc/claude/v1 как baseURL провайдера Anthropic и https://api.qcode.cc/openai/v1 как baseURL провайдера OpenAI. Ключ записывается через opencode auth login или /connect; в OpenCode 1 он хранится в ~/.local/share/opencode/auth.json, а OpenCode 2 держит его в SQLite и импортирует старый auth.json. Сначала включите разрешение API direct access.
Нужно ли покупать AI-тариф вместе с облачным сервером?
Нет. В документации QCode сказано, что облачные серверы и AI-сервисы продаются отдельно и у них общие только аккаунт и баланс, а для запуска Claude Code или Codex на машине покупать AI-тариф не нужно. Чтобы OpenCode вызывал модели QCode, используется ваш ключ QCode; модели оплачиваются по токенам, цены по моделям указаны на /models.
Можно ли увеличить конфигурацию или сменить линию?
Размер можно увеличить онлайн: на вкладке Actions выберите больший план и доплатите разницу в цене до даты окончания; изменение вступает в силу сразу, сервер перезапускается один раз, дата окончания не меняется. Понижение и смена региона или линии недоступны; для другой линии закажите ещё один сервер. Пробный сервер сначала нужно перевести на месячный тариф.
Что ставить на сервер: OpenCode 1 или OpenCode 2?
Зависит от того, по какой документации вы работаете. opencode.ai/docs (включая страницу server) — документация OpenCode 1, а скрипт curl -fsSL https://opencode.ai/install устанавливает OpenCode 1. Документация OpenCode 2 находится на opencode.ai/v2/docs, её скрипт установки — curl -fsSL https://opencode.ai/v2/install | bash. Обе версии используют команду opencode и с командой по умолчанию не устанавливаются рядом; установщик OpenCode 2 через curl заменяет бинарный файл V1. Пример opencode.json для QCode приведён на странице OpenCode в документации QCode (проверена 2026-10-20); по документации QCode, конфигурация provider / options.baseURL оттуда работает и в OpenCode 1, и в OpenCode 2.
Источники
Документация облачных серверов QCode (получена 2026-10-20; регионы, пробный период, увеличение размера, снимки, SSH-ключи); страница Cloud QCode (получена 2026-10-20); документация по оплате облачных серверов QCode (получена 2026-10-20); документация QCode по агентам на облачном сервере (получена 2026-10-20; tmux и языки интерфейса); официальная документация OpenCode server и установки (получены 2026-10-20); страницы OpenCode и «Разовые пакеты» QCode (получены 2026-10-20).
OpenCode на постоянно включённой машине
Стартовые цены и линии облачных серверов — на qcode.cc/en/cloud; интерфейс облачных серверов сейчас доступен только на китайском и английском.
Читайте также
Разовые пакеты для Claude Code: без подписки, 7–90 дней
Квота покупается один раз и расходуется за 7–90 дней, без подписки; новые пакеты добавляются к тому же ключу.
OpenCode: общий доступ к сессиям отключён (1.19.1)
Что изменилось с общим доступом к сессиям и переходом на OpenCode 2.
OpenCode 2026: 200 тыс.+ звёзд, открытый AI-агент
Что такое OpenCode, установка, мультиагентность, BYOK и подключение к QCode.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Факты об облачных серверах на этой странице проверены 2026-10-20 по qcode.cc/cloud и docs.qcode.cc; факты об OpenCode — 2026-10-20 по официальной странице установки и документации server; доступность моделей и цены — по /models. Об официальных изменениях отдельно не сообщается.