Notiamo peut lancer un agent IA sur les commentaires et les tâches ouverts d’un projet. L’agent fait les modifications, et une personne de votre équipe les approuve. Une exécution peut avoir lieu sur les serveurs de Notiamo, ou sur un ordinateur qui vous appartient. Cette page parle de la seconde voie : le runner, un petit programme que vous installez sur votre machine. Elle s’adresse à l’équipe de l’agence.

Ce qu’est le runner

Le runner attend les exécutions de l’agent que votre organisation met en file d’attente dans Notiamo. Pour chaque exécution, il clone le dépôt (ou se connecte au site WordPress), lance Claude Code avec les instructions de l’exécution, envoie à Notiamo ce que fait l’agent, puis signale la fin.

  • Il ne détient aucun identifiant Claude. Il lance le programme claude déjà présent sur la machine. Les sessions du runner utilisent leur propre dossier de configuration, elles restent donc séparées des vôtres. La connexion elle-même appartient à Claude Code, qui la conserve.
  • Ce n’est pas une connexion Claude dans Notiamo. Notiamo ne voit jamais votre compte Claude et ne l’utilise jamais. Le runner ne fait que lancer votre propre Claude Code, sur votre machine, pour votre propre travail.

L’installer

Il vous faut :

  • Node.js 22 ou une version plus récente ;
  • Claude Code 2.1.314 ou plus récent ;
  • git 2.31 ou plus récent ;
  • sous Linux et WSL2 : bubblewrap et socat (Debian ou Ubuntu : sudo apt install bubblewrap socat). Sous macOS, il n’y a rien de plus à installer.

Ensuite :

  1. Dans Notiamo, ouvrez Paramètres › Exécutions de l’agent. Sur la carte Runners, cliquez sur Nouveau runner et donnez-lui un nom. Copiez le jeton. Il n’est affiché qu’une fois.
  2. Sur la machine, lancez :
npx @notiamo/runner init
  1. Collez le jeton. init vérifie que Claude Code fonctionne, lance la connexion de Claude Code pour le runner, puis installe le service et le démarre.
  2. Sur le projet, réglez Où l’agent s’exécute sur Votre propre machine.

Quand init se termine, le runner tourne. Il redémarre de lui-même après une ouverture de session ou un redémarrage.

Commandes

Commande Ce qu’elle fait
npx @notiamo/runner init Configure le runner : jeton, connexion à Claude Code, installation et démarrage du service.
npx @notiamo/runner@latest update Passe le runner à la dernière version. Le jeton, le nom et la connexion restent.
npx @notiamo/runner status Indique si le service est installé et en marche, et affiche la dernière ligne du journal.
npx @notiamo/runner logs Affiche les 50 dernières lignes du journal.
npx @notiamo/runner stop Arrête le service jusqu’à la prochaine ouverture de session ou au prochain démarrage.
npx @notiamo/runner uninstall Supprime le service. Le dossier du runner reste.
npx @notiamo/runner env <projectId> Crée ou affiche le fichier d’environnement que cette machine donne aux exécutions d’un projet.
npx @notiamo/runner start S’exécute au premier plan. Le service lance cette commande ; vous en avez rarement besoin.

Le service est un agent launchd com.notiamo.runner sous macOS, une tâche planifiée « Notiamo runner » sous Windows, et une unité utilisateur systemd notiamo-runner sous Linux.

Deux runners sur une même machine

npx @notiamo/runner init --profile staging configure un second runner, indépendant. Il a son propre dossier (~/.notiamo-runner/profiles/staging) et son propre service. Ajoutez --profile staging à chaque commande de ce runner. Un nom de profil comporte des lettres, des chiffres et des tirets, de 1 à 32 caractères.

Ce que l’agent peut et ne peut pas toucher

Chaque exécution reçoit son propre fichier de paramètres Claude Code. Trois mécanismes maintiennent l’agent à sa place.

