Comentar este tema con una IA

Obtiene una respuesta de la documentación y la página de la que procede.

Instalación y operación

Instalar el agente poison0 en macOS

Instalar, desplegar, comprobar y quitar el agente poison0 en un Mac.

~4 min de lectura · Instalación y operación

Requisitos

RequisitoDetalles
ProcesadorApple M2 o posterior, o un Mac Intel con AVX2 (Intel Haswell, 2013, o posterior). Apple M1 no es compatible.
DerechosDerechos de administrador. El instalador se ejecuta como root mediante sudo.
Clave de instalaciónUna clave de instalación de la consola, en Dispositivos → Despliegue varios dispositivos con una clave.
Agentes de IAAl menos un agente de IA de Agentes compatibles.

Instalar un Mac

Ejecute este comando en el Terminal.

bashTerminal
curl -fsSL https://poisonzero.com/install.sh | sudo PZ_ENROLL_CODE="<install-key>" sh

El instalador comprueba el programa con SHA256SUMS y se detiene si no coincide. Después instala el servicio y registra el Mac. En un terminal, el instalador pregunta si se envía el nombre del dispositivo a la consola. Usted responde Sí o No, no hay valor por defecto. Sí envía el nombre del equipo del Mac, No no envía ningún nombre. Con Jamf, Intune y scripts sin terminal no pregunta y no envía ningún nombre.

Para cambiar los valores por defecto, defina las variables de entorno de Referencia.

Comprobar el Mac

  1. Ejecute launchctl print system/com.poisonzero.daemon. El servicio debe estar en marcha.
  2. Ejecute poison0 doctor en su sesión de escritorio. Nombra lo que falla.
  3. Abra la consola. El Mac aparece en Dispositivos.

poison0 también responde a p0 y pz. Si otro programa ya usa uno de estos nombres, ese alias se omite.

Tras la primera instalación, el modelo se descarga en segundo plano. Las reglas fijas protegen desde el principio.

Desplegar en muchos Mac

Use el paquete con el perfil de su inquilino o, como alternativa, un script de directiva de Jamf o un script de shell de Intune. Todos se ejecutan como root.

Paquete y perfil (Intune, Jamf)

Es el camino recomendado y no necesita ningún script. Usted asigna a los mismos Mac dos archivos: el paquete poisonzero-<version>.pkg y el perfil de su inquilino <slug>-poisonzero-macos.mobileconfig. El paquete está firmado (Developer ID Jon Knoll (RYR9QUYGWV)), notarizado por Apple y es igual para todos los clientes. El perfil contiene la clave de instalación de su inquilino y el ajuste de si el nombre del equipo se envía como nombre del dispositivo.

  1. En la consola abra Dispositivos, despliegue Despliegue varios dispositivos con una clave y elija Descargar paquete de Intune. Seleccione la pestaña macOS.
  2. Opcional: marque Usar el nombre del equipo como nombre del dispositivo antes de descargar el perfil.
  3. En 1. Descargar el paquete, descargue el paquete con el enlace.
  4. En 2. Descargar el perfil, descargue el perfil con Descargar.

Pasos en Intune:

  1. Abra Aplicaciones → macOS → Agregar, elija Aplicación de línea de negocio y cargue el paquete.
  2. Asigne la aplicación a un grupo de dispositivos en Requerido.
  3. Abra Dispositivos → macOS → Configuración → Crear → Nueva directiva. Elija el tipo de perfil Plantillas → Personalizado y el canal de implementación Canal de dispositivo. Cargue el archivo .mobileconfig.
  4. Asigne el perfil al mismo grupo de dispositivos.

Pasos en Jamf Pro:

  1. Cargue el paquete en Settings → Computer Management → Packages.
  2. En Computers → Policies, cree una directiva que instale el paquete (Packages → Install). Elija un trigger, por ejemplo Recurring Check-in, y defina el scope en sus Mac.
  3. En Computers → Configuration Profiles → Upload, cargue el archivo .mobileconfig.
  4. Defina el scope del perfil en los mismos Mac.

