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 Windows

Instalar, desplegar, comprobar y quitar el agente poison0 en Windows, a mano o con Intune.

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

Requisitos

RequisitoDetalles
ProcesadorWindows x64 con AVX2 (Intel Haswell, 2013, o posterior, AMD Zen o posterior). Windows on ARM no es compatible.
DerechosPowerShell como administrador. Funcionan tanto Windows PowerShell 5.1 como PowerShell 7.
Sistema de archivosEl directorio de datos debe estar en un volumen NTFS.
Microsoft DefenderExclusiones de ruta, definidas antes de instalar, porque el programa no está firmado. Vea el paso 1 en Desplegar en muchos dispositivos.
Clave de instalaciónUna clave de instalación de la consola, en Dispositivos → Despliegue varios dispositivos con una clave.

Estos agentes de IA reciben hooks en Windows. Todas las protecciones por agente: Agentes compatibles.

AgenteHooks en Windows
Claude CodeCompatible. Los comandos /pz, la línea de estado y leak0 se configuran por usuario.
CodexCompatible a partir de Codex CLI 0.159.
Gemini CLI, Antigravity, GitHub Copilot CLI, Windsurf / DevinCompatible.
Cursor, Cortex Code, Kiro, ClineSin hooks en Windows. La protección de memoria sigue cubriendo sus archivos.
OpenCode, OpenClaw, Kilo 7.xKilo 7.x: Compatible. El plugin se carga desde una copia gestionada en C:\ProgramData\kilo que solo los administradores pueden cambiar; una copia por usuario queda sin efecto. Iniciar Kilo sin plugins (KILO_PURE, --pure) está bloqueado. OpenCode, OpenClaw: Aún no comprobados en Windows.

Instalar un dispositivo

Ejecute este comando en PowerShell como administrador.

powershellPowerShell como administrador
$env:PZ_ENROLL_CODE="<install-key>"
irm https://poisonzero.com/install.ps1 | iex

El instalador comprueba el programa con SHA256SUMS y se detiene si no coincide. Después registra el dispositivo y configura el servicio.

En una consola interactiva, el instalador pregunta por la aceleración y los agentes de IA. Además 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, No no envía ningún nombre. Sin consola no pregunta nada, instala para la CPU y no envía ningún nombre.

Comprobar el dispositivo

  1. Ejecute Get-ScheduledTask -TaskName PoisonZero. La tarea debe estar en marcha.
  2. Ejecute poison0 doctor en la sesión del usuario. Nombra lo que falla.
  3. Abra la consola. El dispositivo 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 dispositivos

Use Intune y siga estos pasos en orden.

1. Definir las exclusiones de Microsoft Defender

Excluya estas tres rutas antes de asignar la aplicación. Las exclusiones de proceso no hacen falta.

textExclusiones de ruta
C:\Program Files\PoisonZero
C:\ProgramData\PoisonZero
C:\Users\*\AppData\Local\PoisonZero

* cubre todos los perfiles de usuario. No use %LOCALAPPDATA% ni %USERPROFILE%. Defender se ejecuta como LocalSystem y los resuelve a C:\Windows\System32\config\systemprofile.

  1. En Intune, abra Endpoint security → Antivirus → Create policy.
  2. Elija la plataforma Windows y el perfil Microsoft Defender Antivirus exclusions.
  3. Añada las tres rutas en Excluded paths.
  4. Asigne la directiva a los mismos grupos que la aplicación.

Para comprobar un dispositivo, use los comandos de Solución de problemas. Para directiva de grupo en lugar de Intune, vea Referencia.

2. Obtener una clave de instalación

  1. En la consola, abra Dispositivos → Despliegue varios dispositivos con una clave y elija Generar clave.
  2. Copie la clave. La consola la muestra una sola vez.
  3. Guárdela en un archivo para el paso siguiente, por ejemplo C:\secure\code.txt.

La clave vale 30 días y registra dispositivos hasta el límite de su plan, sin límite en Enterprise. Cada dispositivo recibe su propia identidad.

Para crear la clave desde un script, use la Management API como en Alternativa.

