Notiamo puede iniciar un agente de IA sobre los comentarios y las tareas abiertos de un proyecto. El agente hace los cambios y una persona de su equipo los aprueba. Una ejecución puede hacerse en los servidores de Notiamo o en un ordenador de su propiedad. Esta página trata de la segunda forma: el runner, un programa pequeño que usted instala en su equipo. Es para el equipo de la agencia.

Qué es el runner

El runner espera las ejecuciones del agente que su organización pone en cola en Notiamo. Para cada ejecución clona el repositorio (o se conecta al sitio de WordPress), inicia Claude Code con las instrucciones de la ejecución, envía a Notiamo lo que hace el agente y avisa cuando termina.

  • No guarda ninguna credencial de Claude. Inicia el programa claude que ya está en el equipo. Las sesiones del runner usan su propia carpeta de configuración, así que quedan aparte de las suyas. El inicio de sesión en sí es de Claude Code, que lo guarda.
  • No es un inicio de sesión de Claude dentro de Notiamo. Notiamo nunca ve ni usa su cuenta de Claude. El runner solo ejecuta su propio Claude Code, en su equipo, para su propio trabajo.

Instálelo

Necesita:

  • Node.js 22 o posterior;
  • Claude Code 2.1.314 o más reciente;
  • git 2.31 o más reciente;
  • en Linux y WSL2: bubblewrap y socat (Debian o Ubuntu: sudo apt install bubblewrap socat). En macOS no hay que instalar nada más.

Después:

  1. En Notiamo, abra Ajustes › Ejecuciones del agente. En la tarjeta Runners, pulse Nuevo runner y póngale un nombre. Copie el token. Solo se muestra una vez.
  2. En el equipo, ejecute:
npx @notiamo/runner init
  1. Pegue el token. init comprueba que Claude Code funciona, ejecuta el inicio de sesión de Claude Code para el runner, instala el servicio y lo inicia.
  2. En el proyecto, ponga Dónde se ejecuta el agente en Equipo propio.

Cuando init termina, el runner está en marcha. Vuelve a arrancar solo tras iniciar sesión o reiniciar.

Comandos

Comando Qué hace
npx @notiamo/runner init Configura el runner: token, inicio de sesión de Claude Code, instalación e inicio del servicio.
npx @notiamo/runner@latest update Pasa el runner a la versión más reciente. El token, el nombre y el inicio de sesión se conservan.
npx @notiamo/runner status Indica si el servicio está instalado y en marcha, y muestra la última línea del registro.
npx @notiamo/runner logs Muestra las últimas 50 líneas del registro.
npx @notiamo/runner stop Detiene el servicio hasta el próximo inicio de sesión o arranque.
npx @notiamo/runner uninstall Elimina el servicio. La carpeta del runner se conserva.
npx @notiamo/runner env <projectId> Crea o muestra el archivo de entorno que este equipo da a las ejecuciones de un proyecto.
npx @notiamo/runner start Se ejecuta en primer plano. El servicio ejecuta este comando; rara vez lo necesita.

El servicio es un agente de launchd com.notiamo.runner en macOS, una tarea programada «Notiamo runner» en Windows y una unidad de usuario de systemd notiamo-runner en Linux.

Dos runners en un mismo equipo

npx @notiamo/runner init --profile staging configura un segundo runner, independiente. Tiene su propia carpeta (~/.notiamo-runner/profiles/staging) y su propio servicio. Añada --profile staging a cada comando de ese runner. El nombre de un perfil tiene letras, dígitos y guiones, de 1 a 32 caracteres.

Qué puede y qué no puede tocar el agente

Cada ejecución recibe su propio archivo de ajustes de Claude Code. Tres cosas mantienen al agente en su sitio.

Las herramientas de archivos se quedan en la carpeta de la ejecución. Las herramientas de archivos de Claude (leer, editar, escribir, buscar) rechazan todo lo que esté fuera de la carpeta de la ejecución. Cualquier llamada que pidiera permiso se rechaza, porque no hay nadie para responder.

Los comandos de shell se ejecutan en el sandbox del sistema operativo. En macOS (Seatbelt) y en Linux o WSL2 (bubblewrap y socat), cada comando que el agente ejecuta en un shell queda confinado. Si el sandbox no puede iniciarse, la ejecución no se inicia.

Ninguna credencial del equipo llega al agente. Claude Code recibe solo una lista corta de variables de entorno (PATH, HOME, USER, LOGNAME, SHELL, LANG, LC_ALL, LC_CTYPE, TERM, TMPDIR, TZ, XDG_*, los ajustes de proxy y de certificados) más las propias de la ejecución. Nunca recibe SSH_AUTH_SOCK, GH_TOKEN, GITHUB_TOKEN, NPM_TOKEN, AWS_* ni ANTHROPIC_*. El git del agente no ve ninguna configuración de git global ni del sistema.