Paquete y perfil pertenecen a los mismos Mac, en cualquier orden. En cuanto ambos están en un Mac, este se inscribe en su inquilino. Si el perfil llega más tarde, un servicio en segundo plano lo detecta y entonces inscribe el Mac. Sin el perfil, el Mac no se conecta con su inquilino. Si PoisonZero está en marcha lo ve en la consola, en Dispositivos.

El perfil contiene una clave de instalación que ve todo administrador que pueda leer perfiles en su MDM. La consola la lista como Intune macOS profile con la fecha. Vale un año; revóquela tras el despliegue.

Para quitar PoisonZero, ejecute la desinstalación de Desinstalar. En una instalación con paquete también elimina el recibo del paquete. Después, quite el paquete y el perfil de la asignación en su MDM. El perfil también está disponible por la API de administración: POST /v1/intune/macos-profile, vea API de administración.

Instalar el agente

Jamf e Intune ejecutan el script sin terminal. Pase por eso la clave como variable de entorno. En Intune, añada el script en Dispositivos → macOS → Scripts de shell y ponga Ejecutar script como usuario que ha iniciado sesión en No. Intune guarda el texto del script con la clave, así que revoque la clave en la consola tras el despliegue. Nombre del dispositivo: si usted no elige uno, PoisonZero no envía ningún nombre y la consola muestra un marcador de posición. PZ_DEVICE_NAME_FROM_HOSTNAME=1 en el script de abajo envía el nombre del equipo de cada Mac (Ajustes del Sistema → General → Información → Nombre, el nombre que muestra Intune). Quite la variable para no enviar ningún nombre. Las alternativas PZ_DEVICE_NAME y PZ_DEVICE_NAMES_CSV están en Referencia. El nombre se fija solo en la primera inscripción. Las ejecuciones posteriores del script no lo cambian, así que cambie el nombre de un Mac en la consola.

bashJamf o Intune, como root
#!/bin/sh
PZ_ENROLL_CODE="<install-key>" PZ_DEVICE_NAME_FROM_HOSTNAME=1 sh -c "$(curl -fsSL https://poisonzero.com/install.sh)"

PoisonZero configura por sí mismo la protección de los agentes de IA tras la instalación, en cada cuenta de usuario y para todos los agentes compatibles. No tiene que hacer nada.

Intune (macOS)

Como alternativa, la consola le entrega el script terminado con la clave de instalación de su inquilino. No tiene que escribir nada en Intune.

  1. En la consola abra Dispositivos, elija Descargar paquete de Intune y la pestaña macOS. Despliegue Otras opciones y descargue el script.
  2. En Intune, añada un script en Dispositivos → macOS → Scripts → Agregar y cargue el archivo.
  3. Ponga Ejecutar script como usuario que ha iniciado sesión en No, para que se ejecute como root. Deje la frecuencia en No configurado y, en Reintentos si falla el script, indique por ejemplo 3.
  4. Asigne el script a un grupo de dispositivos.

Requisitos: macOS 12 o posterior, el Mac está inscrito en Intune y llega a internet sin proxy. Intune instala por sí mismo el agente de Intune en cuanto se asigna un script al Mac. El agente recoge scripts nuevos más o menos cada 8 horas. En el Portal de empresa, Comprobar configuración lo acelera.

El script no vuelve a registrar un Mac que ya está registrado. Intune muestra por Mac solo éxito o error. Si PoisonZero está en marcha, lo ve en la consola en Dispositivos.

El script contiene una clave de instalación que ven todos los administradores de Intune con acceso de lectura a los scripts. La consola la muestra como Intune macOS con la fecha. Vale un año; revóquela tras el despliegue.

Mac privados: configuración firmada

Un Mac privado no recibe ajustes de la nube. Lee un client-config.json firmado.

  1. En la consola, abra el perfil y elija Exportar para privados.
  2. Pase el archivo al instalador con PZ_CONFIG, como se muestra abajo.
  3. O colóquelo con el script de Jamf que la consola muestra tras la exportación.
bashTerminal
curl -fsSL https://poisonzero.com/install.sh | sudo \
  PZ_ENROLL_CODE="<install-key>" PZ_CONFIG="./client-config.json" sh

El instalador comprueba el archivo con poison0 config verify y lo coloca en /Library/Application Support/PoisonZero/client-config.json, legible solo por root.

Actualización

