Dieses Thema mit einer KI besprechen

Sie bekommen eine Antwort aus der Dokumentation und die Seite, auf der sie steht.

Installation & Betrieb

Den poison0-Agenten auf Windows installieren

Den poison0-Agenten auf Windows installieren, ausrollen, prüfen und entfernen, von Hand oder mit Intune.

Lesezeit ~7 Min · Installation & Betrieb

Voraussetzungen

VoraussetzungDetails
ProzessorWindows x64 mit AVX2 (Intel Haswell, 2013, oder neuer, AMD Zen oder neuer). Windows on ARM wird nicht unterstützt.
RechtePowerShell als Administrator. Windows PowerShell 5.1 und PowerShell 7 funktionieren beide.
DateisystemDas Datenverzeichnis muss auf einem NTFS-Laufwerk liegen.
Microsoft DefenderPfadausnahmen, gesetzt vor der Installation, weil das Programm nicht codesigniert ist. Siehe Schritt 1 unter Auf viele Geräte ausrollen.
InstallationsschlüsselEin Installationsschlüssel aus der Konsole, unter Geräte → Mehrere Geräte per Schlüssel.

Diese KI-Agenten bekommen auf Windows Hooks. Alle Schutzfunktionen je Agent: Unterstützte Agenten.

AgentHooks auf Windows
Claude CodeUnterstützt. Die Befehle /pz, die Statusline und leak0 werden je Nutzer eingerichtet.
CodexUnterstützt ab Codex CLI 0.159.
Gemini CLI, Antigravity, GitHub Copilot CLI, Windsurf / DevinUnterstützt.
Cursor, Cortex Code, Kiro, ClineKeine Hooks auf Windows. Der Memory-Schutz deckt ihre Dateien weiter ab.
OpenCode, OpenClaw, Kilo 7.xKilo 7.x: Unterstützt. Das Plugin lädt aus einer verwalteten Kopie in C:\ProgramData\kilo, die nur Administratoren ändern können; eine Kopie im Benutzerprofil tritt zurück. Ein Start von Kilo ohne Plugins (KILO_PURE, --pure) wird blockiert. OpenCode, OpenClaw: Auf Windows noch nicht geprüft.

Ein Gerät installieren

Führen Sie diesen Befehl in PowerShell als Administrator aus.

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

Der Installer prüft das Programm gegen SHA256SUMS und bricht bei einer Abweichung ab. Dann registriert er das Gerät und richtet den Dienst ein.

In einer interaktiven Konsole fragt der Installer nach der Beschleunigung und den KI-Agenten. Zusätzlich fragt er, ob er den Gerätenamen an die Konsole senden soll. Sie antworten mit Ja oder Nein, eine Vorgabe gibt es nicht. Ja sendet den Computernamen, Nein sendet keinen Namen. Ohne Konsole fragt er nichts, installiert für die CPU und sendet keinen Namen.

Gerät prüfen

  1. Führen Sie Get-ScheduledTask -TaskName PoisonZero aus. Die Aufgabe sollte laufen.
  2. Führen Sie poison0 doctor in der Sitzung des Nutzers aus. Der Befehl nennt, was nicht stimmt.
  3. Öffnen Sie die Konsole. Das Gerät steht unter Geräte.

poison0 ist auch als p0 und pz aufrufbar. Nutzt bereits ein anderes Programm einen dieser Namen, wird dieser Alias nicht angelegt.

Nach der ersten Installation lädt das Modell im Hintergrund. Die festen Regeln schützen sofort.

Auf viele Geräte ausrollen

Nutzen Sie Intune und halten Sie die Reihenfolge der Schritte ein.

1. Ausnahmen für Microsoft Defender setzen

Nehmen Sie diese drei Pfade aus, bevor Sie die App zuweisen. Prozessausnahmen sind nicht nötig.

textPfadausnahmen
C:\Program Files\PoisonZero
C:\ProgramData\PoisonZero
C:\Users\*\AppData\Local\PoisonZero

* deckt jedes Benutzerprofil ab. Nutzen Sie nicht %LOCALAPPDATA% oder %USERPROFILE%. Defender läuft als LocalSystem und löst sie zu C:\Windows\System32\config\systemprofile auf.

  1. Öffnen Sie in Intune Endpoint security → Antivirus → Create policy.
  2. Wählen Sie die Plattform Windows und das Profil Microsoft Defender Antivirus exclusions.
  3. Tragen Sie die drei Pfade unter Excluded paths ein.
  4. Weisen Sie die Richtlinie denselben Gruppen zu wie die App.