3. Descargar el paquete listo

Descargue los dos archivos de aplicación y los dos scripts de detección de la versión actual y compruebe su SHA-256. No contienen ninguna clave de instalación, y detect.ps1 ya lleva la versión.

powershellPowerShell
$base = 'https://poisonzero.com/dl/latest'
New-Item -ItemType Directory -Force C:\pz-out | Out-Null
foreach ($f in 'install.intunewin', 'user-setup.intunewin', 'detect.ps1', 'detect-user.ps1') {
  Invoke-WebRequest "$base/$f" -OutFile "C:\pz-out\$f"
  Invoke-WebRequest "$base/$f.sha256" -OutFile "C:\pz-out\$f.sha256"
  $want = ((Get-Content "C:\pz-out\$f.sha256" -TotalCount 1) -split '\s+')[0]
  if ((Get-FileHash "C:\pz-out\$f" -Algorithm SHA256).Hash -ne $want) { throw "SHA-256 mismatch: $f" }
}
Invoke-RestMethod "$base/VERSION"

La última línea muestra la versión para el comando de instalación. Para una versión fija, sustituya latest por v<version>.

Descargar el paquete en la consola

  1. En la consola abra Dispositivos, despliegue Despliegue varios dispositivos con una clave y elija Descargar paquete de Intune. Deje Windows seleccionado.
  2. Opcional: marque Usar el nombre del equipo como nombre del dispositivo. Luego elija Descargar. La consola descarga el paquete terminado como archivo .intunewin, con una clave de instalación nueva dentro.
  3. Copie los valores que la consola muestra después en las aplicaciones de Intune del paso 4. El Comando de instalación es solo install.cmd, porque la clave ya está en el paquete. Los enlaces a detect.ps1, user-setup.intunewin y detect-user.ps1 aparecen allí también.

Esto sustituye los pasos 2 y 3, el paso 1 se mantiene. El paquete contiene una clave de instalación que ven todos los administradores de Intune en la aplicación. La consola la muestra como Intune con la fecha. Vale un año; revóquela tras el despliegue.

Alternativa: crear el paquete usted mismo

Con su propio paquete, la clave va dentro del paquete (installcode.txt) en lugar del comando de instalación.

Descargue el zip, compruebe su SHA-256 y descomprímalo:

powershellPowerShell
$base = 'https://poisonzero.com/dl/latest'
Invoke-WebRequest "$base/poisonzero-intune.zip" -OutFile poisonzero-intune.zip
Invoke-WebRequest "$base/poisonzero-intune.zip.sha256" -OutFile poisonzero-intune.zip.sha256
$want = ((Get-Content poisonzero-intune.zip.sha256 -TotalCount 1) -split '\s+')[0]
if ((Get-FileHash poisonzero-intune.zip -Algorithm SHA256).Hash -ne $want) { throw 'SHA-256 mismatch' }
Expand-Archive poisonzero-intune.zip -DestinationPath C:\pz-src

Para una versión fija, sustituya latest por v<version>, por ejemplo v1.16.55.

Cree la carpeta del paquete. La clave va a installcode.txt. Basta con Windows PowerShell 5.1 (incluido en Windows); PowerShell 7 es opcional.

powershellPowerShell
Get-Content C:\secure\code.txt -TotalCount 1 | powershell -NoProfile -ExecutionPolicy Bypass -File C:\pz-src\build-package.ps1 -Out C:\pz-intune -Version 1.16.55 -InstallCodeFromStdin

O cree la clave con la Management API y construya el paquete en un solo comando. La clave nunca se muestra.