Les outils de fichiers restent dans le dossier de l’exécution. Les outils de fichiers de Claude (lire, modifier, écrire, chercher) refusent tout ce qui se trouve hors du dossier de l’exécution. Tout appel qui demanderait une autorisation est refusé, car personne n’est là pour répondre.

Les commandes du shell s’exécutent dans le bac à sable du système d’exploitation. Sous macOS (Seatbelt) et sous Linux ou WSL2 (bubblewrap et socat), chaque commande que l’agent lance dans un shell est confinée. Si le bac à sable ne peut pas démarrer, l’exécution ne démarre pas.

Aucun identifiant de la machine n’arrive jusqu’à l’agent. Claude Code reçoit seulement une courte liste de variables d’environnement (PATH, HOME, USER, LOGNAME, SHELL, LANG, LC_ALL, LC_CTYPE, TERM, TMPDIR, TZ, XDG_*, les réglages de proxy et de certificats) plus celles de l’exécution. Il ne reçoit jamais SSH_AUTH_SOCK, GH_TOKEN, GITHUB_TOKEN, NPM_TOKEN, AWS_* ni ANTHROPIC_*. Le git de l’agent ne voit aucune configuration git globale ou système.

Ce que le bac à sable du shell autorise et refuse :

  • Lectures refusées : les dossiers des autres projets (y compris ceux des autres exécutions en même temps), les fichiers du runner, et vos fichiers et dossiers d’identifiants (clés SSH, connexions cloud, connexions aux registres de paquets, identifiants git).
  • Écritures autorisées : uniquement dans le dossier de l’exécution et dans le dossier de cache des paquets du projet, juste à côté. Les dossiers .git/hooks et .git/config de l’exécution sont en lecture seule.
  • Réseau autorisé : GitHub, npm, Notiamo, le site WordPress (pour une exécution WordPress) et les hôtes que vous ajoutez sous Hôtes supplémentaires accessibles à l’agent sur la carte Runners. Tout le reste est refusé.

L’agent ne pousse jamais et ne détient aucun identifiant. Le runner pousse lui-même la branche de l’exécution après le travail de l’agent.

Quand une exécution se termine, le runner arrête tous les processus que l’agent a laissés, comme un serveur de développement.

Le trousseau sous macOS

Le bac à sable de macOS ne ferme pas complètement le trousseau. Ne gardez donc aucune connexion GitHub dans le trousseau de l’utilisateur qui exécute le runner (init vous avertit s’il en trouve une). La configuration la plus sûre est un utilisateur macOS dédié, avec son propre trousseau.

Windows

Windows seul n’a pas de bac à sable pour le shell. Le texte d’un commentaire pourrait alors faire exécuter n’importe quelle commande en votre nom. Exécutez le runner dans WSL2. Sous Windows seul, le runner ne démarre pas, sauf si vous ajoutez "allowUnsandboxed": true à son config.json ; ne le faites que sur une machine qui ne contient rien d’autre.

Plusieurs exécutions à la fois

Sur la carte Runners, vous réglez Exécutions simultanées : de 1 à 3. Chaque exécution consomme votre formule Claude, limitez donc le nombre à ce que la formule peut supporter. Un projet ne tourne jamais deux fois en même temps : une seconde exécution sur le même projet attend la fin de la première.

Chaque exécution simultanée a son propre dossier d’emplacement. Le bac à sable d’une exécution ne peut pas lire les autres emplacements.

Un runner pour un seul client

Quand vous créez un runner, vous pouvez le limiter à un espace de travail sous Fonctionne pour. Il ne prend alors que les exécutions de ce client. Pour le configurer sur l’ordinateur du client : installez-y Claude Code, lancez npx @notiamo/runner init et collez le jeton du runner. C’est la connexion Claude de cet ordinateur qui paie les exécutions ; connectez-vous donc avec le compte qui doit payer.

Commandes de préparation et de test