Lo que el sandbox del shell permite y deniega:

  • Lecturas denegadas: las carpetas de otros proyectos (incluidas las de otras ejecuciones al mismo tiempo), los archivos del propio runner y sus archivos y carpetas de credenciales (claves SSH, inicios de sesión en la nube, inicios de sesión en registros de paquetes, credenciales de git).
  • Escrituras permitidas: solo en la carpeta de la ejecución y en la carpeta de caché de paquetes del proyecto, junto a ella. Los .git/hooks y .git/config de la ejecución son de solo lectura.
  • Red permitida: GitHub, npm, Notiamo, el sitio de WordPress (en una ejecución de WordPress) y los hosts que añada en Hosts adicionales a los que puede acceder el agente de la tarjeta Runners. Todo lo demás se rechaza.

El agente nunca hace push y no guarda credenciales. El runner hace el push de la rama de la ejecución por sí mismo después del trabajo del agente.

Cuando una ejecución termina, el runner detiene todos los procesos que el agente dejó, como un servidor de desarrollo.

El llavero en macOS

El sandbox de macOS no cierra del todo el llavero. Por eso, no guarde ningún inicio de sesión de GitHub en el llavero del usuario que ejecuta el runner (init avisa cuando encuentra uno). La configuración más segura es un usuario de macOS dedicado, con su propio llavero.

Windows

Windows a secas no tiene sandbox de shell. El texto de un comentario podría entonces hacer que una ejecución lance cualquier comando en su nombre. Ejecute el runner dentro de WSL2. En Windows a secas, el runner no arranca a menos que añada "allowUnsandboxed": true a su config.json; hágalo solo en un equipo que no contenga nada más.

Varias ejecuciones a la vez

En la tarjeta Runners se fija Ejecuciones simultáneas: de 1 a 3. Cada ejecución usa su plan de Claude, así que limite el número a lo que el plan admita. Un proyecto nunca se ejecuta dos veces a la vez: una segunda ejecución en el mismo proyecto espera a la primera.

Cada ejecución simultánea tiene su propia carpeta de ranura. El sandbox de una ejecución no puede leer las otras ranuras.

Un runner para un solo cliente

Al crear un runner, puede limitarlo a un espacio de trabajo en Se ejecuta para. Entonces solo toma las ejecuciones de ese cliente. Para configurarlo en el ordenador del cliente: instale allí Claude Code, ejecute npx @notiamo/runner init y pegue el token del runner. El inicio de sesión de Claude de ese ordenador paga las ejecuciones, así que inicie sesión con la cuenta que deba pagar.

Comandos de preparación y de pruebas

Un clon limpio no tiene paquetes instalados. Dígale al agente cómo instalarlos y cómo probar. Abra los ajustes de agente del proyecto y rellene Comando de preparación y Comando de pruebas, una línea cada uno.

  • El agente ejecuta el comando de preparación una vez, antes de su primer cambio. Ejemplo: pnpm install --frozen-lockfile.
  • El agente ejecuta el comando de pruebas antes de cada commit. Un cambio que no lo supera se corrige o se deshace. Ejemplo: pnpm typecheck && pnpm lint.
  • El agente ejecuta ambos por sí mismo, en el mismo sandbox que sus otros comandos. El registro de paquetes debe estar entre los hosts permitidos. GitHub y registry.npmjs.org están por defecto. Añada cualquier otro (PyPI, crates.io, un registro privado) en Hosts adicionales a los que puede acceder el agente de la tarjeta Runners.
  • Cada proyecto tiene una carpeta de caché de paquetes junto a su clon. npm, pnpm, Yarn, Corepack, Bun, pip, uv y Composer guardan allí sus cachés, porque el sandbox cierra los lugares habituales de su carpeta personal. La carpeta se conserva entre las ejecuciones del proyecto y desaparece con el clon. No existe en Windows a secas.
  • Mantenga ligero el comando de pruebas. Una prueba que necesite Docker no puede ejecutarse. Una prueba que necesite una base de datos solo puede ejecutarse cuando el archivo de entorno del proyecto apunta a una que usted mantiene en marcha (vea más abajo).

El agente hace sus commits como «Notiamo agent», una línea simple por elemento. El runner desactiva la línea «Co-Authored-By» y la mención «Generated with» de Claude Code, así que el repositorio no muestra ningún coautor de IA.

Un entorno para sus propios proyectos

Una ejecución en un proyecto de GitHub recibe un clon limpio y nada más. En un proyecto de software suyo, las pruebas pueden necesitar también una base de datos, un almacén de archivos, un receptor de correo y un .env. El equipo del runner se los da a las ejecuciones de un proyecto con un archivo sencillo:

npx @notiamo/runner env <projectId>

<projectId> es la última parte de la dirección de la página del proyecto en Notiamo. El comando crea ~/.notiamo-runner/env/<projectId>.env, legible solo por usted, e imprime la ruta. Ponga un KEY=VALUE por línea. La próxima ejecución de ese proyecto recibe las variables en su shell, y al agente se le dicen sus nombres, nunca los valores. Elimine el archivo para quitarlas. El archivo nunca sale del equipo: Notiamo no sabe que existe.