powershellPowerShell
$h = @{ Authorization = "Bearer $env:PZ_API_KEY" }
(Invoke-RestMethod -Method Post https://poisonzero.com/api/v1/install-codes -Headers $h -ContentType 'application/json' -Body '{"deviceMode":"cloud"}').code | powershell -NoProfile -ExecutionPolicy Bypass -File C:\pz-src\build-package.ps1 -Out C:\pz-intune -Version 1.16.55 -InstallCodeFromStdin

Cree los dos archivos de aplicación con el Win32 Content Prep Tool de Microsoft, que no está en el zip. Escribe install.intunewin y user-setup.intunewin en C:\pz-out.

powershellPowerShell
IntuneWinAppUtil.exe -c C:\pz-intune -s install.cmd -o C:\pz-out -q
IntuneWinAppUtil.exe -c C:\pz-intune -s user-setup.ps1 -o C:\pz-out -q
El archivo .intunewin contiene la clave de instalación. Trátelo como la clave. Revoque la clave en la consola tras el despliegue.

4. Crear las aplicaciones de Intune

Cree dos aplicaciones Win32 y asigne ambas cuando la directiva de Defender aparezca como aplicada. La aplicación principal instala el agente como SYSTEM. La aplicación por usuario configura los agentes de IA en cada cuenta de usuario.

La clave del comando de instalación es visible para los administradores de Intune en la configuración de la aplicación. Revóquela en la consola tras el despliegue.

Por defecto no se envía ningún nombre de dispositivo. Para enviar uno, añada al comando de instalación -DeviceNameFromHostname (el nombre del equipo; su elección explícita, PoisonZero no lo recomienda) o -DeviceNamesCsv <URL https> (un CSV con el encabezado hostname,name; solo se envía el nombre).

Aplicación principalValor
App fileinstall.intunewin.
Install commandRecomendado: install.cmd -Version latest -InstallCode "<clave>", que instala la versión más reciente (paquetes desde 1.16.88; con un paquete anterior, omita -Version). Para fijar una versión: install.cmd -Version 1.16.55 -InstallCode "<clave>", con la versión del paso 3. Con su propio paquete, sin -InstallCode: la clave viene de installcode.txt.
Uninstall commanduninstall.cmd. Quita primero los hooks de todos los usuarios.
Install behaviorSystem. El instalador necesita derechos de SYSTEM.
Device restart behaviorNo specific action. La instalación no necesita reinicio.
Return codes0 significa éxito. 1 significa error, también un registro fallido.
Operating system architectureElija solo x64.
Detection ruleScript propio detect.ps1. Ponga Run script as 32-bit process on 64-bit clients en No.
Aplicación por usuarioValor
App fileuser-setup.intunewin.
Install commandpowershell.exe -NoProfile -ExecutionPolicy Bypass -File user-setup.ps1. Añada -StatusLine para la línea de estado de Claude Code.
Uninstall commandcmd.exe /c exit 0, porque Intune exige uno. La aplicación principal quita los hooks.
Install behaviorUser. El script no necesita derechos de administrador.
DependenciesLa aplicación PoisonZero, con Automatically install en Yes.
Return codes0 significa éxito. 1 significa error.
Detection ruleScript propio detect-user.ps1, que comprueba %USERPROFILE%\.claude\commands\pz.md. Ponga Run script as 32-bit process on 64-bit clients en No.

Configuration Manager

Aún no hemos probado Configuration Manager (SCCM).

Use la carpeta del paquete en una aplicación con instalador por script que se ejecuta como SYSTEM, con los valores de la aplicación principal. Despliegue user-setup.ps1 en el contexto de usuario con detect-user.ps1 y una dependencia de esa aplicación.

Dispositivos privados: configuración firmada

Un dispositivo 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. La consola muestra un script que coloca el archivo.
  2. Cree una aplicación con ese script y añada el código de salida 6 como código de éxito. 6 significa que el dispositivo comprueba el archivo más tarde.
  3. Asigne la aplicación solo a dispositivos privados. En un dispositivo en la nube, el script termina con 7, un error.

En un solo dispositivo, defina PZ_CONFIG con la ruta del archivo antes de ejecutar el comando de instalación. El archivo queda en %ProgramData%\PoisonZero\client-config.json, legible solo por SYSTEM y los administradores.

Actualización

Los dispositivos en la nube se actualizan solos. Para desactivarlo por dispositivo, use Settings → Protección y dispositivos → Actualizaciones en la consola. Aún no hemos probado este ajuste en Windows. 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 poison0.exe. poisonzero.exe se mantiene como copia, y las exclusiones de carpetas siguen siendo válidas. Para exclusiones de archivos o procesos, añada poison0.exe y mantenga poisonzero.exe, porque los hooks de los agentes aún lo llaman.

Desinstalar

Ejecute este comando en PowerShell como administrador. Con Intune, desinstale en su lugar la aplicación, que ejecuta uninstall.cmd.

powershellPowerShell como administrador
& ([scriptblock]::Create((irm https://poisonzero.com/install.ps1))) -Uninstall

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

Una instalación con Scoop se quita con scoop 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 %ProgramData%\PoisonZero-quarantine, legible solo por SYSTEM y los administradores.

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
La instalación termina con el código de salida 1 y not enrolled: <reason> en su registro.El registro falló, por ejemplo con device_limit, expired, revoked o max_redemptions. Una primera instalación se deshace.Corrija la causa indicada en la consola, por ejemplo con una clave de instalación nueva, e instale de nuevo.
La instalación falla con code_unknown.Usó el código de enrollment de la página de un dispositivo sin su App ID.Pase ambos: install.cmd -AppId <app-id> -InstallCode "<code>".
Un dispositivo revocado no se registra de nuevo.Un dispositivo registrado no recibe clave al reinstalar o actualizar.Añada una vez -ForceEnroll al comando de instalación.
La consola no muestra ningún nombre de dispositivo tras el despliegue.PoisonZero no envía ningún nombre de dispositivo por defecto.Cambie el nombre del dispositivo en la consola, o añada -DeviceNameFromHostname o -DeviceNamesCsv al comando de instalación. Se aplica cuando un dispositivo se registra.
La clave de instalación es visible en Intune y en los registros de los dispositivos.La pasó con install.cmd -InstallCode.Cree el paquete con -InstallCodeFromStdin.
Intune reinstala la aplicación en cada comprobación.$MinVersion en detect.ps1 es mayor que la versión instalada.Mantenga $MinVersion igual o por debajo de la versión instalada. build-package.ps1 -Version lo fija.
Intune informa la aplicación por usuario como fallida.La aplicación PoisonZero no está instalada en el dispositivo, así que el script termina con exit 1. La aplicación por usuario necesita la dependencia de la aplicación PoisonZero.Añada la dependencia de la aplicación PoisonZero. Un usuario sin Claude Code se detecta de inmediato, porque el script prepara el perfil de antemano.
Defender bloquea o quita el programa, con el evento 1116 o 1117.Defender detectó el programa sin firmar en una ruta que ninguna exclusión cubre.Compruebe las exclusiones con los comandos bajo esta tabla. Use exactamente las tres rutas del paso 1.
Defender bloquea su comando de exclusión como Trojan:Win32/PowExcEnv.RXH!MTB.Definió las exclusiones con powershell -EncodedCommand ... Add-MpPreference ..., así que no se definen.Defínalas con Intune o con directiva de grupo.
Get-MpPreference no muestra rutas de exclusión.Sin privilegios elevados muestra un aviso. HideExclusionsFromLocalAdmins oculta las rutas incluso a los administradores, pero se aplican.Ejecútelo como administrador, o pruebe una ruta con MpCmdRun.exe -CheckExclusion.
poison0 doctor muestra que la descarga del modelo falló.La descarga en segundo plano tras la primera instalación no terminó.Ejecute poison0 model como administrador para reintentarla ahora. poison0 doctor muestra el motivo.
poison0 doctor informa "GPU present but no Vulkan driver".Falta vulkan-1.dll en el directorio del sistema, o no hay ningún controlador Vulkan registrado.Instale o actualice el controlador del fabricante de la GPU. Hasta entonces, el motor funciona en la CPU y inject0 queda desactivado.
poison0 exec0 status muestra que Claude Code no llama al hook de exec0.Los ajustes de Claude Code vienen de una directiva de grupo o de Intune (HKLM\SOFTWARE\Policies\ClaudeCode) o de la consola de administración de claude.ai. Claude Code ignora entonces 50-poisonzero-exec0.json.Ponga allí "managedSourcesBehavior": "merge" (Claude Code 2.1.242 o posterior), o copie allí el contenido del archivo. poison0 doctor avisa inject0 failure hook missing: Claude Code no tiene una entrada de hook PostToolUseFailure, así que inject0 no revisa la salida de las llamadas a herramientas fallidas. Con ajustes de una directiva de grupo o de Intune (HKLM\SOFTWARE\Policies\ClaudeCode), managed-settings.json o la consola de administración de claude.ai, esa fuente debe llevar la entrada. Añada en esa fuente la entrada PostToolUseFailure de 50-poisonzero-exec0.json junto a PostToolUse. Sin ajustes centrales, ejecute poison0 setup-claude --toolgate.
poison0 status o poison0 doctor muestra Codex como no protegido.Codex CLI es anterior a 0.159. O los nombres cortos 8.3 están desactivados en el volumen del sistema, y Codex no puede iniciar el hook desde C:\Program Files\PoisonZero, cuya ruta tiene un espacio.Actualice Codex CLI a 0.159 o posterior. Sin nombres cortos 8.3, exec0 no puede proteger Codex en este dispositivo. Activar los nombres 8.3 después no ayuda.
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.

Ejecute estos comandos en un PowerShell con privilegios elevados. MpCmdRun.exe está en la carpeta de plataforma de Defender, %ProgramData%\Microsoft\Windows Defender\Platform\<version>.

powershellPowerShell como administrador
Get-MpPreference | Select-Object -ExpandProperty ExclusionPath
MpCmdRun.exe -CheckExclusion -Path C:\ProgramData\PoisonZero
Get-WinEvent -FilterHashtable @{LogName='Microsoft-Windows-Windows Defender/Operational'; Id=1116,1117} -ErrorAction SilentlyContinue | Where-Object Message -like '*PoisonZero*' | Format-List TimeCreated, Id, Message

Referencia

Versión fijada y detección

ParámetroEfecto
-Versionlatest instala la versión más reciente, igual que sin el parámetro. Una versión como 1.16.55 instala esa versión y nunca reemplaza un programa instalado más nuevo; una versión que nunca se publicó se rechaza antes de la descarga. Con build-package.ps1 una versión también fija $MinVersion en detect.ps1.
-Sha256 <hex>Comprueba el programa con un hash de una fuente de confianza, solo con -Version. SHA256SUMS viene del mismo servidor y solo detecta una descarga dañada.

detect.ps1 da la aplicación por instalada cuando existe el programa, el dispositivo está registrado, la versión es al menos $MinVersion y existe la tarea PoisonZero. Las versiones más nuevas cuentan, porque los dispositivos en la nube se actualizan solos.

Variables de entorno

Defínalas antes de ejecutar el instalador. Con install.ps1 ejecutado como archivo, -Version, -Sha256, -Config y -Uninstall tienen prioridad sobre sus variables. install.cmd de Intune vacía PZ_ENROLL_CODE, PZ_APP_ID, PZ_VERSION, PZ_SHA256 y PZ_UNINSTALL. Use por eso sus parámetros.

VariableEfecto
PZ_ENROLL_CODELa clave de instalación de la consola. En un dispositivo 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_VERSIONComo -Version, por ejemplo latest o 1.16.55.
PZ_SHA256Como -Sha256. Úselo solo con PZ_VERSION.
PZ_ALLOW_DOWNGRADEPonga 1 para que una versión fijada reemplace un programa instalado más nuevo.
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 dispositivo como sin escritorio, strict es el más estricto.
PZ_DEVICE_NAMEEl nombre del dispositivo en la consola, guardado en minúsculas, cifras y guiones, hasta 63 caracteres. El instalador muestra cómo se guarda el nombre. Las demás opciones se describen en el onboarding.
PZ_SETUP_AGENTSAñade el comando local de estadísticas /poison0 a los agentes indicados, por ejemplo claude,codex, si hay alguien conectado.
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 poison0 exec0 observe o enforce.
PZ_SETUP_LEAK0Solo dispositivos privados. Fija el modo de leak0: enforce, observe u off. Sin la variable y sin consola, leak0 queda desactivado.
PZ_BACKENDcpu (por defecto) o gpu. Con gpu, el instalador avisa si no encuentra un controlador Vulkan.
PZ_TIERenterprise (por defecto) o ultra. Con ultra, la instalación se detiene si la tarjeta gráfica tiene menos de 8 GB de memoria de vídeo o no tiene controlador Vulkan.
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.exe o a PZ_FETCH_DEST.
PZ_DRY_RUNPonga 1 para mostrar el modo de instalación y salir antes de cualquier cambio.
PZ_CONFIGRuta a un client-config.json firmado para un dispositivo privado.
PZ_QUARANTINE_RETENTION_DAYSSolo dispositivos privados. Días que se guarda un caso de cuarentena, de 1 a 3650.
PZ_AUDIT_MAX_MBSolo dispositivos privados. Tamaño en MB a partir del cual rota el registro de auditoría, de 1 a 1024.
PZ_UNINSTALLPonga 1 para desinstalar mediante irm ... | iex, sin argumentos.

Rutas y servicio

ElementoUbicación
El programa y sus comandos.C:\Program Files\PoisonZero\poison0.exe, con pz-dialog.exe. poisonzero.exe al lado es una copia para los scripts y hooks que lo llaman. La carpeta y su subcarpeta bin, con p0 y pz, están en el PATH del sistema.
El directorio de datos.C:\ProgramData\PoisonZero, legible por todos los usuarios salvo algunos archivos como el de enrollment y client-config.json. Contiene las credenciales, el motor, los registros y la cuarentena.
La carpeta por usuario.%LOCALAPPDATA%\PoisonZero en cada perfil. Contiene el estado del notifier y el registro de diálogos.
El servicio.La tarea programada PoisonZero. Se ejecuta como SYSTEM al arrancar, se reinicia hasta 3 veces con 1 minuto de intervalo y se vuelve a lanzar cada 5 minutos.
El notifier de las solicitudes de confirmación.Arranca al iniciar sesión en cada sesión de usuario mediante el valor de registro PoisonZeroNotifier en Run.
El registro del servicio.daemon.log en el directorio de datos, rota a los 5 MB. Es el único registro del servicio.
El registro de instalación.El instalador escribe en la salida estándar. Bajo Intune, acaba en los registros de Intune Management Extension.
Los hooks de exec0 para Claude Code.C:\Program Files\ClaudeCode\managed-settings.d\50-poisonzero-exec0.json.

GPU y Ultra

ElementoComportamiento
Motor GPUEn Windows, el motor GPU usa Vulkan; Ultra necesita un controlador Vulkan y al menos 8 GB de memoria de vídeo; inject0 solo se ejecuta en la GPU, necesita un controlador Vulkan de Intel, AMD o NVIDIA y, sin GPU adecuada, informa inject0: off (no suitable GPU) sin vuelta a la CPU.
Perfil de la consolaDecide si un dispositivo usa la GPU o Ultra. Si pide la GPU y ninguna es compatible, el motor no arranca, sin vuelta a la CPU.
exec0Se ejecuta en la CPU y no necesita GPU (Enterprise).
SandboxEn la GPU (Ultra o inject0), el motor funciona sin AppContainer. Vea sandbox de Windows.

exec0 para Claude Code

Desactive o active exec0 para Claude Code en PowerShell como administrador:

powershellexec0 para Claude Code, como administrador
# turn off
poison0 setup-claude --toolgate-off
# turn on
poison0 setup-claude --toolgate

Exclusiones de Defender con directiva de grupo

  1. Abra Computer Configuration → Administrative Templates → Windows Components → Microsoft Defender Antivirus → Exclusions → Path Exclusions. Windows 10 anterior a la versión 2004 muestra Windows Defender Antivirus en esta ruta.
  2. Elija Enabled y luego Show....
  3. Añada cada ruta como Value name, con el Value 0.
  4. Ejecute gpupdate /force en el dispositivo.

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 dispositivo es un dispositivo en la nube, que ignora el archivo.

Siga leyendo

Otros sistemas operativos: resumen de la instalación. Hardware: Requisitos del sistema. Aislamiento del motor: sandbox de Windows.