Los dispositivos en la nube se actualizan solos. Para desactivarlo por dispositivo, use Settings → Protección y dispositivos → Actualizaciones en la consola. Los dispositivos privados no se actualizan solos.

Para actualizar a mano, vuelva a ejecutar el comando de instalación. Conserva las credenciales. Más en Actualizaciones y ciclo de vida.

A partir de esta versión, el archivo del programa es /usr/local/bin/poison0. poisonzero apunta a él y sigue funcionando, y las exclusiones de carpetas siguen siendo válidas. Para exclusiones de archivos o procesos, añada poison0 y mantenga poisonzero, porque los hooks de los agentes aún lo llaman.

Desinstalar

bashTerminal
curl -fsSL https://poisonzero.com/install.sh | sudo sh -s -- --uninstall

La desinstalación quita primero los hooks de agente de todos los usuarios y se detiene si falla. Después quita el servicio, el notifier, los comandos, el programa y el directorio de datos.

En una instalación con Homebrew, quite primero los hooks:

bashHomebrew
poison0 remove-agent-integration && brew uninstall poisonzero
No borre el programa a mano. Los hooks de Claude Code que apuntan a un programa ausente bloquean cada llamada a herramienta.

Casos de cuarentena abiertos

La desinstalación lista cada caso de cuarentena abierto con su ruta original, la copia en cuarentena (*.infection.pz) y cómo restaurarlo. Una copia queda en /Library/Application Support/PoisonZero-quarantine, legible solo por root.

Ponga PZ_UNINSTALL_SKIP_QUARANTINE_COPY=1 para no guardar esa copia. Nada se restaura automáticamente. Revise cada archivo antes de restaurarlo.

La desinstalación descarta los cambios retenidos que aún esperan revisión. Para conservar uno, apruébelo antes: véalos con poison0 quarantine pending y ejecute poison0 quarantine pending approve <id>.

Solución de problemas

SíntomaCausaSolución
poison0 doctor muestra que la descarga del modelo falló.La descarga en segundo plano tras la primera instalación no terminó.Ejecute sudo poison0 model para reintentarla ahora. poison0 doctor muestra el motivo.
poison0 exec0 status muestra que Claude Code no llama al hook de exec0.Los ajustes de Claude Code vienen de un perfil MDM (dominio com.anthropic.claudecode) o de la consola de administración de claude.ai. Claude Code ignora entonces 50-poisonzero-exec0.json.Ponga "managedSourcesBehavior": "merge" en esa fuente (Claude Code 2.1.242 o posterior), o copie allí el contenido del archivo.
poison0 doctor informa de que los hooks gestionados están desactivados.Los ajustes gestionados de Claude Code fijan "disableAllHooks": true. Esto desactiva también los hooks gestionados del agente.Quite el ajuste donde está definido: en managed-settings.json, otro archivo de managed-settings.d/, el perfil MDM o la consola de administración de claude.ai. El agente nunca cambia estas fuentes.
La instalación se detiene tras el registro y la configuración firmada no se coloca.poison0 config verify rechazó client-config.json. Un archivo existente se mantiene.Busque el código de salida en Referencia.
La desinstalación se detiene y no quita nada.No pudo quitar los hooks de agente de todos los usuarios.Ponga PZ_UNINSTALL_FORCE=1 y quite a mano las entradas restantes.

Referencia

Variables de entorno

Defínalas antes de que arranque el instalador. Un flag, pasado tras sh -s --, tiene prioridad sobre su variable.

