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 Linux installieren

Den poison0-Agenten auf Linux installieren, ausrollen, prüfen und entfernen.

Lesezeit ~4 Min · Installation & Betrieb

Voraussetzungen

VoraussetzungDetails
Prozessorx86-64 mit AVX2 (Intel Haswell, 2013, oder neuer, AMD Zen oder neuer), oder ARM64 mit i8mm, zum Beispiel AWS Graviton 3 oder 4 und Ampere One. AWS Graviton 2 und Ampere Altra werden nicht unterstützt.
KernelKernel 5.13 oder neuer mit aktivem Landlock, wie bei Ubuntu 22.04, Debian 12 und RHEL 9.6 oder neuer. Sonst ergänzen Sie landlock im Boot-Parameter lsm=.
ContainerDas Standard-seccomp-Profil von Docker blockiert die Landlock-Systemaufrufe. Nutzen Sie ein angepasstes Profil.
Rechteroot-Rechte. Der Installer läuft über sudo.
InstallationsschlüsselEin Installationsschlüssel aus der Konsole, unter Geräte → Mehrere Geräte per Schlüssel.
KI-AgentenMindestens ein KI-Agent aus Unterstützte Agenten.

Einen Rechner installieren

Führen Sie diesen Befehl in einem Terminal aus.

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

Der Installer prüft das Programm gegen SHA256SUMS und bricht bei einer Abweichung ab. Dann installiert er den Dienst und registriert den Rechner. Fehlt dem Desktop ein Dialogprogramm für Bestätigungsdialoge, versucht er zenity zu installieren. In einem Terminal fragt er zusätzlich, ob er den Gerätenamen an die Konsole senden soll. Sie antworten mit Ja oder Nein, eine Vorgabe gibt es nicht. Ja sendet den Hostnamen des Rechners, Nein sendet keinen Namen. Bei Ansible und in Skripten ohne Terminal fragt er nicht und sendet keinen Namen.

Die Standardwerte ändern Sie mit den Umgebungsvariablen unter Referenz.

Rechner prüfen

  1. Führen Sie systemctl status poisonzero aus. Der Dienst sollte aktiv sein. journalctl -u poisonzero zeigt sein Log.
  2. Führen Sie poison0 doctor in Ihrer Desktop-Sitzung aus. Der Befehl nennt, was nicht stimmt.
  3. Öffnen Sie die Konsole. Der Rechner 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 Rechner ausrollen

Nutzen Sie Ansible oder ein anderes Skript, das als root läuft.

1. Den Agenten installieren

Ohne Terminal übergeben Sie den Schlüssel als Umgebungsvariable. Auf einem Server ohne Desktop setzen Sie zusätzlich PZ_HEADLESS.

bashAls root
PZ_ENROLL_CODE="<install-key>" sh -c "$(curl -fsSL https://poisonzero.com/install.sh)"

2. Optional: /pz und Statusline einrichten

Den Schutz für die KI-Agenten richtet PoisonZero nach der Installation selbst ein, in jedem Benutzerkonto und für alle unterstützten Agenten. Wer zusätzlich /pz und die Statusline möchte, führt diese Befehle einmal im Benutzerkonto aus. Der zweite trägt die Statusline ein.

bashNutzer
poison0 setup-claude
poison0 setup-claude --statusline-only

Intune (Linux)

Intune führt auf Ubuntu Desktop 24.04 und 26.04 sowie Red Hat Enterprise Linux 9 und 10 Bash-Skripts aus. Der Rechner muss in Intune angemeldet sein.

  1. Öffnen Sie in der Konsole Geräte, wählen Sie Intune-Paket herunterladen und dort Linux. Die Konsole lädt das Skript herunter.
  2. Legen Sie in Intune unter Geräte → Skripts und Wartungen → Plattformskripts → Hinzufügen → Linux ein Skript an und laden Sie die Datei hoch.
  3. Wählen Sie als Ausführungskontext Root. Die Häufigkeit ist beliebig, Intune führt das Skript standardmäßig alle 15 Minuten aus. Bei Wiederholungen bei Fehler tragen Sie zum Beispiel 3 ein.
  4. Weisen Sie das Skript einer Gerätegruppe zu.

Das Skript meldet einen Rechner, der schon registriert ist, kein zweites Mal an. Beim ersten Lauf kann Intune die Zustimmung des Benutzers verlangen. Das Skript enthält einen Installationsschlüssel, den alle Intune-Admins mit Leserecht auf Skripts sehen. Die Konsole listet ihn als Intune Linux mit dem Datum. Er gilt ein Jahr, widerrufen Sie ihn nach dem Rollout.

Private Rechner: signierte Konfiguration

Ein privater Rechner holt keine Einstellungen aus der Cloud. Er liest eine signierte client-config.json.

  1. Öffnen Sie in der Konsole das Profil und wählen Sie Für Private exportieren.
  2. Übergeben Sie die Datei mit PZ_CONFIG an den Installer, wie unten gezeigt.
  3. Oder legen Sie sie mit dem Ansible-Task ab, den die Konsole nach dem Export zeigt.
bashTerminal
curl -fsSL https://poisonzero.com/install.sh | sudo \
  PZ_ENROLL_CODE="<install-key>" PZ_CONFIG="./client-config.json" sh

Der Installer prüft die Datei mit poison0 config verify und legt sie unter /etc/poisonzero/client-config.json ab, lesbar nur für root.

Update

Cloud-Geräte aktualisieren sich selbst. Ausschalten können Sie das je Gerät in der Konsole unter Settings → Schutz & Geräte → Updates. 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 /usr/local/bin/poison0. poisonzero verweist darauf und funktioniert weiter, Ordnerausschlüsse bleiben gültig. Für Datei- oder Prozessausschlüsse fügen Sie poison0 hinzu und behalten poisonzero, weil Agenten-Hooks es weiter aufrufen.