Zum Prüfen eines Geräts nutzen Sie die Befehle unter Fehlerbehebung. Für Gruppenrichtlinie statt Intune siehe Referenz.

2. Einen Installationsschlüssel erzeugen

  1. Öffnen Sie in der Konsole Geräte → Mehrere Geräte per Schlüssel und wählen Sie Schlüssel erzeugen.
  2. Kopieren Sie den Schlüssel. Die Konsole zeigt ihn nur einmal.
  3. Speichern Sie ihn für den nächsten Schritt in einer Datei, zum Beispiel C:\secure\code.txt.

Der Schlüssel gilt 30 Tage und registriert Geräte bis zum Limit Ihres Tarifs, bei Enterprise beliebig viele. Jedes Gerät bekommt eine eigene Kennung.

Um den Schlüssel per Skript zu erzeugen, nutzen Sie die Management-API wie unter Alternative.

3. Das fertige Paket herunterladen

Laden Sie die beiden App-Dateien und die beiden Erkennungsskripte des aktuellen Releases herunter und prüfen Sie ihren SHA-256. Sie enthalten keinen Installationsschlüssel, und detect.ps1 trägt bereits die Release-Version.

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"

Die letzte Zeile gibt die Release-Version für den Installationsbefehl aus. Für ein festes Release ersetzen Sie latest durch v<version>.

Das Paket in der Konsole herunterladen

  1. Öffnen Sie in der Konsole Geräte, klappen Sie Mehrere Geräte per Schlüssel auf und wählen Sie Intune-Paket herunterladen. Lassen Sie Windows ausgewählt.
  2. Optional: Setzen Sie den Haken bei Computername als Gerätenamen verwenden. Wählen Sie dann Herunterladen. Die Konsole lädt das fertige Paket als .intunewin-Datei herunter, mit einem neuen Installationsschlüssel darin.
  3. Übernehmen Sie die Werte, die die Konsole danach zeigt, in die Intune-Apps von Schritt 4. Der Installationsbefehl ist nur install.cmd, weil der Schlüssel schon im Paket steckt. Die Links zu detect.ps1, user-setup.intunewin und detect-user.ps1 stehen ebenfalls dort.

Das ersetzt die Schritte 2 und 3, Schritt 1 bleibt. Das Paket enthält einen Installationsschlüssel, den alle Intune-Admins in der App sehen. Die Konsole listet ihn als Intune mit dem Datum. Er gilt ein Jahr, widerrufen Sie ihn nach dem Rollout.

Alternative: das Paket selbst bauen

Mit einem eigenen Paket steht der Schlüssel im Paket (installcode.txt) statt im Installationsbefehl.

Laden Sie die ZIP-Datei herunter, prüfen Sie ihren SHA-256 und entpacken Sie sie:

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

Für ein festes Release ersetzen Sie latest durch v<version>, zum Beispiel v1.16.55.

Bauen Sie den Paketordner. Der Schlüssel landet in installcode.txt. Windows PowerShell 5.1 (in Windows enthalten) genügt; PowerShell 7 ist optional.

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

Oder erzeugen Sie den Schlüssel mit der Management-API und bauen das Paket in einem Befehl. Der Schlüssel wird nie ausgegeben.

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

Bauen Sie die beiden App-Dateien mit dem Win32 Content Prep Tool von Microsoft, das nicht in der ZIP-Datei liegt. Es schreibt install.intunewin und user-setup.intunewin nach 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
Die .intunewin-Datei enthält den Installationsschlüssel. Behandeln Sie sie wie den Schlüssel. Widerrufen Sie den Schlüssel nach dem Rollout in der Konsole.

4. Die Intune-Apps anlegen

Legen Sie zwei Win32-Apps an und weisen Sie beide zu, sobald die Defender-Richtlinie als angewendet erscheint. Die Haupt-App installiert den Agenten als SYSTEM. Die App je Nutzer richtet die KI-Agenten in jedem Benutzerkonto ein.