VariableEfecto
PZ_ENROLL_CODELa clave de instalación de la consola. En un Mac registrado, una clave nueva lo registra otra vez.
PZ_APP_IDSolo para un código de un solo uso que vino con un App ID.
PZ_HEADLESSCómo se tratan las solicitudes de confirmación cuando ningún usuario de escritorio puede responder. none (por defecto) sigue al usuario conectado, standard trata siempre el Mac como sin escritorio, strict es el más estricto. Flag: --headless.
PZ_DEVICE_NAMEEl nombre del dispositivo en la consola, hasta 63 caracteres, solo a-z, 0-9 y -. Sin nombre, la consola muestra un marcador de posición. En su lugar, PZ_DEVICE_NAME_FROM_HOSTNAME=1 envía el nombre del equipo del Mac (Ajustes del Sistema → General → Información → Nombre), o PZ_DEVICE_NAMES_CSV (archivo o URL https, cabecera hostname,name) busca el Mac por nombre del equipo, nombre de host local o hostname y envía solo el nombre del CSV. Si hay varias definidas, vale PZ_DEVICE_NAME y después el CSV. Solo actúan en la primera inscripción. Más en el onboarding.
PZ_SETUP_AGENTSAñade el comando local de estadísticas /poison0 a los agentes indicados, por ejemplo claude,codex.
PZ_SETUP_STATUSLINEPonga 1 para añadir la línea de estado a Claude Code. Una línea de estado existente se mantiene.
PZ_SETUP_EXEC0Ponga off para mantener exec0 desactivado, también tras las actualizaciones. Los demás valores se ignoran. Actívelo en el perfil de la consola o con sudo poison0 exec0 observe o enforce.
PZ_SETUP_LEAK0Solo dispositivos privados. Fija el modo de leak0: enforce, observe u off. Sin la variable y sin terminal, leak0 queda desactivado.
PZ_BACKENDcpu (por defecto) o gpu. El perfil de la consola decide si el Mac usa la GPU.
PZ_TIERenterprise (por defecto) o ultra. Con ultra, el instalador se detiene con un error. Fije por eso Ultra en el perfil de la consola.
PZ_NO_SHORT_ALIASPonga 1 para no crear el comando corto p0.
PZ_FETCH_ONLYPonga 1 para solo descargar y comprobar el programa, sin servicio ni derechos de administrador. Va a ./poison0 o a PZ_FETCH_DEST.
PZ_DRY_RUNPonga 1 para mostrar el modo de instalación y salir antes de cualquier cambio.
POISONZERO_DATA_DIRCambia el directorio de datos del instalador y del agente.
PZ_CONFIGRuta a un client-config.json firmado para un Mac privado. Flag: --config.
PZ_QUARANTINE_RETENTION_DAYSSolo dispositivos privados. Días que se guarda un caso de cuarentena, de 1 a 3650. Flag: --quarantine-retention-days.
PZ_AUDIT_MAX_MBSolo dispositivos privados. Tamaño en MB a partir del cual rota el registro de auditoría, de 1 a 1024. Flag: --audit-max-mb.

Rutas y servicio

ElementoUbicación
El programa y sus comandos./usr/local/bin/poison0. Los comandos poisonzero, p0 y pz apuntan a él.
El directorio de datos./Library/Application Support/PoisonZero, propietario root:wheel. Contiene las credenciales, el archivo enroll, los registros y la cuarentena.
El servicio.El LaunchDaemon com.poisonzero.daemon. Arranca con el sistema y se ejecuta como root.
El notifier de las solicitudes de confirmación.El LaunchAgent com.poisonzero.notifier en cada sesión de usuario. Sin usuario conectado, arranca en el siguiente inicio de sesión.
El registro del servicio.daemon.log en el directorio de datos. Rota a los 5 MB.
Los hooks de exec0 para Claude Code./Library/Application Support/ClaudeCode/managed-settings.d/50-poisonzero-exec0.json. Una instalación con Homebrew bajo un prefijo del usuario usa ~/.claude/settings.json.

Hooks de exec0 en Claude Code

El agente nunca cambia su managed-settings.json ni otros archivos de managed-settings.d/. Para desactivar o activar exec0 en Claude Code:

bashexec0 para Claude Code
# turn off
sudo poison0 setup-claude --toolgate-off
# turn on
sudo poison0 setup-claude --toolgate

Códigos de salida de la configuración firmada

poison0 config verify devuelve estos códigos. El instalador coloca el archivo solo con 0 o 6.

Código de salidaSignificado
0El archivo es válido.
6La licencia aún no está. El servicio comprueba el archivo al arrancar.
1El archivo no se puede leer.
3El archivo no está firmado para este dispositivo.
4El archivo está desactualizado o caducado.
5El archivo no es válido o es demasiado nuevo para esta versión del agente.
7El Mac es un dispositivo en la nube, que ignora el archivo.

Siga leyendo

Otros sistemas operativos: resumen de la instalación. Hardware: Requisitos del sistema. Protección por agente: Agentes compatibles.