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 додатково нічого встановлювати не треба.

Тоді:

  1. У Notiamo відкрийте Налаштування › Запуски агента. У картці Раннери натисніть Новий раннер і дайте йому назву. Скопіюйте токен. Він показується один раз.
  2. На комп’ютері виконайте:
npx @notiamo/runner init
  1. Вставте токен. init перевіряє, що Claude Code працює, запускає вхід у Claude Code для раннера, потім встановлює службу й запускає її.
  2. У проєкті в полі Де працює агент оберіть Власний комп’ютер.

Коли 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-сервера під час першого підключення і відмовляє серверу, який пізніше показує інший ключ. Запуск проходить так:

  1. Резервна копія перед роботою. За SSH раннер експортує базу даних і завантажує її в Notiamo в стиснутому вигляді, не більше 200 МБ. Notiamo зберігає її 30 днів. За FTP чи лише API резервної копії немає.
  2. Агент працює за переліком дозволеного нижче.
  3. Перевірка сайту після роботи. Раннер відкриває сайт і перевіряє, що він і далі відповідає.
  4. Відновлення в разі збою. Якщо перевірку не пройдено, раннер відновлює базу даних.

Що агент може виконувати через 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.

Зупинка раннера

У картці Раннери натисніть Вимкнути, щоб призупинити раннер, або Видалити, щоб прибрати його. Токен видаленого раннера перестає працювати одразу.