OpenCode на VPS: ИИ-агент для кода, бесплатные модели и работа через браузер

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

Как устроен OpenCode

OpenCode не нейросеть. Он отправляет задание модели вместе с описанием своих инструментов, выполняет решение модели — создать файл, внести правку, запустить команду — и возвращает результат обратно, шаг за шагом до конца задачи. Качество работы почти целиком зависит от модели.

В OpenCode уже есть бесплатные модели: ключ и регистрация не нужны, агент работает сразу после установки. Бесплатны они ограниченное время, список периодически меняется, и у части из них собранные данные могут использоваться для обучения — об этом сказано в документации. Модель по умолчанию, MiniMax M3.1 Flash Free, по документации данные не хранит. Для рабочих проектов подключите свою модель по ключу Anthropic, OpenAI или OpenRouter.

Во второй версии все сессии, настройки и выполнение команд принадлежат фоновой службе. Она стартует при первом запуске opencode и слушает порт только на 127.0.0.1. Терминальный интерфейс и браузер — просто окна к этой службе, поэтому задача, начатая в терминале, видна и в браузере.

По умолчанию агент ничего не спрашивает. На тесте его попросили поставить nginx и выложить страницу — он сам выполнил apt-get install -y nginx, скопировал файл в /var/www/html, перезагрузил nginx и полез изучать его конфиги, ни разу не спросив разрешения. Ставьте OpenCode на сервер без чужих данных и важных сайтов и сразу включите подтверждение команд (шаг 2).

Что нужно

Сервер на tanaka.host с Debian 12 или Ubuntu 24.04 и не меньше 2 ГБ памяти. Служба занимает около 340 МБ, окно в терминале ещё около 190 МБ.
Доступ по SSH под root.
Папка проекта, в примере /root/my-site.

1. Установка

Официальная команда установки второй версии:

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

Установщик кладёт программу (~200 МБ) в /root/.opencode/bin и добавляет её в PATH. Перезапустите оболочку:

exec $SHELL

Почему в адресе v2: старая команда curl -fsSL https://opencode.ai/install | bash ставит первую версию. Обе используют команду opencode и не живут рядом, установщик второй версии заменяет первую. Если первая уже стоит, её интерфейс сам предложит /update.

2. Подтверждение команд

mkdir -p ~/.config/opencode
nano ~/.config/opencode/opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "permissions": [
    { "action": "shell", "resource": "*", "effect": "ask" },
    { "action": "external_directory", "resource": "*", "effect": "ask" }
  ]
}

Сохраните (Ctrl+O, Enter, Ctrl+X). Первое правило заставляет спрашивать перед каждой shell-командой, второе — перед работой с файлами вне папки проекта (во второй версии такой доступ по умолчанию разрешён). Чтобы служба применила настройки:

opencode reload

Теперь перед каждой командой агент показывает окно Permission required:

Allow once — выполнить только эту команду.
Always allow — разрешить и запомнить для проекта. После разрешения git status --short агент перестанет спрашивать про все git status.
Reject — запретить. Агент остановится, и вы сможете уточнить задачу.

3. Первая задача

cd /root/my-site
opencode

Внизу — строка для задания. Опишите задачу и нажмите Enter. С бесплатной моделью страница-визитка с проверкой, что файл на месте, делается меньше чем за минуту.

Полезные клавиши:

Действие	Что делает
`Esc`	Прервать текущую задачу
`Ctrl`+`P`	Список команд
`/models`	Выбор модели, бесплатные помечены Free
`/connect`	Подключить свою модель по ключу API
`Ctrl`+`C`	Выйти; на выходе показывается `opencode -s ses_…` для возврата в ту же сессию

Задачу можно дать и одной командой без интерфейса — удобно для скриптов:

opencode run "Сколько строк в файле index.html?"

4. OpenCode в браузере

С длинными ответами и правками кода в браузере удобнее. Служба закрыта от интернета, поэтому нужен SSH-туннель.

На сервере получите одноразовую ссылку вида http://127.0.0.1:49374/auth/connect/… — она работает один раз и только 5 минут:

opencode pair

На своём компьютере в новом окне терминала создайте туннель. Порт возьмите из ссылки (здесь 49374):

ssh -L 49374:127.0.0.1:49374 root@IP-адрес-сервера

Не закрывая окно, откройте ссылку в браузере. Это тот же OpenCode со всеми сессиями.

Не открывайте службу в интернет. Есть способы обойтись без туннеля — opencode service set hostname 0.0.0.0 или opencode pair --remote, и про второй справка прямо пишет, что служба становится доступна из интернета. На VPS это значит, что служба, выполняющая команды на вашем сервере, открыта всему миру. Только SSH-туннель.

После перезагрузки сервера служба сама не стартует. Запустите opencode service start или просто откройте opencode в терминале.

Полезные команды

opencode                  # открыть OpenCode в текущей папке
opencode -c               # продолжить последнюю сессию
opencode run "задача"     # выполнить задачу без интерфейса
opencode models           # список доступных моделей
opencode pair             # одноразовая ссылка для браузера
opencode service status   # адрес фоновой службы
opencode service start    # запустить службу
opencode reload           # перечитать настройки
opencode upgrade          # обновить OpenCode
opencode uninstall        # удалить OpenCode, сессии и настройки останутся

Частые ошибки

opencode: command not found. exec $SHELL или переподключитесь по SSH.

Ссылка из opencode pair не открывается. Проверьте, что окно с туннелем открыто и в ssh -L тот же порт, что в ссылке. Ссылка одноразовая и живёт 5 минут — выполните opencode pair снова. Если порт на вашем компьютере занят, пробросьте другой: ssh -L 8080:127.0.0.1:49374 root@IP-адрес-сервера и замените в ссылке 49374 на 8080.

Агент выполняет команды без вопросов. Так работает по умолчанию. Создайте ~/.config/opencode/opencode.jsonc из шага 2 и opencode reload.

Бесплатная модель пропала. Набор меняется. /models и другая модель с пометкой Free, либо своя через /connect.

Документация — opencode.ai/docs. Похожие агенты для сервера: Claude Code и OpenClaw.