Der Schlüssel im Installationsbefehl ist für Intune-Administratoren in den App-Einstellungen sichtbar. Widerrufen Sie ihn nach dem Rollout in der Konsole.

Standardmäßig wird kein Gerätename gesendet. Für einen Namen ergänzen Sie den Installationsbefehl um -DeviceNameFromHostname (der Computername; Ihre ausdrückliche Wahl, PoisonZero empfiehlt es nicht) oder -DeviceNamesCsv <https-URL> (eine CSV mit der Kopfzeile hostname,name; gesendet wird nur der Name).

Haupt-AppWert
App-Dateiinstall.intunewin.
Install commandEmpfohlen: install.cmd -Version latest -InstallCode "<schlüssel>", das installiert das neueste Release (Pakete ab 1.16.88; mit einem älteren Paket -Version weglassen). Ein festes Release stattdessen: install.cmd -Version 1.16.55 -InstallCode "<schlüssel>", mit der Version aus Schritt 3. Mit eigenem Paket entfällt -InstallCode: der Schlüssel kommt aus installcode.txt.
Uninstall commanduninstall.cmd. Es entfernt zuerst die Hooks aller Nutzer.
Install behaviorSystem. Der Installer braucht SYSTEM-Rechte.
Device restart behaviorNo specific action. Die Installation braucht keinen Neustart.
Return codes0 bedeutet Erfolg. 1 bedeutet Fehler, auch bei einer fehlgeschlagenen Registrierung.
Operating system architectureWählen Sie nur x64.
Detection ruleEigenes Skript detect.ps1. Setzen Sie Run script as 32-bit process on 64-bit clients auf No.
App je NutzerWert
App-Dateiuser-setup.intunewin.
Install commandpowershell.exe -NoProfile -ExecutionPolicy Bypass -File user-setup.ps1. Mit -StatusLine kommt die Statusline in Claude Code dazu.
Uninstall commandcmd.exe /c exit 0, weil Intune einen verlangt. Die Haupt-App entfernt die Hooks.
Install behaviorUser. Das Skript braucht keine Administratorrechte.
DependenciesDie PoisonZero-App, mit Automatically install auf Yes.
Return codes0 bedeutet Erfolg. 1 bedeutet Fehler.
Detection ruleEigenes Skript detect-user.ps1, das %USERPROFILE%\.claude\commands\pz.md prüft. Setzen Sie Run script as 32-bit process on 64-bit clients auf No.

Configuration Manager

Configuration Manager (SCCM) haben wir noch nicht getestet.

Nutzen Sie den Paketordner in einer Anwendung mit Skript-Installer, die als SYSTEM läuft, mit den Werten der Haupt-App. Verteilen Sie user-setup.ps1 im Benutzerkontext mit detect-user.ps1 und einer Abhängigkeit von dieser Anwendung.

Private Geräte: signierte Konfiguration

Ein privates Gerät holt keine Einstellungen aus der Cloud. Es liest eine signierte client-config.json.

  1. Öffnen Sie in der Konsole das Profil und wählen Sie Für Private exportieren. Die Konsole zeigt ein Skript, das die Datei ablegt.
  2. Legen Sie mit diesem Skript eine App an und tragen Sie Exit-Code 6 als Erfolgscode ein. 6 bedeutet, dass das Gerät die Datei später prüft.
  3. Weisen Sie die App nur privaten Geräten zu. Auf einem Cloud-Gerät endet das Skript mit 7, einem Fehler.

Auf einem einzelnen Gerät setzen Sie PZ_CONFIG auf den Dateipfad, bevor Sie den Installationsbefehl ausführen. Die Datei liegt dann unter %ProgramData%\PoisonZero\client-config.json, lesbar nur für SYSTEM und Administratoren.

Update

Cloud-Geräte aktualisieren sich selbst. Ausschalten können Sie das je Gerät in der Konsole unter Settings → Schutz & Geräte → Updates. Diese Einstellung haben wir auf Windows noch nicht getestet. Private Geräte aktualisieren sich nicht selbst.

Für ein Update von Hand führen Sie den Installationsbefehl erneut aus. Die Zugangsdaten bleiben erhalten. Mehr unter Updates und Lebenszyklus.

