Runner на удалённом сервере

Как поставить runner на Linux-сервер без графики и браузера: мастер настройки по SSH, вход в аккаунты моделей и запуск в фоне.

Когда это нужно

Runner на сервере работает круглые сутки и не зависит от того, включён ли ваш компьютер. Сервер подойдёт, если агенты должны брать задачи ночью или если на нём уже лежат репозитории, с которыми они работают.

Агент работает на сервере с правами пользователя, от которого запущен runner, — см. «Где работают агенты». Заведите для runner отдельного пользователя и дайте ему доступ только к нужным репозиториям и ключам. Права администратора runner не нужны.

Установка без браузера

Зайдите на сервер по SSH под пользователем для runner. Скачайте файл «Linux (x64)» из Профиль → «Подключить раннер» и перенесите его на сервер, например через scp. Затем:

chmod +x qw
./qw setup

Мастер работает прямо в терминале SSH, браузер на сервере не нужен. Шаги те же, что на компьютере, — раздел «Мастер настройки» на странице «Runner на Linux».

На последнем шаге выберите «Да, включить автозапуск и запустить сейчас»: тогда runner продолжит работать после того, как вы закроете SSH.

Вход в аккаунты моделей

На сервере нет браузера, поэтому вход идёт по ссылке, которую вы открываете у себя:

• Claude Code. CLI печатает ссылку. Откройте её на своём компьютере, войдите под аккаунтом для runner и вставьте код со страницы обратно в терминал SSH.
• Codex. CLI печатает ссылку и код. Откройте ссылку на своём компьютере, войдите и введите там код.
• OpenCode. Браузер не нужен: CLI спросит провайдера и его ключ API.

Можно не заходить по SSH вовсе. Когда runner уже подключён и на связи, войти в аккаунт можно с доски: Профиль → «Аккаунты движков». Как это сделать — на странице «Аккаунты моделей».

Вход, выход и удаление аккаунта из терминала требуют остановленного runner. Сначала остановите его, потом снова запустите:

./qw autostart stop
./qw login claude:work
./qw autostart start

С доски то же самое делается без остановки.

Запуск как службы

Фоновый runner на сервере — пользовательская служба systemd. Её включает мастер или команды:

./qw autostart enable
./qw autostart start

Чтобы служба стартовала при загрузке сервера и работала без открытой сессии SSH, runner включает для пользователя loginctl enable-linger. Если система этого не разрешила, runner скажет об этом. Тогда включите linger под администратором и перезапустите службу:

sudo loginctl enable-linger <пользователь>

Состояние службы печатает ./qw autostart status, журнал — ./qw logs, а ./qw logs -f следит за ним.

Подробнее про службу, обновление и удаление — на странице «Runner на Linux».

Несколько runner

На одном сервере можно держать несколько runner: по одному на каждого пользователя системы. Каждый подключается к доске под своей учётной записью и выполняет задачи только её агентов, со своими аккаунтами моделей. Так на одном сервере работают агенты разных людей, и никто не тратит чужие лимиты.

Один runner сам обслуживает несколько досок и может вести несколько запусков сразу — см. «Несколько машин и досок» и «Одновременные запуски».