Deinstallieren

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

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

Eine Installation per .deb oder .rpm entfernen Sie mit dem Paketmanager. Er nimmt zuerst die Hooks heraus.

bashPakete
sudo apt remove poisonzero   # .deb
sudo dnf remove poisonzero   # .rpm
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 /var/lib/poisonzero-quarantine, lesbar nur für root.

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 Engine startet nicht.Landlock ist nicht aktiv.Aktivieren Sie Landlock wie unter Voraussetzungen beschrieben.
poison0 doctor zeigt, dass der Download des Modells fehlgeschlagen ist.Der Download im Hintergrund nach der ersten Installation wurde nicht abgeschlossen.Führen Sie sudo poison0 model aus, um es sofort erneut zu versuchen. poison0 doctor zeigt den Grund.
poison0 exec0 status zeigt, dass Claude Code den exec0-Hook nicht aufruft.Die Claude-Code-Einstellungen kommen aus der Admin-Konsole von claude.ai. Claude Code ignoriert dann 50-poisonzero-exec0.json.Setzen Sie in dieser Quelle "managedSourcesBehavior": "merge" (Claude Code 2.1.242 oder neuer), oder kopieren Sie den Inhalt der Datei hinein.
poison0 doctor meldet, dass die verwalteten Hooks aus sind.Die verwalteten Einstellungen von Claude Code setzen "disableAllHooks": true. Das schaltet auch die verwalteten Hooks des Agenten aus.Entfernen Sie die Einstellung dort, wo sie gesetzt ist: in managed-settings.json, einer anderen Datei in managed-settings.d/ oder der Admin-Konsole von claude.ai. Der Agent ändert diese Quellen nie.
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.

Referenz

Umgebungsvariablen

Setzen Sie die Variablen, bevor der Installer startet. Ein Flag, übergeben nach sh -s --, hat Vorrang vor seiner Variablen.

VariableWirkung
PZ_ENROLL_CODEDer Installationsschlüssel aus der Konsole. Auf einem registrierten Rechner registriert ein neuer Schlüssel ihn erneut.
PZ_APP_IDNur für einen Einmal-Code, der mit einer App-ID kam.
PZ_HEADLESSWie Bestätigungsdialoge behandelt werden, wenn kein Desktop-Nutzer antworten kann. none (Standard) richtet sich nach dem angemeldeten Nutzer, standard behandelt den Rechner immer als Gerät ohne Desktop, strict ist am strengsten. Flag: --headless.
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.
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 sudo 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 Terminal bleibt leak0 aus.
PZ_BACKENDcpu (Standard) oder gpu. Ob der Rechner die GPU nutzt, legt das Konsolenprofil fest.
PZ_TIERenterprise (Standard) oder ultra. Mit ultra bricht der Installer mit einem Fehler ab. Legen Sie Ultra deshalb im Konsolenprofil fest.
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 root-Rechte. Es landet in ./poison0 oder in PZ_FETCH_DEST.
PZ_DRY_RUNAuf 1 setzen, um den Installationsmodus auszugeben und vor jeder Änderung zu beenden.
POISONZERO_DATA_DIRÄndert das Datenverzeichnis von Installer und Agent.
PZ_CONFIGPfad zu einer signierten client-config.json für einen privaten Rechner. Flag: --config.
PZ_QUARANTINE_RETENTION_DAYSNur für private Geräte. Tage, die ein Quarantänefall aufbewahrt wird, 1 bis 3650. Flag: --quarantine-retention-days.
PZ_AUDIT_MAX_MBNur für private Geräte. Größe in MB, ab der das Audit-Log rotiert, 1 bis 1024. Flag: --audit-max-mb.

Pfade und Dienst

ElementOrt
Das Programm und seine Befehle./usr/local/bin/poison0. Die Befehle poisonzero, p0 und pz verweisen darauf.
Das Datenverzeichnis./var/lib/poisonzero, Eigentümer poisonzero:poisonzero. Es enthält die Zugangsdaten, die Logs und die Quarantäne.
Das Konfigurationsverzeichnis./etc/poisonzero. Es enthält die Registrierungsdatei /etc/poisonzero/enroll und die signierte Konfiguration.
Der Dienst.Die systemd-Unit poisonzero.service. Sie startet beim Booten und läuft als root.
Das Programm für Bestätigungsdialoge.Es startet in jeder Desktop-Sitzung über XDG-Autostart, /etc/xdg/autostart/poisonzero-notifier.desktop.
Das Dienst-Log.daemon.log im Datenverzeichnis, rotiert bei 5 MB. Dieselben Zeilen gehen ins Journal.
Die exec0-Hooks für Claude Code.Eine Systeminstallation (install.sh, .deb oder .rpm) nutzt die eigene Datei /etc/claude-code/managed-settings.d/50-poisonzero-exec0.json, auch unter WSL. Eine Homebrew-Installation unter einem Präfix des Nutzers nutzt stattdessen ~/.claude/settings.json.

exec0-Hooks in Claude Code

Der Agent ändert nie Ihre managed-settings.json und keine anderen Dateien in managed-settings.d/. So schalten Sie exec0 für Claude Code aus oder ein:

bashexec0 für Claude Code
# turn off
sudo poison0 setup-claude --toolgate-off
# turn on
sudo poison0 setup-claude --toolgate

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.
7Der Rechner ist ein Cloud-Gerät, das die Datei ignoriert.

Weiterlesen

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