Ab dieser Version ist die Programmdatei poison0.exe. poisonzero.exe bleibt als Kopie erhalten, Ordnerausschlüsse bleiben gültig. Für Datei- oder Prozessausschlüsse fügen Sie poison0.exe hinzu und behalten poisonzero.exe, weil Agenten-Hooks es weiter aufrufen.

Deinstallieren

Führen Sie diesen Befehl in PowerShell als Administrator aus. Mit Intune deinstallieren Sie stattdessen die App, die uninstall.cmd ausführt.

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

Die Deinstallation entfernt zuerst die Agent-Hooks aller Nutzer und bricht ab, wenn das fehlschlägt. Danach entfernt sie die geplante Aufgabe, das Programm für Bestätigungsdialoge, die Befehle, das Programm und das Datenverzeichnis.

Eine Scoop-Installation entfernen Sie mit scoop uninstall poisonzero.

Löschen Sie das Programm nicht von Hand. Claude-Code-Hooks, die auf ein fehlendes Programm zeigen, blockieren jeden Tool-Aufruf.

Offene Quarantänefälle

Die Deinstallation listet jeden offenen Quarantänefall mit Originalpfad, Quarantänekopie (*.infection.pz) und Weg zur Wiederherstellung. Eine Kopie bleibt in %ProgramData%\PoisonZero-quarantine, lesbar nur für SYSTEM und Administratoren.

Mit PZ_UNINSTALL_SKIP_QUARANTINE_COPY=1 entfällt diese Kopie. Nichts wird automatisch wiederhergestellt. Prüfen Sie jede Datei, bevor Sie sie wiederherstellen.

Zurückgehaltene Änderungen, die noch auf Prüfung warten, verwirft die Deinstallation. Um eine zu behalten, geben Sie sie vorher frei: Listen Sie sie mit poison0 quarantine pending auf und führen Sie poison0 quarantine pending approve <id> aus.

Fehlerbehebung

