Notiamo может запустить ИИ-агента на открытых комментариях и задачах проекта. Агент вносит правки, а кто-то из вашей команды их одобряет. Запуск может идти на серверах Notiamo или на вашем компьютере. Эта страница о втором способе: о раннере, небольшой программе, которую вы устанавливаете на свой компьютер. Она для команды агентства.
Что такое раннер
Раннер ждёт запусков агента, которые ваша организация ставит в очередь в Notiamo. Для каждого запуска он клонирует репозиторий (или подключается к сайту на WordPress), запускает Claude Code с инструкциями запуска, передаёт Notiamo всё, что делает агент, и сообщает, когда запуск закончился.
- Он не хранит данных для входа в Claude. Он запускает программу
claude, которая уже есть на компьютере. Сеансы раннера используют собственную папку настроек, поэтому они отделены от ваших. Сам вход выполняет и хранит Claude Code. - Это не вход в Claude внутри Notiamo. Notiamo никогда не видит и не использует ваш аккаунт Claude. Раннер лишь запускает ваш собственный Claude Code на вашем компьютере для вашей собственной работы.
Установка
Вам понадобится:
- Node.js 22 или новее;
- Claude Code 2.1.314 или новее;
- git 2.31 или новее;
- в Linux и WSL2:
bubblewrapиsocat(Debian или Ubuntu:sudo apt install bubblewrap socat). В macOS ничего дополнительно устанавливать не нужно.
Затем:
- В Notiamo откройте Настройки › Запуски агента. В карточке Раннеры нажмите Новый раннер и дайте ему имя. Скопируйте токен. Он показывается один раз.
- На компьютере выполните:
npx @notiamo/runner init
- Вставьте токен.
initпроверяет, что Claude Code работает, запускает вход в Claude Code для раннера, затем устанавливает службу и запускает её. - В проекте в поле Где работает агент выберите Свой компьютер.
Когда init закончит работу, раннер запущен. Он снова запустится сам после входа в систему или перезагрузки.
Команды
| Команда | Что делает |
|---|---|
npx @notiamo/runner init |
Настраивает раннер: токен, вход в Claude Code, установка и запуск службы. |
npx @notiamo/runner@latest update |
Обновляет раннер до новейшей версии. Токен, имя и вход сохраняются. |
npx @notiamo/runner status |
Показывает, установлена ли служба и работает ли она, и последнюю строку журнала. |
npx @notiamo/runner logs |
Показывает последние 50 строк журнала. |
npx @notiamo/runner stop |
Останавливает службу до следующего входа в систему или загрузки. |
npx @notiamo/runner uninstall |
Удаляет службу. Папка раннера остаётся. |
npx @notiamo/runner env <projectId> |
Создаёт или показывает файл env, который этот компьютер даёт запускам одного проекта. |
npx @notiamo/runner start |
Работает на переднем плане. Службе нужна именно эта команда; вам она нужна редко. |
Служба — это агент launchd com.notiamo.runner в macOS, запланированная задача «Notiamo runner» в Windows и пользовательский модуль systemd notiamo-runner в Linux.
Два раннера на одном компьютере
npx @notiamo/runner init --profile staging настраивает второй, отдельный раннер. У него своя папка (~/.notiamo-runner/profiles/staging) и своя служба. Добавляйте --profile staging к каждой команде этого раннера. Имя профиля состоит из букв, цифр и дефисов, от 1 до 32 символов.
К чему у агента есть доступ, а к чему нет
Каждый запуск получает собственный файл настроек Claude Code. Агента держат в рамках три вещи.
Файловые инструменты работают только в папке запуска. Собственные файловые инструменты Claude (чтение, правка, запись, поиск) отказываются работать с чем-либо вне папки запуска. Любой вызов, который запросил бы разрешение, отклоняется, потому что отвечать некому.
Команды оболочки выполняются в песочнице операционной системы. В macOS (Seatbelt) и в Linux или WSL2 (bubblewrap и socat) каждая команда, которую агент выполняет в оболочке, ограничена. Если песочница не запускается, запуск не начинается.
Ни одни учётные данные компьютера не попадают к агенту. Claude Code получает только короткий список переменных окружения (PATH, HOME, USER, LOGNAME, SHELL, LANG, LC_ALL, LC_CTYPE, TERM, TMPDIR, TZ, XDG_*, настройки прокси и сертификатов) плюс переменные самого запуска. Он никогда не получает SSH_AUTH_SOCK, GH_TOKEN, GITHUB_TOKEN, NPM_TOKEN, AWS_* или ANTHROPIC_*. Git агента не видит ни глобальных, ни системных настроек git.
Что песочница оболочки разрешает и запрещает:
- Чтение запрещено: папки других проектов (включая другие запуски, идущие одновременно), собственные файлы раннера и ваши файлы и папки с учётными данными (ключи SSH, входы в облачные сервисы, входы в реестры пакетов, учётные данные git).
- Запись разрешена: только в папке запуска и в папке кеша пакетов проекта рядом с ней. Папка
.git/hooksи файл.git/configзапуска доступны только для чтения. - Сеть разрешена: GitHub, npm, Notiamo, сайт на WordPress (для запуска WordPress) и хосты, которые вы добавили в поле Дополнительные хосты, доступные агенту в карточке Раннеры. Всё остальное запрещено.
Агент никогда не отправляет изменения сам и не хранит учётных данных. Ветку запуска после работы агента отправляет сам раннер.
Когда запуск заканчивается, раннер останавливает все процессы, которые агент оставил, например сервер разработки.
Связка ключей в macOS
В macOS песочница не полностью закрывает связку ключей. Поэтому не храните вход в GitHub в связке ключей пользователя, от имени которого работает раннер (init предупреждает, если находит такой). Надёжнее всего отдельный пользователь macOS с собственной связкой ключей.
Windows
В обычной Windows нет песочницы для оболочки. Тогда текст в комментарии может заставить запуск выполнить любую команду от вашего имени. Запустите раннер внутри WSL2. В обычной Windows раннер не стартует, пока вы не добавите "allowUnsandboxed": true в его config.json; делайте это только на компьютере, где больше ничего нет.
Несколько запусков одновременно
В карточке Раннеры вы задаёте Одновременных запусков: от 1 до 3. Каждый запуск расходует ваш тариф Claude, поэтому выбирайте число, на которое хватает тарифа. Один проект никогда не запускается дважды одновременно: второй запуск в том же проекте ждёт первого.
У каждого одновременного запуска своя папка слота. Песочница запуска не может читать другие слоты.
Раннер для одного клиента
Создавая раннер, вы можете ограничить его одним рабочим пространством в поле Работает для. Тогда он берёт только запуски этого клиента. Чтобы настроить его на компьютере клиента: установите там Claude Code, выполните npx @notiamo/runner init и вставьте токен раннера. Запуски оплачивает вход в Claude на этом компьютере, поэтому входите под аккаунтом, который должен платить.
Команды подготовки и тестов
В чистом клоне нет установленных пакетов. Скажите агенту, как их установить и как тестировать. Откройте настройки агента в проекте и заполните Команда подготовки и Команда тестов, по одной строке.
- Агент выполняет команду подготовки один раз, перед первым изменением. Пример:
pnpm install --frozen-lockfile. - Агент выполняет команду тестов перед каждым коммитом. Изменение, которое её не проходит, исправляется или отменяется. Пример:
pnpm typecheck && pnpm lint. - Агент выполняет обе команды сам, в той же песочнице, что и остальные свои команды. Реестр пакетов должен быть среди разрешённых хостов. GitHub и
registry.npmjs.orgтам по умолчанию. Любой другой (PyPI, crates.io, закрытый реестр) добавьте в поле Дополнительные хосты, доступные агенту в карточке Раннеры. - У каждого проекта есть папка кеша пакетов рядом с его клоном. npm, pnpm, Yarn, Corepack, Bun, pip, uv и Composer хранят там свои кеши, потому что песочница закрывает привычные места в вашей домашней папке. Папка сохраняется между запусками проекта и удаляется вместе с клоном. В обычной Windows её нет.
- Делайте команду тестов лёгкой. Тест, которому нужен Docker, не запустится. Тест, которому нужна база данных, запустится только если файл env проекта указывает на базу, которую вы держите запущенной (см. ниже).
Агент делает коммиты от имени «Notiamo agent», по одной простой строке на пункт. Раннер отключает строку «Co-Authored-By» и надпись «Generated with» из Claude Code, поэтому в репозитории не видно соавтора-ИИ.
Окружение для ваших собственных проектов
Запуск в проекте на GitHub получает чистый клон и ничего больше. Для вашего собственного программного проекта тестам могут понадобиться ещё база данных, хранилище файлов, ловушка для почты и .env. Компьютер с раннером даёт всё это запускам одного проекта через простой файл:
npx @notiamo/runner env <projectId>
<projectId> — последняя часть адреса страницы проекта в Notiamo. Команда создаёт ~/.notiamo-runner/env/<projectId>.env, доступный для чтения только вам, и выводит путь. Пишите по одной паре KEY=VALUE в строке. Следующий запуск этого проекта получит эти переменные в своей оболочке, а агенту сообщат их имена, но никогда не значения. Удалите файл, чтобы убрать переменные. Файл никогда не покидает компьютер: Notiamo не знает, что он существует.
Когда файл есть, оболочка запуска в macOS может также обращаться к службам на 127.0.0.1: к вашему Postgres, хранилищу файлов, серверу разработки. Вы держите их запущенными; агент не может их запустить, а Docker остаётся ему недоступен. В Linux у песочницы собственная сеть, поэтому 127.0.0.1 там — не адрес компьютера: привяжите службы к сетевому адресу компьютера и добавьте этот хост в поле Дополнительные хосты, доступные агенту.
Правила:
- Только значения для разработки и тестов. Агент выполняет команды оболочки и может прочитать каждую переменную. Никогда не используйте рабочий ключ и пароль, который вы применяете где-то ещё.
PATH,HOME, переменные прокси и сертификатов,NODE_OPTIONS,NODE_TLS_REJECT_UNAUTHORIZED,NOTIAMO_*,GIT_*,CLAUDE_*иANTHROPIC_*игнорируются, о чём сообщает журнал. Файл может изменить то, что видят команды агента, но не то, как Claude Code общается с Anthropic и Notiamo.- Значения длиной 6 символов и больше скрываются как
[secret]в стенограмме, которую получает Notiamo. Короткие значения (1,true) не скрываются. - Если проекты одного раннера используют общую базу данных через файл env, держите Одновременных запусков равным 1. Два одновременных запуска запустят тесты на одной и той же базе.
Сайты на WordPress
Подключение находится в карточке Доступ к сайту проекта: пароль приложения и, по желанию, SSH или FTP. Раннер запоминает ключ SSH-сервера при первом подключении и отказывает серверу, который позже показывает другой ключ. Запуск проходит так:
- Резервная копия перед работой. При SSH раннер экспортирует базу данных и загружает её в Notiamo в сжатом виде, не более 200 МБ. Notiamo хранит её 30 дней. При FTP или только API резервной копии нет.
- Агент работает по списку разрешённого ниже.
- Проверка сайта после работы. Раннер открывает сайт и проверяет, что он по-прежнему отвечает.
- Восстановление при сбое. Если проверка не пройдена, раннер восстанавливает базу данных.
Что агент может выполнять через wp-cli, по группам (задаются в проекте):
- Контент:
post *,term *,menu *,media import,option get,option update. - База данных:
search-replace(только старый и новый текст; таблицы пользователей и настроек он никогда не трогает),cache flush,rewrite flush,transient delete. - Плагины и темы:
pluginиthemeсlist,activate,deactivate,update. - Информация:
core version,site list,db size. - Файлы: без команд wp-cli; агент использует свои файловые инструменты. Они записывают стили, скрипты и другие файлы, которые сервер не выполняет.
- Файлы PHP (по умолчанию выключено): файловые инструменты могут записывать и PHP. Файл PHP — это код, который выполняется на вашем сервере, а у запуска на WordPress нет шага одобрения: изменение сразу вступает в силу. Включайте это только для сайта, где вы доверяете всем, кто может написать комментарий.
- Никогда, если вы не выбрали «Разрешить всё»:
eval,eval-file,shell,user *,db query|import|reset|drop|export,plugin install,theme install,core update|download.
Что где хранится
Всё находится в ~/.notiamo-runner.
| Путь | Что там хранится |
|---|---|
config.json |
Адрес Notiamo, имя раннера и токен раннера. Доступен для чтения только вам. |
claude/ |
Папка настроек Claude Code для раннера: его вход и сеансы. |
projects/ |
Рабочие копии ваших проектов, по одной папке на проект в каждом слоте. Проект, которым не пользовались столько дней, сколько задано в карточке Раннеры, удаляется; следующий запуск клонирует его заново. |
git/ |
Собственные копии ваших репозиториев у раннера. Агент не может ни читать, ни изменять эту папку. |
env/ |
Созданные вами файлы env, по одному на проект. |
runs/ |
Настройки Claude Code каждого идущего запуска. Без секретов. Удаляется, когда запуск заканчивается. |
runner.log |
Что делал раннер, без секретов. |
state.json |
Идентификаторы идущих запусков. После перезапуска о каждом из них сообщается Notiamo как о неудавшемся. |
Секреты запуска (пароли WordPress, собственные токены запуска) приходят из Notiamo вместе с запуском и хранятся только в памяти. Агент получает их как переменные окружения, но не в файле. Из того, что агент выводит, они удаляются до загрузки стенограммы.
Раннер никогда не использует учётные данные git, имеющиеся на компьютере. Каждый запуск получает от Notiamo токен GitHub, который действует один час и только для репозитория запуска. Раннер хранит его в памяти и использует для собственных fetch и push. Pull request открывает и сливает Notiamo.
Остановка раннера
В карточке Раннеры нажмите Отключить, чтобы приостановить раннер, или Удалить, чтобы убрать его. Токен удалённого раннера перестаёт работать сразу.