Notiamo może uruchomić agenta AI na otwartych komentarzach i zadaniach projektu. Agent wprowadza zmiany, a osoba z Twojego zespołu je zatwierdza. Uruchomienie może odbywać się na serwerach Notiamo albo na komputerze, który należy do Ciebie. Ta strona jest o drugim sposobie: o runnerze, małym programie, który instalujesz na swoim komputerze. Jest dla zespołu agencji.
Czym jest runner
Runner czeka na uruchomienia agenta, które Twoja organizacja kolejkuje w Notiamo. Przy każdym uruchomieniu klonuje repozytorium (albo łączy się ze stroną WordPress), startuje Claude Code z instrukcjami uruchomienia, wysyła do Notiamo to, co robi agent, i zgłasza, kiedy się kończy.
- Nie przechowuje żadnych danych logowania do Claude. Uruchamia program
claude, który już jest na komputerze. Sesje runnera używają własnego folderu konfiguracji, więc są oddzielone od Twoich. Samo logowanie należy do Claude Code i to Claude Code je przechowuje. - To nie jest logowanie do Claude wewnątrz Notiamo. Notiamo nigdy nie widzi ani nie używa Twojego konta Claude. Runner tylko uruchamia Twój własny Claude Code, na Twoim komputerze, do Twojej własnej pracy.
Instalacja
Potrzebujesz:
- Node.js 22 lub nowszego;
- Claude Code 2.1.314 lub nowszego;
- git 2.31 lub nowszego;
- w Linuksie i WSL2:
bubblewrapisocat(Debian lub Ubuntu:sudo apt install bubblewrap socat). W macOS nie trzeba nic więcej instalować.
Potem:
- W Notiamo otwórz Ustawienia › Uruchomienia agenta. Na karcie Runnery naciśnij Nowy runner i nadaj mu nazwę. Skopiuj token. Pokazuje się tylko raz.
- Na komputerze uruchom:
npx @notiamo/runner init
- Wklej token.
initsprawdza, czy Claude Code działa, uruchamia logowanie Claude Code dla runnera, potem instaluje usługę i ją startuje. - W projekcie ustaw Gdzie działa agent na Własny komputer.
Gdy init skończy, runner działa. Po zalogowaniu lub restarcie startuje sam.
Polecenia
| Polecenie | Co robi |
|---|---|
npx @notiamo/runner init |
Konfiguruje runnera: token, logowanie do Claude Code, instalacja i start usługi. |
npx @notiamo/runner@latest update |
Przenosi runnera na najnowszą wersję. Token, nazwa i logowanie zostają. |
npx @notiamo/runner status |
Mówi, czy usługa jest zainstalowana i działa, i pokazuje ostatnią linię logu. |
npx @notiamo/runner logs |
Pokazuje ostatnie 50 linii logu. |
npx @notiamo/runner stop |
Zatrzymuje usługę do następnego logowania lub uruchomienia komputera. |
npx @notiamo/runner uninstall |
Usuwa usługę. Folder runnera zostaje. |
npx @notiamo/runner env <projectId> |
Tworzy lub pokazuje plik env, który ten komputer daje uruchomieniom jednego projektu. |
npx @notiamo/runner start |
Działa na pierwszym planie. Uruchamia to usługa; rzadko będzie Ci to potrzebne. |
Usługa to agent launchd com.notiamo.runner w macOS, zaplanowane zadanie “Notiamo runner” w Windows i jednostka użytkownika systemd notiamo-runner w Linuksie.
Dwa runnery na jednym komputerze
npx @notiamo/runner init --profile staging konfiguruje drugiego, osobnego runnera. Ma własny folder (~/.notiamo-runner/profiles/staging) i własną usługę. Dodawaj --profile staging do każdego polecenia tego runnera. Nazwa profilu składa się z liter, cyfr i myślników, od 1 do 32 znaków.
Czego agent może i nie może dotykać
Każde uruchomienie dostaje własny plik ustawień Claude Code. Trzy rzeczy trzymają agenta na miejscu.
Narzędzia plikowe zostają w folderze uruchomienia. Własne narzędzia plikowe Claude (odczyt, edycja, zapis, wyszukiwanie) odrzucają wszystko poza folderem uruchomienia. Każde wywołanie, które prosiłoby o zgodę, jest odrzucane, bo nie ma nikogo, kto by odpowiedział.
Polecenia powłoki działają w piaskownicy systemu operacyjnego. W macOS (Seatbelt) oraz w Linuksie lub WSL2 (bubblewrap i socat) każde polecenie, które agent uruchamia w powłoce, jest ograniczone. Jeśli piaskownica nie może wystartować, uruchomienie się nie zaczyna.
Żadne dane logowania komputera nie docierają do agenta. Claude Code dostaje tylko krótką listę zmiennych środowiskowych (PATH, HOME, USER, LOGNAME, SHELL, LANG, LC_ALL, LC_CTYPE, TERM, TMPDIR, TZ, XDG_*, ustawienia proxy i certyfikatów) oraz zmienne samego uruchomienia. Nigdy nie dostaje SSH_AUTH_SOCK, GH_TOKEN, GITHUB_TOKEN, NPM_TOKEN, AWS_* ani ANTHROPIC_*. Git agenta nie widzi globalnej ani systemowej konfiguracji gita.
Co piaskownica powłoki dopuszcza, a co blokuje:
- Odczyt zabroniony: foldery innych projektów (także uruchomień działających w tym samym czasie), własne pliki runnera oraz Twoje pliki i foldery z danymi logowania (klucze SSH, logowania do chmur, logowania do rejestrów pakietów, dane logowania gita).
- Zapis dozwolony: tylko w folderze uruchomienia i w folderze pamięci podręcznej pakietów projektu obok niego. Foldery
.git/hooksi.git/configuruchomienia są tylko do odczytu. - Sieć dozwolona: GitHub, npm, Notiamo, strona WordPress (przy uruchomieniu WordPressa) i hosty, które dodasz na karcie Runnery w polu Dodatkowe hosty dostępne dla agenta. Wszystko inne jest odrzucane.
Agent nigdy nie wypycha zmian i nie ma żadnych danych logowania. Gałąź uruchomienia wypycha sam runner po pracy agenta.
Gdy uruchomienie się kończy, runner zatrzymuje każdy proces, który agent zostawił, na przykład serwer deweloperski.
Pęk kluczy w macOS
Piaskownica w macOS nie zamyka pęku kluczy w pełni. Dlatego nie trzymaj logowania do GitHuba w pęku kluczy użytkownika, który uruchamia runnera (init ostrzega, gdy jakieś znajdzie). Najbezpieczniej jest użyć osobnego użytkownika macOS z własnym pękiem kluczy.
Windows
Zwykły Windows nie ma piaskownicy powłoki. Tekst w komentarzu mógłby wtedy sprawić, że uruchomienie wykona dowolne polecenie w Twoim imieniu. Uruchom runnera w WSL2. Na zwykłym Windowsie runner nie wystartuje, dopóki nie dodasz "allowUnsandboxed": true do jego config.json; zrób to tylko na komputerze, na którym nie ma nic innego.
Kilka uruchomień naraz
Na karcie Runnery ustawiasz Jednoczesne uruchomienia: od 1 do 3. Każde uruchomienie korzysta z Twojego planu Claude, więc trzymaj się liczby, na którą plan ma miejsce. Jeden projekt nigdy nie działa dwa razy naraz: drugie uruchomienie w tym samym projekcie czeka na pierwsze.
Każde z uruchomień działających naraz ma własny folder slotu. Piaskownica uruchomienia nie może czytać innych slotów.
Runner dla jednego klienta
Gdy tworzysz runnera, możesz go ograniczyć do jednej przestrzeni roboczej w polu Działa dla. Wtedy przyjmuje tylko uruchomienia tego klienta. Żeby skonfigurować go na komputerze klienta: zainstaluj tam Claude Code, uruchom npx @notiamo/runner init i wklej token runnera. Za uruchomienia płaci logowanie do Claude na tym komputerze, więc zaloguj się kontem, które ma płacić.
Polecenia przygotowania i testów
Czysty klon nie ma zainstalowanych pakietów. Powiedz agentowi, jak je zainstalować i jak testować. Otwórz ustawienia agenta w projekcie i wypełnij Polecenie przygotowania i Polecenie testów, po jednej linii.
- Agent uruchamia polecenie przygotowania raz, przed pierwszą zmianą. Przykład:
pnpm install --frozen-lockfile. - Agent uruchamia polecenie testów przed każdym commitem. Zmiana, która go nie przejdzie, jest poprawiana albo cofana. Przykład:
pnpm typecheck && pnpm lint. - Agent uruchamia oba sam, w tej samej piaskownicy co inne polecenia. Rejestr pakietów musi być wśród dozwolonych hostów. GitHub i
registry.npmjs.orgsą tam domyślnie. Każdy inny (PyPI, crates.io, prywatny rejestr) dodaj na karcie Runnery w polu Dodatkowe hosty dostępne dla agenta. - Każdy projekt ma folder pamięci podręcznej pakietów obok swojego klonu. npm, pnpm, Yarn, Corepack, Bun, pip, uv i Composer trzymają tam swoje pamięci podręczne, bo piaskownica zamyka zwykłe miejsca w Twoim folderze domowym. Folder zostaje między uruchomieniami projektu i znika razem z klonem. Na zwykłym Windows go nie ma.
- Niech polecenie testów będzie lekkie. Test, który potrzebuje Dockera, nie może się wykonać. Test, który potrzebuje bazy danych, może się wykonać tylko wtedy, gdy plik env projektu wskazuje na bazę, którą masz uruchomioną (patrz niżej).
Agent commituje jako “Notiamo agent”, jedna prosta linia na punkt. Runner wyłącza stopkę “Co-Authored-By” i linię “Generated with” z Claude Code, więc repozytorium nie pokazuje współautora AI.
Środowisko dla Twoich własnych projektów
Uruchomienie w projekcie GitHub dostaje czysty klon i nic więcej. W Twoim własnym projekcie programistycznym testy mogą potrzebować też bazy danych, magazynu plików, łapacza poczty i pliku .env. Komputer z runnerem daje je uruchomieniom jednego projektu za pomocą zwykłego pliku:
npx @notiamo/runner env <projectId>
<projectId> to ostatnia część adresu strony projektu w Notiamo. Polecenie tworzy ~/.notiamo-runner/env/<projectId>.env, czytelny tylko dla Ciebie, i wypisuje ścieżkę. Wpisuj jedno KEY=VALUE w linii. Następne uruchomienie tego projektu dostaje zmienne w swojej powłoce, a agent dowiaduje się o ich nazwach, nigdy o wartościach. Usuń plik, żeby je zabrać. Plik nigdy nie opuszcza komputera: Notiamo nie wie, że istnieje.
Gdy plik jest, powłoka uruchomienia może w macOS sięgać też do usług na 127.0.0.1: Twojego Postgresa, magazynu plików, serwera deweloperskiego. Ty je utrzymujesz uruchomione; agent nie może ich startować, a Docker pozostaje poza jego zasięgiem. W Linuksie piaskownica ma własną sieć, więc 127.0.0.1 nie jest tam adresem komputera: podłącz usługi do adresu sieciowego komputera i dodaj ten host w polu Dodatkowe hosty dostępne dla agenta.
Zasady:
- Tylko wartości deweloperskie i testowe. Agent uruchamia polecenia powłoki i może przeczytać każdą zmienną. Nigdy klucz produkcyjny, nigdy hasło, którego używasz gdzie indziej.
PATH,HOME, zmienne proxy i certyfikatów,NODE_OPTIONS,NODE_TLS_REJECT_UNAUTHORIZED,NOTIAMO_*,GIT_*,CLAUDE_*iANTHROPIC_*są ignorowane, a log o tym informuje. Plik może zmienić to, co widzą polecenia agenta, nigdy to, jak Claude Code rozmawia z Anthropic i Notiamo.- Wartości o długości 6 znaków lub więcej są maskowane jako
[secret]w zapisie, który dostaje Notiamo. Krótkich wartości (1,true) to nie dotyczy. - Zostaw Jednoczesne uruchomienia na 1, gdy projekty jednego runnera dzielą bazę danych przez swój plik env. Dwa uruchomienia naraz wykonywałyby swoje testy na tej samej bazie.
Strony WordPress
Połączenie jest na karcie Dostęp do strony projektu: hasło aplikacji oraz opcjonalnie SSH lub FTP. Runner zapamiętuje klucz serwera SSH przy pierwszej wizycie i odrzuca serwer, który później pokaże inny klucz. Uruchomienie wygląda tak:
- Kopia przed. Przez SSH runner eksportuje bazę danych i wysyła ją do Notiamo, skompresowaną, maksymalnie 200 MB. Notiamo przechowuje ją 30 dni. Przy samym FTP lub samym API kopii nie ma.
- Agent pracuje według listy dozwolonych poleceń poniżej.
- Sprawdzenie strony po. Runner otwiera stronę i sprawdza, czy nadal odpowiada.
- Przywrócenie przy błędzie. Jeśli sprawdzenie się nie powiedzie, runner przywraca bazę danych.
Co agent może uruchamiać przez wp-cli, według grup (ustawianych w projekcie):
- Treść:
post *,term *,menu *,media import,option get,option update. - Baza danych:
search-replace(tylko stary i nowy tekst; nigdy nie rusza tabel użytkowników ani opcji),cache flush,rewrite flush,transient delete. - Wtyczki i motywy:
pluginithemezlist,activate,deactivate,update. - Informacje:
core version,site list,db size. - Pliki: żadne polecenie wp-cli; agent używa swoich narzędzi plikowych. Zapisują style, skrypty i inne pliki, których serwer nie wykonuje.
- Pliki PHP (domyślnie wyłączone): narzędzia plikowe mogą też zapisywać PHP. Plik PHP to kod, który działa na Twoim serwerze, a uruchomienie na WordPressie nie ma kroku zatwierdzenia: zmiana jest widoczna od razu. Włącz to tylko dla strony, na której ufasz wszystkim, którzy mogą napisać komentarz.
- Nigdy, chyba że wybierzesz “Zezwól na wszystko”:
eval,eval-file,shell,user *,db query|import|reset|drop|export,plugin install,theme install,core update|download.
Co gdzie jest przechowywane
Wszystko leży w ~/.notiamo-runner.
| Ścieżka | Co zawiera |
|---|---|
config.json |
Adres Notiamo, nazwę runnera i token runnera. Czytelny tylko dla Ciebie. |
claude/ |
Folder konfiguracji Claude Code dla runnera: jego logowanie i sesje. |
projects/ |
Kopie robocze Twoich projektów, jeden folder na projekt w każdym slocie. Projekt nieużywany przez liczbę dni ustawioną na karcie Runnery jest usuwany; następne uruchomienie klonuje go od nowa. |
git/ |
Własne kopie Twoich repozytoriów, należące do runnera. Agent nie może tego folderu ani czytać, ani w nim pisać. |
env/ |
Pliki env utworzone przez Ciebie, po jednym na projekt. |
runs/ |
Ustawienia Claude Code każdego trwającego uruchomienia. Bez sekretów. Usuwane, gdy uruchomienie się kończy. |
runner.log |
Co zrobił runner, bez sekretów. |
state.json |
Identyfikatory trwających uruchomień. Po restarcie każde jest zgłaszane do Notiamo jako nieudane. |
Sekrety uruchomienia (hasła WordPressa, własne tokeny uruchomienia) przychodzą z Notiamo razem z uruchomieniem i żyją tylko w pamięci. Agent dostaje je jako zmienne środowiskowe, nigdy w pliku. To, co agent wypisuje, jest z nich oczyszczane, zanim zapis trafi do Notiamo.
Runner nigdy nie używa danych logowania gita z komputera. Każde uruchomienie dostaje z Notiamo token GitHub, który działa przez godzinę i tylko dla repozytorium uruchomienia. Runner trzyma go w pamięci i używa do własnego pobierania i wypychania. Pull request otwiera i scala Notiamo.
Zatrzymanie runnera
Na karcie Runnery naciśnij Wyłącz, by wstrzymać runnera, albo Usuń, by go usunąć. Token usuniętego runnera przestaje działać natychmiast.