SymptomUrsacheLösung
Die Installation endet mit Exit-Code 1 und not enrolled: <reason> im Log.Die Registrierung ist fehlgeschlagen, zum Beispiel mit device_limit, expired, revoked oder max_redemptions. Eine Erstinstallation wird zurückgenommen.Beheben Sie die genannte Ursache in der Konsole, zum Beispiel mit einem neuen Installationsschlüssel, und installieren Sie erneut.
Die Installation schlägt mit code_unknown fehl.Sie haben den Enrollment-Code von einer Geräteseite ohne seine App-ID genutzt.Übergeben Sie beides: install.cmd -AppId <app-id> -InstallCode "<code>".
Ein widerrufenes Gerät registriert sich nicht erneut.Ein registriertes Gerät bekommt bei Neuinstallation oder Update keinen Schlüssel.Ergänzen Sie einmal -ForceEnroll im Installationsbefehl.
Die Konsole zeigt nach dem Rollout keinen Gerätenamen.PoisonZero sendet standardmäßig keinen Gerätenamen.Benennen Sie das Gerät in der Konsole um, oder ergänzen Sie den Installationsbefehl um -DeviceNameFromHostname oder -DeviceNamesCsv. Das gilt, wenn sich ein Gerät registriert.
Der Installationsschlüssel ist in Intune und in den Logs auf den Geräten sichtbar.Sie haben ihn mit install.cmd -InstallCode übergeben.Bauen Sie das Paket mit -InstallCodeFromStdin.
Intune installiert die App bei jeder Prüfung neu.$MinVersion in detect.ps1 ist höher als die installierte Version.Halten Sie $MinVersion bei oder unter der installierten Version. build-package.ps1 -Version setzt den Wert.
Intune meldet die App je Nutzer als fehlgeschlagen.Die PoisonZero-App ist auf dem Gerät nicht installiert, daher endet das Skript mit Exit 1. Die App je Nutzer braucht die Abhängigkeit von der PoisonZero-App.Fügen Sie die Abhängigkeit von der PoisonZero-App hinzu. Ein Nutzer ohne Claude Code wird sofort erkannt, weil das Skript das Profil im Voraus vorbereitet.
Defender blockiert oder entfernt das Programm, mit Ereignis-ID 1116 oder 1117.Defender hat das unsignierte Programm in einem Pfad erkannt, den keine Ausnahme abdeckt.Prüfen Sie die Ausnahmen mit den Befehlen unter dieser Tabelle. Nutzen Sie genau die drei Pfade aus Schritt 1.
Defender blockiert Ihren Ausnahmebefehl als Trojan:Win32/PowExcEnv.RXH!MTB.Sie haben die Ausnahmen mit powershell -EncodedCommand ... Add-MpPreference ... gesetzt, deshalb fehlen sie.Setzen Sie sie mit Intune oder per Gruppenrichtlinie.
Get-MpPreference zeigt keine Pfadausnahmen.Ohne Administratorrechte zeigt er einen Hinweis. HideExclusionsFromLocalAdmins verbirgt die Pfade auch vor Administratoren, sie gelten aber.Führen Sie den Befehl als Administrator aus, oder testen Sie einen Pfad mit MpCmdRun.exe -CheckExclusion.
poison0 doctor zeigt, dass der Download des Modells fehlgeschlagen ist.Der Download im Hintergrund nach der ersten Installation wurde nicht abgeschlossen.Führen Sie poison0 model als Administrator aus, um es sofort erneut zu versuchen. poison0 doctor zeigt den Grund.
poison0 doctor meldet "GPU present but no Vulkan driver".vulkan-1.dll fehlt im Systemverzeichnis, oder es ist kein Vulkan-Treiber registriert.Installieren oder aktualisieren Sie den Treiber des GPU-Herstellers. Bis dahin läuft die Engine auf der CPU und inject0 bleibt aus.
poison0 exec0 status zeigt, dass Claude Code den exec0-Hook nicht aufruft.Die Claude-Code-Einstellungen kommen aus Gruppenrichtlinie oder Intune (HKLM\SOFTWARE\Policies\ClaudeCode) oder der Admin-Konsole von claude.ai. Claude Code ignoriert dann 50-poisonzero-exec0.json.Setzen Sie dort "managedSourcesBehavior": "merge" (Claude Code 2.1.242 oder neuer), oder kopieren Sie den Inhalt der Datei hinein. poison0 doctor warnt inject0 failure hook missing: Claude Code fehlt der Hook-Eintrag PostToolUseFailure, daher prüft inject0 die Ausgabe fehlgeschlagener Tool-Aufrufe nicht. Kommen die Einstellungen aus Gruppenrichtlinie oder Intune (HKLM\SOFTWARE\Policies\ClaudeCode), aus managed-settings.json oder der Admin-Konsole von claude.ai, muss diese Quelle den Eintrag enthalten. Übernehmen Sie den Eintrag PostToolUseFailure aus 50-poisonzero-exec0.json neben PostToolUse in diese Quelle. Ohne zentrale Einstellungen: poison0 setup-claude --toolgate.
poison0 status oder poison0 doctor zeigt Codex als nicht geschützt.Codex CLI ist älter als 0.159. Oder auf dem Systemlaufwerk sind 8.3-Kurznamen aus, und Codex kann den Hook aus C:\Program Files\PoisonZero nicht starten, weil der Pfad ein Leerzeichen enthält.Aktualisieren Sie Codex CLI auf 0.159 oder neuer. Ohne 8.3-Kurznamen kann exec0 Codex auf diesem Gerät nicht schützen. Nachträglich eingeschaltete 8.3-Namen helfen nicht.
Die Installation bricht nach der Registrierung ab, und die signierte Konfiguration wird nicht abgelegt.poison0 config verify hat client-config.json abgelehnt. Eine vorhandene Datei bleibt.Schlagen Sie den Exit-Code unter Referenz nach.
Die Deinstallation bricht ab und entfernt nichts.Sie konnte die Agent-Hooks nicht bei allen Nutzern entfernen.Setzen Sie PZ_UNINSTALL_FORCE=1 und entfernen Sie die restlichen Einträge von Hand.

Führen Sie diese Befehle in einer PowerShell mit Administratorrechten aus. MpCmdRun.exe liegt im Plattformordner von Defender, %ProgramData%\Microsoft\Windows Defender\Platform\<version>.

powershellPowerShell als Administrator
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

Referenz

Version festlegen und Erkennung