Con el archivo presente, el shell de la ejecución también puede llegar a servicios en 127.0.0.1 en macOS: su Postgres, un almacén de archivos, un servidor de desarrollo. Usted los mantiene en marcha; el agente no puede iniciarlos, y Docker queda fuera de su alcance. En Linux el sandbox tiene su propia red, así que allí 127.0.0.1 no es el del equipo: enlace los servicios a la dirección de red del equipo y añada ese host en Hosts adicionales a los que puede acceder el agente.

Reglas:

  • Solo valores de desarrollo y de prueba. El agente ejecuta comandos de shell y puede leer todas las variables. Nunca una clave de producción, nunca una contraseña que use en otro sitio.
  • PATH, HOME, las variables de proxy y de certificados, NODE_OPTIONS, NODE_TLS_REJECT_UNAUTHORIZED, NOTIAMO_*, GIT_*, CLAUDE_* y ANTHROPIC_* se ignoran, y el registro lo dice. El archivo puede cambiar lo que ven los comandos del agente, nunca cómo habla Claude Code con Anthropic y con Notiamo.
  • Los valores de 6 caracteres o más se enmascaran como [secret] en la transcripción que recibe Notiamo. Los valores cortos (1, true) no.
  • Mantenga Ejecuciones simultáneas en 1 cuando los proyectos de un runner compartan una base de datos mediante su archivo de entorno. Dos ejecuciones a la vez harían sus pruebas sobre la misma base de datos.

Sitios de WordPress

La conexión está en la tarjeta Acceso al sitio web del proyecto: una contraseña de aplicación y, opcionalmente, SSH o FTP. El runner recuerda la clave del servidor SSH en su primera visita y rechaza un servidor que muestre otra clave más tarde. Una ejecución va así:

  1. Copia de seguridad antes. Con SSH, el runner exporta la base de datos y la sube a Notiamo, comprimida, de 200 MB como máximo. Notiamo la conserva 30 días. Con FTP o solo la API no hay copia de seguridad.
  2. El agente trabaja con la lista de permitidos de abajo.
  3. Comprobación del sitio después. El runner abre el sitio y comprueba que sigue respondiendo.
  4. Restauración si falla. Si la comprobación falla, el runner restaura la base de datos.

Lo que el agente puede ejecutar con wp-cli, por grupo (se fija en el proyecto):

  • Contenido: post *, term *, menu *, media import, option get, option update.
  • Base de datos: search-replace (solo el texto antiguo y el nuevo; nunca toca las tablas de usuarios ni de opciones), cache flush, rewrite flush, transient delete.
  • Plugins y temas: plugin y theme con list, activate, deactivate, update.
  • Información: core version, site list, db size.
  • Archivos: ningún comando de wp-cli; el agente usa sus herramientas de archivos. Escriben estilos, scripts y otros archivos que el servidor no ejecuta.
  • Archivos PHP (desactivado por defecto): las herramientas de archivos también pueden escribir PHP. Un archivo PHP es código que se ejecuta en su servidor, y una ejecución de WordPress no tiene paso de aprobación: el cambio se publica al instante. Actívelo solo en un sitio donde confíe en todas las personas que pueden escribir un comentario.
  • Nunca, salvo que elija «Permitir todo»: eval, eval-file, shell, user *, db query|import|reset|drop|export, plugin install, theme install, core update|download.

Qué se guarda dónde

Todo vive en ~/.notiamo-runner.

Ruta Qué contiene
config.json La dirección de Notiamo, el nombre del runner y el token del runner. Legible solo por usted.
claude/ La carpeta de configuración de Claude Code para el runner: su inicio de sesión y sus sesiones.
projects/ Las copias de trabajo de sus proyectos, una carpeta por proyecto en cada ranura. Un proyecto que no se usa durante el número de días fijado en la tarjeta Runners se elimina; la próxima ejecución lo clona de nuevo.
git/ Las copias propias del runner de sus repositorios. El agente no puede leer ni escribir esta carpeta.
env/ Los archivos de entorno que usted creó, uno por proyecto.
runs/ Los ajustes de Claude Code de cada ejecución en curso. Ningún secreto. Se borra cuando la ejecución termina.
runner.log Lo que hizo el runner, sin secretos.
state.json Los identificadores de las ejecuciones en curso. Tras un reinicio, cada una se comunica a Notiamo como fallida.

Los secretos de una ejecución (contraseñas de WordPress, los tokens propios de la ejecución) llegan de Notiamo con la ejecución y viven solo en memoria. El agente los recibe como variables de entorno, nunca en un archivo. Lo que el agente imprime se limpia de ellos antes de subir la transcripción.

El runner nunca usa las credenciales de git del equipo. Cada ejecución recibe de Notiamo un token de GitHub que sirve durante una hora y solo para el repositorio de la ejecución. El runner lo guarda en memoria y lo usa para su propio fetch y su propio push. Notiamo abre y fusiona la pull request.

Detener un runner

En la tarjeta Runners, pulse Desactivar para pausar un runner, o Eliminar para quitarlo. El token de un runner eliminado deja de funcionar al instante.