Installer l'agent poison0 sur Windows
Installer, déployer, vérifier et retirer l'agent poison0 sur Windows, à la main ou avec Intune.
Prérequis
| Prérequis | Détails |
|---|---|
| Processeur | Windows x64 avec AVX2 (Intel Haswell, 2013, ou plus récent, AMD Zen ou plus récent). Windows on ARM n'est pas pris en charge. |
| Droits | PowerShell en administrateur. Windows PowerShell 5.1 et PowerShell 7 fonctionnent tous les deux. |
| Système de fichiers | Le répertoire de données doit se trouver sur un volume NTFS. |
| Microsoft Defender | Des exclusions de chemin, définies avant l'installation, car le programme n'est pas signé. Voir l'étape 1 sous Déployer sur plusieurs appareils. |
| Clé d'installation | Une clé d'installation de la console, sous Appareils → Déployer plusieurs appareils avec une clé. |
Ces agents IA reçoivent des hooks sur Windows. Toutes les protections par agent : agents pris en charge.
| Agent | Hooks sur Windows |
|---|---|
| Claude Code | Pris en charge. Les commandes /pz, la ligne d'état et leak0 sont configurés par utilisateur. |
| Codex | Pris en charge à partir de Codex CLI 0.159. |
| Gemini CLI, Antigravity, GitHub Copilot CLI, Windsurf / Devin | Pris en charge. |
| Cursor, Cortex Code, Kiro, Cline | Pas de hooks sur Windows. La protection de la mémoire couvre toujours leurs fichiers. |
| OpenCode, OpenClaw, Kilo 7.x | Kilo 7.x: Pris en charge. Le plugin se charge depuis une copie gérée dans C:\ProgramData\kilo que seuls les administrateurs peuvent modifier ; une copie par utilisateur passe au second plan. Le démarrage de Kilo sans plugins (KILO_PURE, --pure) est bloqué. OpenCode, OpenClaw: Pas encore vérifiés sur Windows. |
Installer un appareil
Lancez cette commande dans PowerShell en administrateur.
$env:PZ_ENROLL_CODE="<install-key>" irm https://poisonzero.com/install.ps1 | iex
L'installeur vérifie le programme avec SHA256SUMS et s'arrête en cas d'écart. Puis il enregistre l'appareil et configure le service.
Dans une console interactive, l'installeur demande l'accélération et les agents IA à configurer. Il demande aussi s'il faut envoyer le nom de l'appareil à la console. Vous répondez Oui ou Non, il n'y a pas de valeur par défaut. Oui envoie le nom d'ordinateur, Non n'envoie aucun nom. Sans console, il ne demande rien, installe pour le CPU et n'envoie aucun nom.
Vérifier l'appareil
- Lancez
Get-ScheduledTask -TaskName PoisonZero. La tâche doit tourner. - Lancez
poison0 doctordans la session de l'utilisateur. Il nomme ce qui ne va pas. - Ouvrez la console. L'appareil apparaît sous Appareils.
poison0 répond aussi à p0 et pz. Si un autre programme utilise déjà l'un de ces noms, cet alias n'est pas créé.
Après la première installation, le modèle se télécharge en arrière-plan. Les règles fixes protègent tout de suite.
Déployer sur plusieurs appareils
Utilisez Intune et suivez ces étapes dans l'ordre.
1. Définir les exclusions Microsoft Defender
Excluez ces trois chemins avant d'attribuer l'application. Les exclusions de processus ne sont pas nécessaires.
C:\Program Files\PoisonZero C:\ProgramData\PoisonZero C:\Users\*\AppData\Local\PoisonZero
* couvre chaque profil utilisateur. N'utilisez pas %LOCALAPPDATA% ni %USERPROFILE%. Defender s'exécute en LocalSystem et les résout en C:\Windows\System32\config\systemprofile.
- Dans Intune, ouvrez Endpoint security → Antivirus → Create policy.
- Choisissez la plateforme Windows et le profil Microsoft Defender Antivirus exclusions.
- Ajoutez les trois chemins sous Excluded paths.
- Attribuez la stratégie aux mêmes groupes que l'application.
Pour vérifier un appareil, utilisez les commandes sous Dépannage. Pour une stratégie de groupe au lieu d'Intune, voir Référence.
2. Obtenir une clé d'installation
- Dans la console, ouvrez Appareils → Déployer plusieurs appareils avec une clé et choisissez Générer une clé.
- Copiez la clé. La console ne l'affiche qu'une fois.
- Sauvegardez-la dans un fichier pour l'étape suivante, par exemple
C:\secure\code.txt.
La clé est valable 30 jours et enregistre des appareils jusqu'à la limite de votre offre, sans limite sur Enterprise. Chaque appareil reçoit sa propre identité.
Pour créer la clé depuis un script, utilisez la Management API comme sous Alternative.
3. Télécharger le paquet prêt
Téléchargez les deux fichiers d'application et les deux scripts de détection de la version actuelle et vérifiez leur SHA-256. Ils ne contiennent aucune clé d'installation, et detect.ps1 porte déjà la version.
$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 dernière ligne affiche la version pour la commande d'installation. Pour une version fixe, remplacez latest par v<version>.
Télécharger le paquet dans la console
- Dans la console, ouvrez Appareils, développez Déployer plusieurs appareils avec une clé et sélectionnez Télécharger le paquet Intune. Laissez Windows sélectionné.
- Facultatif : cochez Utiliser le nom de l'ordinateur comme nom d'appareil. Sélectionnez ensuite Télécharger. La console télécharge le paquet prêt sous forme de fichier
.intunewin, avec une nouvelle clé d'installation à l'intérieur. - Reprenez les valeurs que la console affiche ensuite dans les applications Intune de l'étape 4. La Commande d'installation est simplement
install.cmd, car la clé est déjà dans le paquet. Les liens versdetect.ps1,user-setup.intunewinetdetect-user.ps1y figurent aussi.
Cela remplace les étapes 2 et 3, l'étape 1 reste. Le paquet contient une clé d'installation que voient tous les administrateurs Intune dans l'application. La console la liste sous le nom Intune avec la date. Elle est valable un an ; révoquez-la après le déploiement.
Alternative : construire le paquet vous-même
Avec votre propre paquet, la clé va dans le paquet (installcode.txt) au lieu de la commande d'installation.
Téléchargez le zip, vérifiez son SHA-256 et décompressez-le :
$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-srcPour une version fixe, remplacez latest par v<version>, par exemple v1.16.55.
Construisez le dossier du paquet. La clé va dans installcode.txt. Windows PowerShell 5.1 (inclus dans Windows) suffit ; PowerShell 7 est facultatif.
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
Ou créez la clé avec la Management API et construisez le paquet en une seule commande. La clé n'est jamais affichée.
$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 -InstallCodeFromStdinConstruisez les deux fichiers d'application avec le Win32 Content Prep Tool de Microsoft, absent du zip. Il écrit install.intunewin et user-setup.intunewin dans C:\pz-out.
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
.intunewin contient la clé d'installation. Traitez-le comme la clé. Révoquez la clé dans la console après le déploiement.4. Créer les applications Intune
Créez deux applications Win32 et attribuez-les dès que la stratégie Defender apparaît comme appliquée. L'application principale installe l'agent en SYSTEM. L'application par utilisateur configure les agents IA dans chaque compte utilisateur.
La clé dans la commande d'installation est visible pour les administrateurs Intune dans les paramètres de l'application. Révoquez-la dans la console après le déploiement.
Par défaut, aucun nom d'appareil n'est envoyé. Pour en envoyer un, ajoutez à la commande d'installation -DeviceNameFromHostname (le nom de l'ordinateur ; votre choix explicite, PoisonZero ne le recommande pas) ou -DeviceNamesCsv <URL https> (un CSV avec l'en-tête hostname,name ; seul le nom est envoyé).
| Application principale | Valeur |
|---|---|
| App file | install.intunewin. |
| Install command | Recommandé : install.cmd -Version latest -InstallCode "<clé>", qui installe la version la plus récente (paquets à partir de 1.16.88 ; avec un paquet plus ancien, omettez -Version). Pour fixer une version : install.cmd -Version 1.16.55 -InstallCode "<clé>", avec la version de l'étape 3. Avec votre propre paquet, sans -InstallCode : la clé vient de installcode.txt. |
| Uninstall command | uninstall.cmd. Il retire d'abord les hooks de tous les utilisateurs. |
| Install behavior | System. L'installeur a besoin des droits SYSTEM. |
| Device restart behavior | No specific action. L'installation ne demande pas de redémarrage. |
| Return codes | 0 signifie réussite. 1 signifie échec, y compris un enregistrement échoué. |
| Operating system architecture | Choisissez uniquement x64. |
| Detection rule | Script personnalisé detect.ps1. Mettez Run script as 32-bit process on 64-bit clients sur No. |
| Application par utilisateur | Valeur |
|---|---|
| App file | user-setup.intunewin. |
| Install command | powershell.exe -NoProfile -ExecutionPolicy Bypass -File user-setup.ps1. Ajoutez -StatusLine pour la ligne d'état de Claude Code. |
| Uninstall command | cmd.exe /c exit 0, car Intune en exige une. L'application principale retire les hooks. |
| Install behavior | User. Le script n'a pas besoin de droits administrateur. |
| Dependencies | L'application PoisonZero, avec Automatically install sur Yes. |
| Return codes | 0 signifie réussite. 1 signifie échec. |
| Detection rule | Script personnalisé detect-user.ps1, qui vérifie %USERPROFILE%\.claude\commands\pz.md. Mettez Run script as 32-bit process on 64-bit clients sur No. |
Configuration Manager
Utilisez le dossier du paquet dans une application avec un programme d'installation par script exécuté en SYSTEM, avec les valeurs de l'application principale. Déployez user-setup.ps1 dans le contexte utilisateur avec detect-user.ps1 et une dépendance à cette application.
Appareils privés : configuration signée
Un appareil privé ne reçoit aucun paramètre du cloud. Il lit un client-config.json signé.
- Dans la console, ouvrez le profil et choisissez Exporter pour les privés. La console affiche un script qui place le fichier.
- Créez une application avec ce script et ajoutez le code de sortie 6 comme code de réussite. 6 signifie que l'appareil vérifie le fichier plus tard.
- Attribuez l'application uniquement aux appareils privés. Sur un appareil cloud, le script se termine par 7, un échec.
Sur un seul appareil, définissez PZ_CONFIG sur le chemin du fichier avant de lancer la commande d'installation. Le fichier va dans %ProgramData%\PoisonZero\client-config.json, lisible uniquement par SYSTEM et les Administrateurs.
Mise à jour
Les appareils cloud se mettent à jour eux-mêmes. Pour le désactiver par appareil, utilisez Settings → Protection et appareils → Mises à jour dans la console. Nous n'avons pas encore testé ce réglage sur Windows. Les appareils privés ne se mettent pas à jour eux-mêmes.
Pour une mise à jour manuelle, relancez la commande d'installation. Elle garde les identifiants. Plus d'informations dans Mises à jour et cycle de vie.
À partir de cette version, le fichier du programme est poison0.exe. poisonzero.exe reste comme copie, et les exclusions de dossiers restent valables. Pour les exclusions de fichiers ou de processus, ajoutez poison0.exe et gardez poisonzero.exe, car les hooks des agents l'appellent encore.
Désinstaller
Lancez cette commande dans PowerShell en administrateur. Avec Intune, désinstallez plutôt l'application, qui lance uninstall.cmd.
& ([scriptblock]::Create((irm https://poisonzero.com/install.ps1))) -Uninstall
La désinstallation retire d'abord les hooks d'agent de tous les utilisateurs et s'arrête si cela échoue. Ensuite, elle retire la tâche planifiée, le notifier, les commandes, le programme et le répertoire de données.
Une installation Scoop se retire avec scoop uninstall poisonzero.
Cas de quarantaine ouverts
La désinstallation liste chaque cas de quarantaine ouvert avec son chemin d'origine, la copie en quarantaine (*.infection.pz) et la façon de le restaurer. Une copie reste dans %ProgramData%\PoisonZero-quarantine, lisible uniquement par SYSTEM et les administrateurs.
Mettez PZ_UNINSTALL_SKIP_QUARANTINE_COPY=1 pour ne pas conserver cette copie. Rien n'est restauré automatiquement. Vérifiez chaque fichier avant de le restaurer.
La désinstallation abandonne les modifications retenues qui attendent encore une vérification. Pour en garder une, approuvez-la d'abord : listez-les avec poison0 quarantine pending, puis lancez poison0 quarantine pending approve <id>.
Dépannage
| Symptôme | Cause | Correction |
|---|---|---|
L'installation se termine avec le code de sortie 1 et not enrolled: <reason> dans son journal. | L'enregistrement a échoué, par exemple avec device_limit, expired, revoked ou max_redemptions. Une première installation est annulée. | Corrigez la cause indiquée dans la console, par exemple avec une nouvelle clé d'installation, puis réinstallez. |
L'installation échoue avec code_unknown. | Vous avez utilisé le code d'enrollment d'une page d'appareil sans son App ID. | Passez les deux : install.cmd -AppId <app-id> -InstallCode "<code>". |
| Un appareil que vous avez révoqué ne s'enregistre pas à nouveau. | Un appareil enregistré ne reçoit pas de clé lors d'une réinstallation ou d'une mise à jour. | Ajoutez une fois -ForceEnroll à la commande d'installation. |
| La console n'affiche aucun nom d'appareil après le déploiement. | PoisonZero n'envoie aucun nom d'appareil par défaut. | Renommez l'appareil dans la console, ou ajoutez -DeviceNameFromHostname ou -DeviceNamesCsv à la commande d'installation. Cela s'applique quand un appareil s'enregistre. |
| La clé d'installation est visible dans Intune et dans les journaux des appareils. | Vous l'avez passée avec install.cmd -InstallCode. | Construisez le paquet avec -InstallCodeFromStdin. |
| Intune réinstalle l'application à chaque vérification. | $MinVersion dans detect.ps1 est supérieur à la version installée. | Gardez $MinVersion inférieur ou égal à la version installée. build-package.ps1 -Version le définit. |
| Intune signale l'application par utilisateur en échec. | L'application PoisonZero n'est pas installée sur l'appareil, donc le script se termine avec exit 1. L'application par utilisateur a besoin de la dépendance envers l'application PoisonZero. | Ajoutez la dépendance envers l'application PoisonZero. Un utilisateur sans Claude Code est détecté tout de suite, car le script prépare le profil à l'avance. |
| Defender bloque ou supprime le programme, avec l'événement 1116 ou 1117. | Defender a détecté le programme non signé dans un chemin qu'aucune exclusion ne couvre. | Vérifiez les exclusions avec les commandes sous ce tableau. Utilisez exactement les trois chemins de l'étape 1. |
Defender bloque votre commande d'exclusion comme Trojan:Win32/PowExcEnv.RXH!MTB. | Vous avez défini les exclusions avec powershell -EncodedCommand ... Add-MpPreference ..., elles ne sont donc pas définies. | Définissez-les avec Intune ou une stratégie de groupe. |
Get-MpPreference n'affiche aucun chemin d'exclusion. | Sans élévation, la commande affiche un avis. HideExclusionsFromLocalAdmins masque les chemins même aux administrateurs, mais ils s'appliquent. | Lancez-la en administrateur, ou testez un chemin avec MpCmdRun.exe -CheckExclusion. |
poison0 doctor indique que le téléchargement du modèle a échoué. | Le téléchargement en arrière-plan après la première installation n'a pas abouti. | Lancez poison0 model en administrateur pour réessayer tout de suite. poison0 doctor affiche la raison. |
poison0 doctor signale "GPU present but no Vulkan driver". | vulkan-1.dll manque dans le répertoire système, ou aucun pilote Vulkan n'est enregistré. | Installez ou mettez à jour le pilote du fabricant du GPU. D'ici là, le moteur tourne sur le CPU et inject0 reste désactivé. |
poison0 exec0 status indique que Claude Code n'appelle pas le hook exec0. | Les paramètres Claude Code viennent d'une stratégie de groupe ou d'Intune (HKLM\SOFTWARE\Policies\ClaudeCode) ou de la console d'administration de claude.ai. Claude Code ignore alors 50-poisonzero-exec0.json. | Définissez-y "managedSourcesBehavior": "merge" (Claude Code 2.1.242 ou plus récent), ou copiez-y le contenu du fichier. poison0 doctor avertit inject0 failure hook missing: Claude Code n'a pas d'entrée de hook PostToolUseFailure, donc inject0 ne vérifie pas la sortie des appels d'outils échoués. Avec des paramètres issus d'une stratégie de groupe ou d'Intune (HKLM\SOFTWARE\Policies\ClaudeCode), de managed-settings.json ou de la console d'administration de claude.ai, cette source doit contenir l'entrée. Ajoutez l'entrée PostToolUseFailure de 50-poisonzero-exec0.json à côté de PostToolUse dans cette source. Sans paramètres centralisés, lancez poison0 setup-claude --toolgate. |
poison0 status ou poison0 doctor affiche Codex comme non protégé. | Codex CLI est antérieur à 0.159. Ou les noms courts 8.3 sont désactivés sur le volume système, et Codex ne peut pas lancer le hook depuis C:\Program Files\PoisonZero, dont le chemin contient un espace. | Mettez Codex CLI à jour en 0.159 ou plus récent. Sans noms courts 8.3, exec0 ne peut pas protéger Codex sur cet appareil. Activer les noms 8.3 plus tard n'aide pas. |
| L'installation s'arrête après l'enregistrement, et la configuration signée n'est pas placée. | poison0 config verify a rejeté client-config.json. Un fichier existant reste en place. | Cherchez le code de sortie sous Référence. |
| La désinstallation s'arrête et ne retire rien. | Elle n'a pas pu retirer les hooks d'agent de tous les utilisateurs. | Mettez PZ_UNINSTALL_FORCE=1 et retirez à la main les entrées restantes. |
Lancez ces commandes dans un PowerShell avec élévation. MpCmdRun.exe se trouve dans le dossier de plateforme de Defender, %ProgramData%\Microsoft\Windows Defender\Platform\<version>.
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, MessageRéférence
Version fixée et détection
| Paramètre | Effet |
|---|---|
-Version | latest installe la version la plus récente, comme sans le paramètre. Une version comme 1.16.55 installe cette version et ne remplace jamais un programme installé plus récent ; une version jamais publiée est refusée avant le téléchargement. Avec build-package.ps1, une version définit aussi $MinVersion dans detect.ps1. |
-Sha256 <hex> | Vérifie le programme avec un hash d'une source de confiance, seulement avec -Version. SHA256SUMS vient du même serveur et ne détecte qu'un téléchargement endommagé. |
detect.ps1 signale l'application comme installée quand le programme existe, que l'appareil est enregistré, que la version vaut au moins $MinVersion et que la tâche PoisonZero existe. Les versions plus récentes comptent, car les appareils cloud se mettent à jour eux-mêmes.
Variables d'environnement
Définissez-les avant de lancer l'installeur. Avec install.ps1 exécuté comme fichier, -Version, -Sha256, -Config et -Uninstall l'emportent sur leurs variables. install.cmd d'Intune vide PZ_ENROLL_CODE, PZ_APP_ID, PZ_VERSION, PZ_SHA256 et PZ_UNINSTALL. Utilisez donc ses paramètres.
| Variable | Effet |
|---|---|
PZ_ENROLL_CODE | La clé d'installation de la console. Sur un appareil enregistré, une nouvelle clé l'enregistre à nouveau. |
PZ_APP_ID | Seulement pour un code à usage unique fourni avec un App ID. |
PZ_VERSION | Comme -Version, par exemple latest ou 1.16.55. |
PZ_SHA256 | Comme -Sha256. Utilisez-le seulement avec PZ_VERSION. |
PZ_ALLOW_DOWNGRADE | Mettez 1 pour qu'une version fixée remplace un programme installé plus récent. |
PZ_HEADLESS | Le traitement des demandes de confirmation quand aucun utilisateur de bureau ne peut répondre. none (par défaut) suit l'utilisateur connecté, standard traite toujours l'appareil comme sans bureau, strict est le plus strict. |
PZ_DEVICE_NAME | Le nom de l'appareil dans la console, enregistré en minuscules, chiffres et tirets, 63 caractères au maximum. L'installateur montre comment le nom est enregistré. Les autres options sont décrites dans l'onboarding. |
PZ_SETUP_AGENTS | Ajoute la commande locale de statistiques /poison0 aux agents indiqués, par exemple claude,codex, si quelqu'un est connecté. |
PZ_SETUP_STATUSLINE | Mettez 1 pour ajouter la ligne d'état à Claude Code. Une ligne d'état existante est conservée. |
PZ_SETUP_EXEC0 | Mettez off pour garder exec0 désactivé, aussi après les mises à jour. Les autres valeurs sont ignorées. Activez-le dans le profil de la console ou avec poison0 exec0 observe ou enforce. |
PZ_SETUP_LEAK0 | Appareils privés uniquement. Définit le mode leak0 : enforce, observe ou off. Sans la variable et sans console, leak0 reste désactivé. |
PZ_BACKEND | cpu (par défaut) ou gpu. Avec gpu, l'installeur avertit s'il ne trouve pas de pilote Vulkan. |
PZ_TIER | enterprise (par défaut) ou ultra. Avec ultra, l'installation s'arrête si la carte graphique a moins de 8 Go de mémoire vidéo ou pas de pilote Vulkan. |
PZ_NO_SHORT_ALIAS | Mettez 1 pour ne pas créer la commande courte p0. |
PZ_FETCH_ONLY | Mettez 1 pour seulement télécharger et vérifier le programme, sans service ni droits administrateur. Il va dans .\poison0.exe ou dans PZ_FETCH_DEST. |
PZ_DRY_RUN | Mettez 1 pour afficher le mode d'installation et quitter avant toute modification. |
PZ_CONFIG | Chemin d'un client-config.json signé pour un appareil privé. |
PZ_QUARANTINE_RETENTION_DAYS | Appareils privés uniquement. Nombre de jours de conservation d'un cas de quarantaine, de 1 à 3650. |
PZ_AUDIT_MAX_MB | Appareils privés uniquement. Taille en Mo à partir de laquelle le journal d'audit tourne, de 1 à 1024. |
PZ_UNINSTALL | Mettez 1 pour désinstaller via irm ... | iex, sans arguments. |
Chemins et service
| Élément | Emplacement |
|---|---|
| Le programme et ses commandes. | C:\Program Files\PoisonZero\poison0.exe, avec pz-dialog.exe. poisonzero.exe à côté est une copie pour les scripts et hooks qui l'appellent. Le dossier et son sous-dossier bin, avec p0 et pz, sont dans le PATH système. |
| Le répertoire de données. | C:\ProgramData\PoisonZero, lisible par tous les utilisateurs sauf quelques fichiers comme le fichier d'enregistrement et client-config.json. Il contient les identifiants, le moteur, les journaux et la quarantaine. |
| Le dossier par utilisateur. | %LOCALAPPDATA%\PoisonZero dans chaque profil. Il contient l'état du notifier et le journal des dialogues. |
| Le service. | La tâche planifiée PoisonZero. Elle s'exécute en SYSTEM au démarrage, redémarre jusqu'à 3 fois à 1 minute d'intervalle et est relancée toutes les 5 minutes. |
| Le notifier des demandes de confirmation. | Il démarre à la connexion dans chaque session utilisateur via la valeur de registre PoisonZeroNotifier sous Run. |
| Le journal du service. | daemon.log dans le répertoire de données, rotation à 5 Mo. C'est le seul journal du service. |
| Le journal d'installation. | L'installeur écrit sur la sortie standard. Sous Intune, elle arrive dans les journaux de l'Intune Management Extension. |
| Les hooks exec0 pour Claude Code. | C:\Program Files\ClaudeCode\managed-settings.d\50-poisonzero-exec0.json. |
GPU et Ultra
| Élément | Comportement |
|---|---|
| Moteur GPU | Sur Windows, le moteur GPU utilise Vulkan ; Ultra demande un pilote Vulkan et au moins 8 Go de mémoire vidéo ; inject0 ne tourne que sur le GPU, demande un pilote Vulkan d'Intel, AMD ou NVIDIA et, sans GPU adapté, signale inject0: off (no suitable GPU) sans repli sur le CPU. |
| Profil de la console | Il définit si un appareil utilise le GPU ou Ultra. S'il demande le GPU et qu'aucun n'est pris en charge, le moteur ne démarre pas, sans repli sur le CPU. |
| exec0 | Tourne sur le CPU et n'a pas besoin de GPU (Enterprise). |
| Bac à sable | Sur le GPU (Ultra ou inject0), le moteur tourne sans AppContainer. Voir bac à sable Windows. |
exec0 pour Claude Code
Désactivez ou activez exec0 pour Claude Code dans PowerShell en administrateur :
# turn off poison0 setup-claude --toolgate-off # turn on poison0 setup-claude --toolgate
Exclusions Defender par stratégie de groupe
- Ouvrez Computer Configuration → Administrative Templates → Windows Components → Microsoft Defender Antivirus → Exclusions → Path Exclusions. Windows 10 avant la version 2004 affiche Windows Defender Antivirus dans ce chemin.
- Choisissez Enabled, puis Show....
- Ajoutez chaque chemin comme Value name, avec la Value
0. - Lancez
gpupdate /forcesur l'appareil.
Codes de sortie de la configuration signée
poison0 config verify renvoie ces codes. L'installeur place le fichier seulement pour 0 ou 6.
| Code de sortie | Signification |
|---|---|
| 0 | Le fichier est valide. |
| 6 | La licence n'est pas encore là. Le service vérifie le fichier au démarrage. |
| 1 | Le fichier est illisible. |
| 3 | Le fichier n'est pas signé pour cet appareil. |
| 4 | Le fichier est périmé ou a expiré. |
| 5 | Le fichier est invalide ou trop récent pour cette version de l'agent. |
| 7 | L'appareil est un appareil cloud, qui ignore le fichier. |
À lire ensuite
Autres systèmes d'exploitation : vue d'ensemble de l'installation. Matériel : Configuration requise. Isolation du moteur : bac à sable Windows.