Notiamo kann einen KI-Agenten auf die offenen Kommentare und Aufgaben eines Projekts ansetzen. Der Agent nimmt die Änderungen vor, und eine Person aus Ihrem Team gibt sie frei. Ein Lauf kann auf den Servern von Notiamo stattfinden oder auf einem Computer, der Ihnen gehört. Diese Seite behandelt den zweiten Weg: den Runner, ein kleines Programm, das Sie auf Ihrem Rechner installieren. Er ist für das Agenturteam.
Was der Runner ist
Der Runner wartet auf die Agent-Läufe, die Ihre Organisation in Notiamo einreiht. Für jeden Lauf klont er das Repository (oder verbindet sich mit der WordPress-Website), startet Claude Code mit den Anweisungen des Laufs, schickt Notiamo, was der Agent tut, und meldet, wenn der Lauf endet.
- Er hält keine Claude-Zugangsdaten. Er startet das Programm
claude, das schon auf dem Rechner liegt. Die Sitzungen des Runners nutzen einen eigenen Konfigurationsordner und bleiben so von Ihren getrennt. Die Anmeldung selbst gehört zu Claude Code und wird von Claude Code verwahrt. - Er ist keine Claude-Anmeldung innerhalb von Notiamo. Notiamo sieht oder nutzt Ihr Claude-Konto nie. Der Runner führt nur Ihr eigenes Claude Code aus, auf Ihrem Rechner, für Ihre eigene Arbeit.
Installation
Sie brauchen:
- Node.js 22 oder neuer;
- Claude Code 2.1.314 oder neuer;
- git 2.31 oder neuer;
- unter Linux und WSL2:
bubblewrapundsocat(Debian oder Ubuntu:sudo apt install bubblewrap socat). Unter macOS müssen Sie nichts weiter installieren.
Dann:
- Öffnen Sie in Notiamo Einstellungen › Agent-Durchläufe. Klicken Sie auf der Karte Runner auf Neuer Runner und geben Sie ihm einen Namen. Kopieren Sie den Token. Er wird nur einmal angezeigt.
- Führen Sie auf dem Rechner aus:
npx @notiamo/runner init
- Fügen Sie den Token ein.
initprüft, ob Claude Code funktioniert, startet die Anmeldung von Claude Code für den Runner, installiert dann den Dienst und startet ihn. - Stellen Sie im Projekt Wo der Agent läuft auf Eigener Rechner.
Wenn init fertig ist, läuft der Runner. Er startet nach einer Anmeldung oder einem Neustart von selbst wieder.
Befehle
| Befehl | Was er tut |
|---|---|
npx @notiamo/runner init |
Richtet den Runner ein: Token, Claude-Code-Anmeldung, Dienst installieren und starten. |
npx @notiamo/runner@latest update |
Bringt den Runner auf die neueste Version. Token, Name und Anmeldung bleiben erhalten. |
npx @notiamo/runner status |
Zeigt, ob der Dienst installiert ist und läuft, und die letzte Logzeile. |
npx @notiamo/runner logs |
Zeigt die letzten 50 Zeilen des Logs. |
npx @notiamo/runner stop |
Stoppt den Dienst bis zur nächsten Anmeldung oder zum nächsten Start. |
npx @notiamo/runner uninstall |
Entfernt den Dienst. Der Ordner des Runners bleibt. |
npx @notiamo/runner env <projectId> |
Erstellt oder zeigt die Env-Datei, die dieser Rechner den Läufen eines Projekts mitgibt. |
npx @notiamo/runner start |
Läuft im Vordergrund. Der Dienst führt das aus; Sie brauchen es selten. |
Der Dienst ist ein launchd-Agent com.notiamo.runner unter macOS, eine geplante Aufgabe “Notiamo runner” unter Windows und eine systemd-Benutzereinheit notiamo-runner unter Linux.
Zwei Runner auf einem Rechner
npx @notiamo/runner init --profile staging richtet einen zweiten, getrennten Runner ein. Er hat einen eigenen Ordner (~/.notiamo-runner/profiles/staging) und einen eigenen Dienst. Hängen Sie --profile staging an jeden Befehl dieses Runners an. Ein Profilname besteht aus Buchstaben, Ziffern und Bindestrichen, 1 bis 32 Zeichen.
Was der Agent berühren darf und was nicht
Jeder Lauf bekommt eine eigene Einstellungsdatei für Claude Code. Drei Dinge halten den Agenten in seinen Grenzen.
Die Dateiwerkzeuge bleiben im Ordner des Laufs. Die eigenen Dateiwerkzeuge von Claude (lesen, bearbeiten, schreiben, suchen) lehnen alles außerhalb des Ordners des Laufs ab. Jeder Aufruf, der um Erlaubnis bitten würde, wird abgelehnt, weil niemand da ist, der antwortet.
Shell-Befehle laufen in der Sandbox des Betriebssystems. Unter macOS (Seatbelt) und unter Linux oder WSL2 (bubblewrap und socat) ist jeder Befehl, den der Agent in einer Shell ausführt, eingeschränkt. Wenn die Sandbox nicht starten kann, startet der Lauf nicht.
Keine Zugangsdaten des Rechners erreichen den Agenten. Claude Code bekommt nur eine kurze Liste von Umgebungsvariablen (PATH, HOME, USER, LOGNAME, SHELL, LANG, LC_ALL, LC_CTYPE, TERM, TMPDIR, TZ, XDG_*, die Proxy- und Zertifikatseinstellungen) plus die des Laufs selbst. Es bekommt nie SSH_AUTH_SOCK, GH_TOKEN, GITHUB_TOKEN, NPM_TOKEN, AWS_* oder ANTHROPIC_*. Das git des Agenten sieht keine globale oder systemweite git-Konfiguration.
Was die Shell-Sandbox erlaubt und verbietet:
- Lesen verboten: die Ordner anderer Projekte (auch von Läufen, die gleichzeitig laufen), die eigenen Dateien des Runners und Ihre Dateien und Ordner mit Zugangsdaten (SSH-Schlüssel, Cloud-Anmeldungen, Anmeldungen bei Paket-Registries, git-Zugangsdaten).
- Schreiben erlaubt: nur im Ordner des Laufs und im Paket-Cache-Ordner des Projekts daneben.
.git/hooksund.git/configdes Laufs sind schreibgeschützt. - Netzwerk erlaubt: GitHub, npm, Notiamo, die WordPress-Website (bei einem WordPress-Lauf) und die Hosts, die Sie auf der Karte Runner unter Weitere Hosts, die der Agent erreichen darf hinzufügen. Alles andere wird abgelehnt.
Der Agent pusht nie und hält keine Zugangsdaten. Den Branch des Laufs pusht der Runner nach der Arbeit des Agenten selbst.
Wenn ein Lauf endet, beendet der Runner alle Prozesse, die der Agent zurückgelassen hat, etwa einen Entwicklungsserver.
Der Schlüsselbund unter macOS
Die Sandbox unter macOS schließt den Schlüsselbund nicht vollständig. Legen Sie deshalb keine GitHub-Anmeldung im Schlüsselbund des Benutzers ab, der den Runner ausführt (init warnt, wenn es eine findet). Am sichersten ist ein eigener macOS-Benutzer mit eigenem Schlüsselbund.
Windows
Das normale Windows hat keine Shell-Sandbox. Text in einem Kommentar könnte einen Lauf dann dazu bringen, jeden Befehl in Ihrem Namen auszuführen. Führen Sie den Runner in WSL2 aus. Unter normalem Windows startet der Runner nur, wenn Sie "allowUnsandboxed": true in seine config.json eintragen; tun Sie das nur auf einem Rechner, auf dem sonst nichts liegt.
Mehrere Läufe gleichzeitig
Auf der Karte Runner stellen Sie Gleichzeitige Läufe ein: 1 bis 3. Jeder Lauf nutzt Ihren Claude-Tarif, halten Sie die Zahl also so, dass der Tarif Platz dafür hat. Ein Projekt läuft nie zweimal gleichzeitig: Ein zweiter Lauf im selben Projekt wartet auf den ersten.
Jeder gleichzeitige Lauf hat einen eigenen Slot-Ordner. Die Sandbox eines Laufs kann die anderen Slots nicht lesen.
Ein Runner für einen Kunden
Wenn Sie einen Runner anlegen, können Sie ihn unter Läuft für auf einen Arbeitsbereich beschränken. Dann nimmt er nur die Läufe dieses Kunden an. So richten Sie ihn auf dem Computer des Kunden ein: Installieren Sie dort Claude Code, führen Sie npx @notiamo/runner init aus und fügen Sie den Token des Runners ein. Die Claude-Anmeldung auf diesem Computer bezahlt die Läufe, melden Sie sich also mit dem Konto an, das zahlen soll.
Setup- und Test-Befehle
Ein frischer Klon hat keine installierten Pakete. Sagen Sie dem Agenten, wie er sie installiert und wie er testet. Öffnen Sie die Agent-Einstellungen des Projekts und füllen Sie Setup-Befehl und Test-Befehl aus, je eine Zeile.
- Der Agent führt den Setup-Befehl einmal aus, vor seiner ersten Änderung. Beispiel:
pnpm install --frozen-lockfile. - Der Agent führt den Test-Befehl vor jedem Commit aus. Eine Änderung, die ihn nicht besteht, wird korrigiert oder rückgängig gemacht. Beispiel:
pnpm typecheck && pnpm lint. - Der Agent führt beide selbst aus, in derselben Sandbox wie seine anderen Befehle. Die Paketquelle muss zu den erlaubten Hosts gehören. GitHub und
registry.npmjs.orgsind standardmäßig dabei. Weitere (PyPI, crates.io, eine private Registry) fügen Sie auf der Karte Runner unter Weitere Hosts, die der Agent erreichen darf hinzu. - Jedes Projekt hat neben seinem Klon einen Paket-Cache-Ordner. npm, pnpm, Yarn, Corepack, Bun, pip, uv und Composer legen ihre Caches dort ab, weil die Sandbox die üblichen Orte in Ihrem Home-Ordner sperrt. Der Ordner bleibt zwischen den Läufen des Projekts erhalten und verschwindet mit dem Klon. Unter dem normalen Windows gibt es ihn nicht.
- Halten Sie den Test-Befehl leicht. Ein Test, der Docker braucht, kann nicht laufen. Ein Test, der eine Datenbank braucht, kann nur laufen, wenn die Env-Datei des Projekts auf eine zeigt, die Sie laufen lassen (siehe unten).
Der Agent committet als “Notiamo agent”, eine schlichte Zeile pro Punkt. Der Runner schaltet den Trailer “Co-Authored-By” und die Zeile “Generated with” von Claude Code aus, sodass das Repository keinen KI-Co-Autor zeigt.
Eine Umgebung für Ihre eigenen Projekte
Ein Lauf in einem GitHub-Projekt bekommt einen sauberen Klon und sonst nichts. Bei einem eigenen Softwareprojekt brauchen die Tests vielleicht auch eine Datenbank, einen Dateispeicher, einen Mail-Catcher und eine .env. Der Runner-Rechner gibt sie den Läufen eines Projekts mit einer einfachen Datei:
npx @notiamo/runner env <projectId>
<projectId> ist der letzte Teil der Adresse der Projektseite in Notiamo. Der Befehl erstellt ~/.notiamo-runner/env/<projectId>.env, nur für Sie lesbar, und gibt den Pfad aus. Schreiben Sie ein KEY=VALUE pro Zeile. Der nächste Lauf dieses Projekts bekommt die Variablen in seiner Shell, und dem Agenten werden ihre Namen genannt, nie die Werte. Löschen Sie die Datei, um sie zu entfernen. Die Datei verlässt den Rechner nie: Notiamo weiß nicht, dass es sie gibt.
Mit der Datei darf die Shell des Laufs unter macOS auch Dienste auf 127.0.0.1 erreichen: Ihr Postgres, einen Dateispeicher, einen Entwicklungsserver. Sie lassen sie laufen; der Agent kann sie nicht starten, und Docker bleibt außerhalb seiner Reichweite. Unter Linux hat die Sandbox ein eigenes Netzwerk, 127.0.0.1 ist dort also nicht der des Rechners: Binden Sie die Dienste an die Netzwerkadresse des Rechners und fügen Sie diesen Host unter Weitere Hosts, die der Agent erreichen darf hinzu.
Regeln:
- Nur Entwicklungs- und Testwerte. Der Agent führt Shell-Befehle aus und kann jede Variable lesen. Nie ein Produktionsschlüssel, nie ein Passwort, das Sie anderswo nutzen.
PATH,HOME, die Proxy- und Zertifikatsvariablen,NODE_OPTIONS,NODE_TLS_REJECT_UNAUTHORIZED,NOTIAMO_*,GIT_*,CLAUDE_*undANTHROPIC_*werden ignoriert, und das Log sagt das. Die Datei kann ändern, was die Befehle des Agenten sehen, nie aber, wie Claude Code mit Anthropic und Notiamo spricht.- Werte ab 6 Zeichen werden im Transkript, das Notiamo erhält, als
[secret]maskiert. Kurze Werte (1,true) nicht. - Lassen Sie Gleichzeitige Läufe auf 1, wenn sich die Projekte eines Runners über ihre Env-Datei eine Datenbank teilen. Zwei gleichzeitige Läufe würden ihre Tests auf derselben Datenbank ausführen.
WordPress-Websites
Die Verbindung liegt auf der Karte Zugriff auf die Website des Projekts: ein Anwendungspasswort und optional SSH oder FTP. Der Runner merkt sich beim ersten Besuch den Schlüssel des SSH-Servers und lehnt einen Server ab, der später einen anderen Schlüssel zeigt. Ein Lauf geht so:
- Sicherung davor. Mit SSH exportiert der Runner die Datenbank und lädt sie komprimiert zu Notiamo hoch, höchstens 200 MB. Notiamo bewahrt sie 30 Tage auf. Mit FTP oder nur der API gibt es keine Sicherung.
- Der Agent arbeitet mit der Erlaubnisliste unten.
- Website-Prüfung danach. Der Runner öffnet die Website und prüft, ob sie noch antwortet.
- Wiederherstellung bei Fehler. Besteht die Prüfung nicht, stellt der Runner die Datenbank wieder her.
Was der Agent mit wp-cli ausführen darf, je Gruppe (im Projekt festgelegt):
- Inhalte:
post *,term *,menu *,media import,option get,option update. - Datenbank:
search-replace(nur der alte und der neue Text; die Benutzer- und die Optionstabellen berührt es nie),cache flush,rewrite flush,transient delete. - Plugins und Themes:
pluginundthememitlist,activate,deactivate,update. - Informationen:
core version,site list,db size. - Dateien: kein wp-cli-Befehl; der Agent nutzt seine Dateiwerkzeuge. Sie schreiben Styles, Skripte und andere Dateien, die der Server nicht ausführt.
- PHP-Dateien (standardmäßig aus): Die Dateiwerkzeuge dürfen auch PHP schreiben. Eine PHP-Datei ist Code, der auf Ihrem Server läuft, und ein WordPress-Lauf hat keinen Freigabeschritt: Die Änderung ist sofort live. Schalten Sie das nur für eine Website ein, bei der Sie allen vertrauen, die einen Kommentar schreiben können.
- Nie, außer Sie wählen “Alles erlauben”:
eval,eval-file,shell,user *,db query|import|reset|drop|export,plugin install,theme install,core update|download.
Was wo gespeichert ist
Alles liegt in ~/.notiamo-runner.
| Pfad | Was er enthält |
|---|---|
config.json |
Die Adresse von Notiamo, den Namen des Runners und den Runner-Token. Nur für Sie lesbar. |
claude/ |
Den Konfigurationsordner von Claude Code für den Runner: seine Anmeldung und seine Sitzungen. |
projects/ |
Die Arbeitskopien Ihrer Projekte, ein Ordner pro Projekt in jedem Slot. Ein Projekt, das so viele Tage nicht genutzt wurde, wie auf der Karte Runner eingestellt, wird entfernt; der nächste Lauf klont es neu. |
git/ |
Die eigenen Kopien Ihrer Repositories durch den Runner. Der Agent kann diesen Ordner weder lesen noch beschreiben. |
env/ |
Die Env-Dateien, die Sie erstellt haben, eine pro Projekt. |
runs/ |
Die Claude-Code-Einstellungen jedes laufenden Laufs. Kein Geheimnis. Wird gelöscht, wenn der Lauf endet. |
runner.log |
Was der Runner getan hat, ohne Geheimnisse. |
state.json |
Die IDs der laufenden Läufe. Nach einem Neustart wird jeder bei Notiamo als fehlgeschlagen gemeldet. |
Die Geheimnisse eines Laufs (WordPress-Passwörter, die eigenen Token des Laufs) kommen mit dem Lauf von Notiamo und liegen nur im Arbeitsspeicher. Der Agent bekommt sie als Umgebungsvariablen, nie in einer Datei. Was der Agent ausgibt, wird davon bereinigt, bevor das Transkript hochgeladen wird.
Der Runner nutzt nie die git-Zugangsdaten des Rechners. Jeder Lauf bekommt von Notiamo ein GitHub-Token, das eine Stunde lang und nur für das Repository des Laufs gilt. Der Runner hält es im Arbeitsspeicher und nutzt es für sein eigenes Fetch und Push. Notiamo öffnet den Pull Request und führt ihn zusammen.
Einen Runner stoppen
Klicken Sie auf der Karte Runner auf Deaktivieren, um einen Runner zu pausieren, oder auf Löschen, um ihn zu entfernen. Der Token eines gelöschten Runners funktioniert sofort nicht mehr.