Un clone propre n’a aucun paquet installé. Dites à l’agent comment les installer et comment tester. Ouvrez les paramètres d’agent du projet et remplissez Commande de préparation et Commande de test, une ligne chacune.

  • L’agent exécute la commande de préparation une fois, avant sa première modification. Exemple : pnpm install --frozen-lockfile.
  • L’agent exécute la commande de test avant chaque commit. Une modification qui échoue au test est corrigée ou annulée. Exemple : pnpm typecheck && pnpm lint.
  • L’agent exécute les deux lui-même, dans le même bac à sable que ses autres commandes. Le registre de paquets doit figurer parmi les hôtes autorisés. GitHub et registry.npmjs.org y sont par défaut. Ajoutez tout autre registre (PyPI, crates.io, un registre privé) sous Hôtes supplémentaires accessibles à l’agent sur la carte Runners.
  • Chaque projet a un dossier de cache des paquets à côté de son clone. npm, pnpm, Yarn, Corepack, Bun, pip, uv et Composer y gardent leurs caches, car le bac à sable ferme les emplacements habituels de votre dossier personnel. Le dossier reste entre les exécutions du projet et disparaît avec le clone. Il n’existe pas sous Windows seul.
  • Gardez la commande de test légère. Un test qui a besoin de Docker ne peut pas s’exécuter. Un test qui a besoin d’une base de données ne peut s’exécuter que si le fichier d’environnement du projet pointe vers une base que vous laissez en marche (voir plus bas).

L’agent fait ses commits sous le nom « Notiamo agent », une ligne simple par élément. Le runner désactive la ligne « Co-Authored-By » et la mention « Generated with » de Claude Code, de sorte que le dépôt n’affiche aucun co-auteur IA.

Un environnement pour vos propres projets

Une exécution sur un projet GitHub reçoit un clone propre et rien d’autre. Pour un projet logiciel qui est le vôtre, les tests peuvent aussi avoir besoin d’une base de données, d’un stockage de fichiers, d’un récepteur d’e-mails et d’un .env. La machine du runner les donne aux exécutions d’un projet au moyen d’un simple fichier :

npx @notiamo/runner env <projectId>

<projectId> est la dernière partie de l’adresse de la page du projet dans Notiamo. La commande crée ~/.notiamo-runner/env/<projectId>.env, lisible par vous seul, et affiche le chemin. Mettez une ligne KEY=VALUE par variable. La prochaine exécution de ce projet reçoit les variables dans son shell, et l’agent en connaît les noms, jamais les valeurs. Supprimez le fichier pour les retirer. Le fichier ne quitte jamais la machine : Notiamo ignore son existence.

Quand le fichier est présent, le shell de l’exécution peut aussi atteindre des services sur 127.0.0.1 sous macOS : votre Postgres, un stockage de fichiers, un serveur de développement. Vous les gardez en marche ; l’agent ne peut pas les démarrer, et Docker reste hors de sa portée. Sous Linux, le bac à sable a son propre réseau, donc 127.0.0.1 n’y est pas celui de la machine : liez les services à l’adresse réseau de la machine et ajoutez cet hôte sous Hôtes supplémentaires accessibles à l’agent.

Règles :

  • Uniquement des valeurs de développement et de test. L’agent exécute des commandes shell et peut lire chaque variable. Jamais une clé de production, jamais un mot de passe que vous utilisez ailleurs.
  • PATH, HOME, les variables de proxy et de certificats, NODE_OPTIONS, NODE_TLS_REJECT_UNAUTHORIZED, NOTIAMO_*, GIT_*, CLAUDE_* et ANTHROPIC_* sont ignorés, et le journal le signale. Le fichier peut changer ce que voient les commandes de l’agent, jamais la façon dont Claude Code parle à Anthropic et à Notiamo.
  • Les valeurs de 6 caractères ou plus sont masquées en [secret] dans la transcription que Notiamo reçoit. Les valeurs courtes (1, true) ne le sont pas.
  • Gardez Exécutions simultanées à 1 quand les projets d’un runner partagent une base de données par leur fichier d’environnement. Deux exécutions en même temps lanceraient leurs tests sur la même base.