ParameterWirkung
-Versionlatest installiert das neueste Release, wie ohne den Parameter. Eine Version wie 1.16.55 installiert stattdessen dieses Release und ersetzt nie ein neueres installiertes Programm; eine nie veröffentlichte Version wird vor dem Download abgelehnt. Mit build-package.ps1 setzt eine Version auch $MinVersion in detect.ps1.
-Sha256 <hex>Prüft das Programm gegen einen Hash aus einer Quelle, der Sie vertrauen, nur mit -Version. SHA256SUMS kommt vom selben Server und erkennt nur einen beschädigten Download.

detect.ps1 meldet die App als installiert, wenn das Programm existiert, das Gerät registriert ist, die Version mindestens $MinVersion ist und die Aufgabe PoisonZero existiert. Neuere Versionen zählen, weil sich Cloud-Geräte selbst aktualisieren.

Umgebungsvariablen

Setzen Sie die Variablen, bevor Sie den Installer starten. Bei install.ps1 als Datei haben -Version, -Sha256, -Config und -Uninstall Vorrang vor ihren Variablen. install.cmd aus dem Intune-Paket leert PZ_ENROLL_CODE, PZ_APP_ID, PZ_VERSION, PZ_SHA256 und PZ_UNINSTALL. Nutzen Sie dort seine Parameter.

VariableWirkung
PZ_ENROLL_CODEDer Installationsschlüssel aus der Konsole. Auf einem registrierten Gerät registriert ein neuer Schlüssel es erneut.
PZ_APP_IDNur für einen Einmal-Code, der mit einer App-ID kam.
PZ_VERSIONWie -Version, zum Beispiel latest oder 1.16.55.
PZ_SHA256Wie -Sha256. Nutzen Sie es nur mit PZ_VERSION.
PZ_ALLOW_DOWNGRADEAuf 1 setzen, damit ein festgelegtes Release ein neueres installiertes Programm ersetzen darf.
PZ_HEADLESSWie Bestätigungsdialoge behandelt werden, wenn kein Desktop-Nutzer antworten kann. none (Standard) richtet sich nach dem angemeldeten Nutzer, standard behandelt das Gerät immer als Gerät ohne Desktop, strict ist am strengsten.
PZ_DEVICE_NAMEDer Gerätename in der Konsole, gespeichert als Kleinbuchstaben, Ziffern und Bindestriche, höchstens 63 Zeichen. Der Installer zeigt, wie der Name gespeichert wird. Weitere Varianten beschreibt das Onboarding.
PZ_SETUP_AGENTSTrägt den lokalen Statistikbefehl /poison0 in die genannten Agenten ein, zum Beispiel claude,codex, wenn jemand angemeldet ist.
PZ_SETUP_STATUSLINEAuf 1 setzen, um die Statusline in Claude Code einzutragen. Eine vorhandene Statusline bleibt.
PZ_SETUP_EXEC0Auf off setzen, damit exec0 aus bleibt, auch nach Updates. Andere Werte werden ignoriert. Eingeschaltet wird es im Konsolenprofil oder mit poison0 exec0 observe bzw. enforce.
PZ_SETUP_LEAK0Nur für private Geräte. Setzt den leak0-Modus: enforce, observe oder off. Ohne die Variable und ohne Konsole bleibt leak0 aus.
PZ_BACKENDcpu (Standard) oder gpu. Mit gpu warnt der Installer, wenn er keinen Vulkan-Treiber findet.
PZ_TIERenterprise (Standard) oder ultra. Mit ultra bricht die Installation ab, wenn die Grafikkarte weniger als 8 GB Grafikspeicher oder keinen Vulkan-Treiber hat.
PZ_NO_SHORT_ALIASAuf 1 setzen, um den Kurzbefehl p0 auszulassen.
PZ_FETCH_ONLYAuf 1 setzen, um das Programm nur herunterzuladen und zu prüfen, ohne Dienst und ohne Administratorrechte. Es landet in .\poison0.exe oder in PZ_FETCH_DEST.
PZ_DRY_RUNAuf 1 setzen, um den Installationsmodus auszugeben und vor jeder Änderung zu beenden.
PZ_CONFIGPfad zu einer signierten client-config.json für ein privates Gerät.
PZ_QUARANTINE_RETENTION_DAYSNur für private Geräte. Tage, die ein Quarantänefall aufbewahrt wird, 1 bis 3650.
PZ_AUDIT_MAX_MBNur für private Geräte. Größe in MB, ab der das Audit-Log rotiert, 1 bis 1024.
PZ_UNINSTALLAuf 1 setzen, um über irm ... | iex ohne Argumente zu deinstallieren.

