Notiamo poate porni un agent AI pe comentariile și sarcinile deschise ale unui proiect. Agentul face modificările, iar o persoană din echipa dumneavoastră le aprobă. O rulare poate avea loc pe serverele Notiamo sau pe un calculator al dumneavoastră. Această pagină vorbește despre a doua variantă: runnerul, un mic program pe care îl instalați pe calculatorul dumneavoastră. Este pentru echipa agenției.
Ce este runnerul
Runnerul așteaptă rulările agentului pe care organizația dumneavoastră le pune în coadă în Notiamo. Pentru fiecare rulare, clonează depozitul (sau se conectează la site-ul WordPress), pornește Claude Code cu instrucțiunile rulării, trimite către Notiamo ce face agentul și anunță când se termină.
- Nu păstrează nicio credențială Claude. Pornește programul
claudedeja existent pe calculator. Sesiunile runnerului folosesc propriul dosar de configurare, separat de al dumneavoastră. Autentificarea în sine ține de Claude Code și este păstrată de Claude Code. - Nu este o autentificare Claude în interiorul Notiamo. Notiamo nu vă vede și nu vă folosește niciodată contul Claude. Runnerul doar rulează propriul dumneavoastră Claude Code, pe calculatorul dumneavoastră, pentru munca dumneavoastră.
Instalați-l
Aveți nevoie de:
- Node.js 22 sau mai nou;
- Claude Code 2.1.314 sau mai nou;
- git 2.31 sau mai nou;
- pe Linux și WSL2:
bubblewrapșisocat(Debian sau Ubuntu:sudo apt install bubblewrap socat). Pe macOS nu mai trebuie instalat nimic.
Apoi:
- În Notiamo, deschideți Setări › Rulări ale agentului. Pe cardul Runnere, apăsați Runner nou și dați-i un nume. Copiați tokenul. Se afișează o singură dată.
- Pe calculator, rulați:
npx @notiamo/runner init
- Lipiți tokenul.
initverifică dacă Claude Code funcționează, rulează autentificarea Claude Code pentru runner, apoi instalează serviciul și îl pornește. - În proiect, setați Unde rulează agentul pe Calculatorul propriu.
Când init se termină, runnerul rulează. Pornește din nou singur după o autentificare sau o repornire.
Comenzi
| Comandă | Ce face |
|---|---|
npx @notiamo/runner init |
Configurează runnerul: token, autentificarea Claude Code, instalează și pornește serviciul. |
npx @notiamo/runner@latest update |
Aduce runnerul la cea mai nouă versiune. Tokenul, numele și autentificarea rămân. |
npx @notiamo/runner status |
Spune dacă serviciul este instalat și rulează și arată ultima linie din jurnal. |
npx @notiamo/runner logs |
Arată ultimele 50 de linii din jurnal. |
npx @notiamo/runner stop |
Oprește serviciul până la următoarea autentificare sau pornire a calculatorului. |
npx @notiamo/runner uninstall |
Elimină serviciul. Dosarul runnerului rămâne. |
npx @notiamo/runner env <projectId> |
Creează sau arată fișierul env pe care acest calculator îl dă rulărilor unui proiect. |
npx @notiamo/runner start |
Rulează în prim-plan. Serviciul rulează asta; rareori aveți nevoie de ea. |
Serviciul este un agent launchd com.notiamo.runner pe macOS, o Sarcină programată „Notiamo runner” pe Windows și o unitate de utilizator systemd notiamo-runner pe Linux.
Două runnere pe același calculator
npx @notiamo/runner init --profile staging configurează un al doilea runner, separat. Are propriul dosar (~/.notiamo-runner/profiles/staging) și propriul serviciu. Adăugați --profile staging la fiecare comandă a acelui runner. Numele unui profil conține litere, cifre și cratime, de la 1 la 32 de caractere.
Ce poate și ce nu poate atinge agentul
Fiecare rulare primește propriul fișier de setări Claude Code. Trei lucruri țin agentul la locul lui.
Instrumentele pentru fișiere rămân în dosarul rulării. Instrumentele proprii ale lui Claude pentru fișiere (citire, editare, scriere, căutare) refuză tot ce este în afara dosarului rulării. Orice apel care ar cere permisiunea este refuzat, pentru că nu este nimeni care să răspundă.
Comenzile shell rulează în sandboxul sistemului de operare. Pe macOS (Seatbelt) și pe Linux sau WSL2 (bubblewrap și socat), fiecare comandă pe care agentul o rulează într-un shell este izolată. Dacă sandboxul nu poate porni, rularea nu pornește.
Nicio credențială a calculatorului nu ajunge la agent. Claude Code primește doar o listă scurtă de variabile de mediu (PATH, HOME, USER, LOGNAME, SHELL, LANG, LC_ALL, LC_CTYPE, TERM, TMPDIR, TZ, XDG_*, setările de proxy și de certificate), plus pe cele ale rulării. Nu primește niciodată SSH_AUTH_SOCK, GH_TOKEN, GITHUB_TOKEN, NPM_TOKEN, AWS_* sau ANTHROPIC_*. Git-ul agentului nu vede nicio configurare git globală sau de sistem.
Ce permite și ce refuză sandboxul shellului:
- Citire refuzată: dosarele altor proiecte (inclusiv ale altor rulări simultane), fișierele proprii ale runnerului și fișierele și dosarele dumneavoastră de credențiale (chei SSH, autentificări cloud, autentificări în registre de pachete, credențiale git).
- Scriere permisă: doar în dosarul rulării și în dosarul cache de pachete al proiectului, de lângă el.
.git/hooksși.git/configale rulării sunt doar pentru citire. - Rețea permisă: GitHub, npm, Notiamo, site-ul WordPress (pentru o rulare WordPress) și gazdele pe care le adăugați la Gazde suplimentare pe care agentul le poate accesa pe cardul Runnere. Tot restul este refuzat.
Agentul nu face niciodată push și nu păstrează credențiale. Runnerul face el însuși push ramurii rulării, după munca agentului.
Când o rulare se termină, runnerul oprește toate procesele pe care agentul le-a lăsat în urmă, de exemplu un server de dezvoltare.
Keychain pe macOS
Sandboxul macOS nu închide complet keychain-ul. Așa că nu păstrați nicio autentificare GitHub în keychain-ul utilizatorului care rulează runnerul (init avertizează când găsește una). Cea mai sigură variantă este un utilizator macOS dedicat, cu keychain propriu.
Windows
Windows simplu nu are sandbox pentru shell. Textul dintr-un comentariu ar putea atunci face ca o rulare să execute orice comandă în numele dumneavoastră. Rulați runnerul în WSL2. Pe Windows simplu, runnerul nu pornește decât dacă adăugați "allowUnsandboxed": true în config.json al lui; faceți asta doar pe un calculator pe care nu se află nimic altceva.
Mai multe rulări simultane
Pe cardul Runnere setați Rulări simultane: de la 1 la 3. Fiecare rulare folosește abonamentul dumneavoastră Claude, așa că păstrați numărul în limita a ceea ce permite abonamentul. Un proiect nu rulează niciodată de două ori în același timp: a doua rulare pe același proiect o așteaptă pe prima.
Fiecare rulare simultană are propriul dosar de slot. Sandboxul unei rulări nu poate citi celelalte sloturi.
Un runner pentru un client
Când creați un runner, îl puteți limita la un spațiu de lucru la Rulează pentru. Atunci preia doar rulările acelui client. Ca să îl configurați pe calculatorul clientului: instalați acolo Claude Code, rulați npx @notiamo/runner init și lipiți tokenul runnerului. Autentificarea Claude de pe acel calculator plătește rulările, așa că autentificați-vă cu contul care trebuie să plătească.
Comenzile de pregătire și de test
Un clon curat nu are pachete instalate. Spuneți agentului cum să le instaleze și cum să testeze. Deschideți setările agentului proiectului și completați Comandă de pregătire și Comandă de test, câte o linie fiecare.
- Agentul rulează comanda de pregătire o dată, înainte de prima modificare. Exemplu:
pnpm install --frozen-lockfile. - Agentul rulează comanda de test înaintea fiecărui commit. O modificare care o pică este corectată sau anulată. Exemplu:
pnpm typecheck && pnpm lint. - Agentul le rulează pe amândouă singur, în același sandbox ca celelalte comenzi ale sale. Registrul de pachete trebuie să fie printre gazdele permise. GitHub și
registry.npmjs.orgsunt acolo implicit. Adăugați oricare altul (PyPI, crates.io, un registru privat) la Gazde suplimentare pe care agentul le poate accesa pe cardul Runnere. - Fiecare proiect are un dosar cache de pachete lângă clonul său. npm, pnpm, Yarn, Corepack, Bun, pip, uv și Composer își țin acolo cache-urile, pentru că sandboxul închide locurile obișnuite din dosarul dumneavoastră personal. Dosarul rămâne între rulările proiectului și dispare odată cu clonul. Nu există pe Windows simplu.
- Păstrați comanda de test ușoară. Un test care are nevoie de Docker nu poate rula. Un test care are nevoie de o bază de date poate rula doar când fișierul env al proiectului trimite la una pe care o țineți pornită (vedeți mai jos).
Agentul face commit ca „Notiamo agent”, o linie simplă pentru fiecare element. Runnerul dezactivează trailerul „Co-Authored-By” și linia „Generated with” ale Claude Code, așa că depozitul nu arată niciun coautor AI.
Un mediu pentru propriile proiecte
O rulare pe un proiect GitHub primește un clon curat și nimic altceva. Pentru un proiect software al dumneavoastră, testele pot avea nevoie și de o bază de date, un spațiu pentru fișiere, un colector de e-mailuri și un .env. Calculatorul runnerului le dă rulărilor unui proiect printr-un simplu fișier:
npx @notiamo/runner env <projectId>
<projectId> este ultima parte a adresei paginii proiectului în Notiamo. Comanda creează ~/.notiamo-runner/env/<projectId>.env, care poate fi citit doar de dumneavoastră, și afișează calea. Puneți câte un KEY=VALUE pe linie. Următoarea rulare a acelui proiect primește variabilele în shell, iar agentului i se spun numele lor, niciodată valorile. Ștergeți fișierul ca să le eliminați. Fișierul nu părăsește niciodată calculatorul: Notiamo nu știe că există.
Cu fișierul prezent, shellul rulării poate ajunge și la servicii de pe 127.0.0.1 pe macOS: Postgres-ul dumneavoastră, un spațiu pentru fișiere, un server de dezvoltare. Dumneavoastră le țineți pornite; agentul nu le poate porni, iar Docker rămâne în afara razei lui. Pe Linux, sandboxul are propria rețea, deci 127.0.0.1 de acolo nu este al calculatorului: legați serviciile la adresa de rețea a calculatorului și adăugați acea gazdă la Gazde suplimentare pe care agentul le poate accesa.
Reguli:
- Doar valori de dezvoltare și de test. Agentul rulează comenzi shell și poate citi toate variabilele. Niciodată o cheie de producție, niciodată o parolă pe care o folosiți în altă parte.
PATH,HOME, variabilele de proxy și de certificate,NODE_OPTIONS,NODE_TLS_REJECT_UNAUTHORIZED,NOTIAMO_*,GIT_*,CLAUDE_*șiANTHROPIC_*sunt ignorate, iar jurnalul spune asta. Fișierul poate schimba ce văd comenzile agentului, niciodată cum comunică Claude Code cu Anthropic și cu Notiamo.- Valorile de 6 caractere sau mai mult sunt mascate ca
[secret]în transcrierea pe care o primește Notiamo. Valorile scurte (1,true) nu sunt. - Păstrați Rulări simultane pe 1 când proiectele unui runner folosesc în comun o bază de date prin fișierul lor env. Două rulări în același timp și-ar rula testele pe aceeași bază de date.
Site-uri WordPress
Conexiunea se află pe cardul Acces la site al proiectului: o parolă de aplicație și, opțional, SSH sau FTP. Runnerul reține cheia serverului SSH la prima vizită și refuză un server care arată mai târziu altă cheie. O rulare decurge așa:
- Copie de siguranță înainte. Cu SSH, runnerul exportă baza de date și o încarcă în Notiamo, comprimată, cel mult 200 MB. Notiamo o păstrează 30 de zile. Doar cu FTP sau cu API-ul nu există copie de siguranță.
- Agentul lucrează în limitele listei de permisiuni de mai jos.
- Verificarea site-ului după. Runnerul deschide site-ul și verifică dacă încă răspunde.
- Restaurare în caz de eșec. Dacă verificarea eșuează, runnerul restaurează baza de date.
Ce poate rula agentul cu wp-cli, pe grupe (se setează în proiect):
- Conținut:
post *,term *,menu *,media import,option get,option update. - Bază de date:
search-replace(doar textul vechi și cel nou; nu atinge niciodată tabelele de utilizatori și de opțiuni),cache flush,rewrite flush,transient delete. - Pluginuri și teme:
pluginșithemeculist,activate,deactivate,update. - Informații:
core version,site list,db size. - Fișiere: nicio comandă wp-cli; agentul folosește instrumentele lui pentru fișiere. Ele scriu stiluri, scripturi și alte fișiere pe care serverul nu le execută.
- Fișiere PHP (oprit implicit): instrumentele pentru fișiere pot scrie și PHP. Un fișier PHP este cod care rulează pe serverul dumneavoastră, iar o rulare WordPress nu are pas de aprobare: modificarea este live imediat. Porniți opțiunea doar pentru un site unde aveți încredere în toți cei care pot scrie un comentariu.
- Niciodată, decât dacă alegeți „Permiteți totul”:
eval,eval-file,shell,user *,db query|import|reset|drop|export,plugin install,theme install,core update|download.
Ce se păstrează unde
Totul se află în ~/.notiamo-runner.
| Cale | Ce conține |
|---|---|
config.json |
Adresa Notiamo, numele runnerului și tokenul runnerului. Poate fi citit doar de dumneavoastră. |
claude/ |
Dosarul de configurare al Claude Code pentru runner: autentificarea și sesiunile lui. |
projects/ |
Copiile de lucru ale proiectelor dumneavoastră, câte un dosar pe proiect în fiecare slot. Un proiect nefolosit timp de numărul de zile setat pe cardul Runnere este șters; următoarea rulare îl clonează din nou. |
git/ |
Copiile proprii ale runnerului după depozitele dumneavoastră. Agentul nu poate nici citi, nici scrie în acest dosar. |
env/ |
Fișierele env create de dumneavoastră, câte unul pe proiect. |
runs/ |
Setările Claude Code ale fiecărei rulări în curs. Fără secrete. Șterse când rularea se termină. |
runner.log |
Ce a făcut runnerul, fără secrete. |
state.json |
Id-urile rulărilor în curs. După o repornire, fiecare este raportată către Notiamo ca eșuată. |
Secretele unei rulări (parolele WordPress, tokenurile proprii ale rulării) vin de la Notiamo odată cu rularea și există doar în memorie. Agentul le primește ca variabile de mediu, niciodată într-un fișier. Ce afișează agentul este curățat de ele înainte ca transcrierea să fie încărcată.
Runnerul nu folosește niciodată credențialele git ale calculatorului. Fiecare rulare primește de la Notiamo un token GitHub care e valabil o oră și doar pentru depozitul rulării. Runnerul îl ține în memorie și îl folosește pentru propriile fetch și push. Notiamo deschide și îmbină pull request-ul.
Opriți un runner
Pe cardul Runnere, apăsați Opriți ca să puneți un runner în pauză sau Ștergeți ca să îl eliminați. Tokenul unui runner șters nu mai funcționează imediat.