Sites WordPress

La connexion se règle sur la carte Accès au site web du projet : un mot de passe d’application, et en option SSH ou FTP. Le runner retient la clé du serveur SSH à sa première visite et refuse un serveur qui présente ensuite une autre clé. Une exécution se déroule ainsi :

  1. Sauvegarde avant. Avec SSH, le runner exporte la base de données et l’envoie à Notiamo, compressée, 200 Mo au maximum. Notiamo la conserve 30 jours. Avec FTP ou l’API seule, il n’y a pas de sauvegarde.
  2. L’agent travaille selon la liste d’autorisations ci-dessous.
  3. Vérification du site après. Le runner ouvre le site et vérifie qu’il répond toujours.
  4. Restauration en cas d’échec. Si la vérification échoue, le runner restaure la base de données.

Ce que l’agent peut exécuter avec wp-cli, par groupe (réglé sur le projet) :

  • Contenu : post *, term *, menu *, media import, option get, option update.
  • Base de données : search-replace (l’ancien et le nouveau texte seulement ; elle ne touche jamais aux tables des utilisateurs ni des options), cache flush, rewrite flush, transient delete.
  • Extensions et thèmes : plugin et theme avec list, activate, deactivate, update.
  • Informations : core version, site list, db size.
  • Fichiers : aucune commande wp-cli ; l’agent utilise ses outils de fichiers. Ils écrivent des styles, des scripts et d’autres fichiers que le serveur n’exécute pas.
  • Fichiers PHP (désactivé par défaut) : les outils de fichiers peuvent aussi écrire du PHP. Un fichier PHP est du code qui s’exécute sur votre serveur, et une exécution WordPress n’a pas d’étape de validation : la modification est en ligne tout de suite. Activez-le seulement pour un site où vous faites confiance à toutes les personnes qui peuvent écrire un commentaire.
  • Jamais, sauf si vous choisissez « Tout autoriser » : eval, eval-file, shell, user *, db query|import|reset|drop|export, plugin install, theme install, core update|download.

Ce qui est stocké où

Tout se trouve dans ~/.notiamo-runner.

Chemin Ce qu’il contient
config.json L’adresse de Notiamo, le nom du runner et le jeton du runner. Lisible par vous seul.
claude/ Le dossier de configuration de Claude Code pour le runner : sa connexion et ses sessions.
projects/ Les copies de travail de vos projets, un dossier par projet dans chaque emplacement. Un projet inutilisé pendant le nombre de jours réglé sur la carte Runners est supprimé ; la prochaine exécution le clone de nouveau.
git/ Les copies de vos dépôts propres au runner. L’agent ne peut ni lire ni écrire ce dossier.
env/ Les fichiers d’environnement que vous avez créés, un par projet.
runs/ Les paramètres Claude Code de chaque exécution en cours. Aucun secret. Supprimé à la fin de l’exécution.
runner.log Ce que le runner a fait, sans secrets.
state.json Les identifiants des exécutions en cours. Après un redémarrage, chacune est signalée à Notiamo comme échouée.

Les secrets d’une exécution (mots de passe WordPress, jetons propres à l’exécution) viennent de Notiamo avec l’exécution et ne vivent qu’en mémoire. L’agent les reçoit comme variables d’environnement, jamais dans un fichier. Ce que l’agent affiche en est nettoyé avant l’envoi de la transcription.

Le runner n’utilise jamais les identifiants git de la machine. Chaque exécution reçoit de Notiamo un jeton GitHub valable une heure et seulement pour le dépôt de l’exécution. Le runner le garde en mémoire et l’utilise pour son propre fetch et son propre push. Notiamo ouvre et fusionne la pull request.

Arrêter un runner

Sur la carte Runners, cliquez sur Désactiver pour mettre un runner en pause, ou sur Supprimer pour le retirer. Le jeton d’un runner supprimé cesse de fonctionner aussitôt.