Pfade und Dienst

ElementOrt
Das Programm und seine Befehle.C:\Program Files\PoisonZero\poison0.exe, mit pz-dialog.exe. poisonzero.exe daneben ist eine Kopie für Skripte und Hooks, die es aufrufen. Der Ordner und sein Unterordner bin mit p0 und pz liegen im System-PATH.
Das Datenverzeichnis.C:\ProgramData\PoisonZero, lesbar für alle Benutzer bis auf einzelne Dateien wie die Registrierungsdatei und client-config.json. Es enthält die Zugangsdaten, die Engine, die Logs und die Quarantäne.
Der Ordner je Nutzer.%LOCALAPPDATA%\PoisonZero in jedem Profil. Er enthält den Zustand der Bestätigungsdialoge und das Dialog-Log.
Der Dienst.Die geplante Aufgabe PoisonZero. Sie läuft als SYSTEM ab Systemstart, startet bis zu 3-mal im Abstand von 1 Minute neu und wird alle 5 Minuten erneut gestartet.
Das Programm für Bestätigungsdialoge.Es startet bei der Anmeldung in jeder Benutzersitzung über den Registry-Wert PoisonZeroNotifier unter Run.
Das Dienst-Log.daemon.log im Datenverzeichnis, rotiert bei 5 MB. Es ist das einzige Dienst-Log.
Das Installationslog.Der Installer schreibt auf die Standardausgabe. Unter Intune landet sie in den Logs der Intune Management Extension.
Die exec0-Hooks für Claude Code.C:\Program Files\ClaudeCode\managed-settings.d\50-poisonzero-exec0.json.

GPU und Ultra

ElementVerhalten
GPU-EngineAuf Windows nutzt die GPU-Engine Vulkan; Ultra braucht einen Vulkan-Treiber und mindestens 8 GB Grafikspeicher; inject0 läuft nur auf der GPU, braucht einen Vulkan-Treiber von Intel, AMD oder NVIDIA und meldet ohne geeignete GPU inject0: off (no suitable GPU) ohne Rückfall auf die CPU.
KonsolenprofilEs legt fest, ob ein Gerät die GPU oder Ultra nutzt. Verlangt es die GPU und keine wird unterstützt, startet die Engine nicht, ohne Rückfall auf die CPU.
exec0Läuft auf der CPU und braucht keine GPU (Enterprise).
SandboxAuf der GPU (Ultra oder inject0) läuft die Engine ohne AppContainer. Siehe Windows-Sandbox.

exec0 für Claude Code

Schalten Sie exec0 für Claude Code in PowerShell als Administrator aus oder ein:

powershellexec0 für Claude Code, als Administrator
# turn off
poison0 setup-claude --toolgate-off
# turn on
poison0 setup-claude --toolgate

Defender-Ausnahmen per Gruppenrichtlinie

  1. Öffnen Sie Computer Configuration → Administrative Templates → Windows Components → Microsoft Defender Antivirus → Exclusions → Path Exclusions. Windows 10 vor Version 2004 zeigt in diesem Pfad Windows Defender Antivirus.
  2. Wählen Sie Enabled, dann Show....
  3. Tragen Sie jeden Pfad als Value name ein, mit dem Value 0.
  4. Führen Sie auf dem Gerät gpupdate /force aus.

Exit-Codes der signierten Konfiguration

poison0 config verify gibt diese Codes zurück. Der Installer legt die Datei nur bei 0 oder 6 ab.

Exit-CodeBedeutung
0Die Datei ist gültig.
6Die Lizenz fehlt noch. Der Dienst prüft die Datei beim Start.
1Die Datei ist nicht lesbar.
3Die Datei ist nicht für dieses Gerät signiert.
4Die Datei ist veraltet oder abgelaufen.
5Die Datei ist ungültig oder zu neu für diese Agent-Version.
7Das Gerät ist ein Cloud-Gerät, das die Datei ignoriert.

Weiterlesen

Andere Betriebssysteme: Installationsüberblick. Hardware: Systemvoraussetzungen. Isolation der Engine: Windows-Sandbox.