Désinstaller zn-gate

Comment retirer zn-gate de votre ordinateur, en une seule étape avec zn-gate uninstall ou pièce par pièce. Votre code n'est pas modifié.

Voir le .md

Vous pouvez retirer zn-gate en une seule étape ou pièce par pièce. Dans les deux cas, lancez les commandes vous-même, dans votre propre terminal : zn-gate refuse de se désinstaller lorsqu'un agent d'IA ou un script le lance, et votre agent n'a pas le droit de le lancer à votre place.

Rien de tout cela ne modifie votre code.

En une étape : zn-gate uninstall

npx -y zn-gate uninstall

(Si vous avez installé zn-gate avec npm install -g zn-gate, lancez zn-gate uninstall.)

Ce qu'il fait :

  1. Il regarde d'abord. Il repère ce que zn-gate a mis en place pour votre utilisateur et pour le dossier où vous vous trouvez : le plugin Claude Code, les hooks de zn pour chaque agent et les serveurs MCP que init --wrap-mcp a enveloppés. Il affiche la liste avec les chemins des fichiers. Il ne trouve que les hooks du dossier où vous vous trouvez : si vous avez utilisé --project dans plusieurs projets, relancez-le depuis le dossier de chaque projet.
  2. Il demande dans votre terminal. Rien n'est retiré tant que vous ne répondez pas oui à « Remove what is listed above? ».
  3. Il retire ce qu'il a listé. Pour les serveurs MCP enveloppés, il remet la copie de la configuration enregistrée avant l'enveloppement (les modifications que vous avez faites depuis dans ce fichier sont perdues). Les hooks et le plugin sont retirés comme dans les étapes manuelles ci-dessous. Si une étape ne peut pas être faite, il le dit et affiche ce que vous devez lancer vous-même : par exemple, un serveur MCP enveloppé sans copie enregistrée est laissé tel quel (retirez à la main l'enveloppe « zn-gate shield »), et si la commande claude est introuvable, le plugin n'est pas retiré et la commande pour le retirer est affichée.
  4. Il garde votre coffre. Le coffre contient vos secrets. Il n'est supprimé que si vous répondez oui à une seconde question, distincte, dont la réponse par défaut est non. Ce second oui supprime les fichiers du coffre et la clé du coffre dans le trousseau de votre système ; le reste du dossier .zn (vos réglages) reste en place, supprimez-le à la main si vous le souhaitez. Le coffre est conservé, et non supprimé, s'il est déverrouillé (lancez zn-gate lock, puis relancez uninstall) ou si l'ordinateur est géré par une organisation zn Team. Une suppression est irréversible.
  5. Il se termine par zn-gate check, pour que vous voyiez que zn-gate est désactivé, et affiche la dernière étape : npm uninstall -g zn-gate, qui retire le programme lui-même.

Pour voir la liste sans rien modifier, ajoutez --dry-run :

npx -y zn-gate uninstall --dry-run

uninstall ne modifie jamais vos fichiers .env. Si vous avez déplacé leurs valeurs dans le coffre avec env shadow, ils contiennent des marqueurs comme __ZN_API_KEY__. Remettez les vraies valeurs avant de supprimer le coffre : voir Vos fichiers .env et le coffre.

Pièce par pièce

À utiliser si vous ne voulez retirer qu'une partie. Chaque commande se lance dans votre propre terminal.

Plugin Claude Code

claude plugin uninstall zn-gate@usezn

Ou, dans Claude Code, tapez /plugin, ouvrez l'onglet Installed, choisissez zn-gate puis Uninstall. Pour retirer aussi la liste de plugins usezn, lancez claude plugin marketplace remove usezn.

Hooks (Codex CLI, Cursor, OpenCode, Antigravity, ZCode desktop app, Gemini CLI, Copilot CLI ou Claude Code sans le plugin)

npx -y zn-gate hooks uninstall claude-code

Utilisez codex, cursor, opencode, antigravity, zcode, gemini ou copilot à la place de claude-code pour les autres. Ajoutez --project si vous avez installé les hooks pour un seul projet ; lancez la commande depuis le dossier de ce projet. Une sauvegarde du fichier de réglages est écrite avant. Pour Claude Code, il retire aussi le serveur MCP secrets propre à zn. Ajoutez --no-mcp pour ne pas toucher aux serveurs MCP.

Serveurs MCP enveloppés par init --wrap-mcp

npx -y zn-gate init --revert

Cela remet chaque fichier de réglages MCP tel qu'il avait été enregistré juste avant que zn ne l'enveloppe. Les modifications faites plus tard dans ces fichiers, comme des serveurs MCP ajoutés par vous, sont perdues : ajoutez-les de nouveau ensuite. La commande n'annule que l'enveloppement MCP : elle ne retire ni le plugin ni aucun hook. Si vous n'avez lancé que init sans --wrap-mcp, il n'y a rien à restaurer.

Un serveur MCP zn-gate que vous avez ajouté à la main (une entrée nommée zn-gate dans les réglages MCP de votre agent) n'est touché par aucune des commandes ici : supprimez cette entrée vous-même.

Vos fichiers .env et le coffre

Si vous avez lancé env shadow, votre fichier .env contient des marqueurs et les vraies valeurs sont dans le coffre. Si vous retirez zn-gate et supprimez le coffre sans remettre les valeurs, elles sont perdues. Remettez-les d'abord, avec le nom de la copie chiffrée affiché par env shadow lorsque vous l'avez lancé :

npx -y zn-gate env unshadow .env --backup <name>

zn-gate conserve le coffre et ses réglages dans un dossier .zn de votre dossier personnel. Retirer le plugin, les hooks ou le programme le laisse en place. Pour supprimer le coffre, répondez oui à la seconde question de zn-gate uninstall : cela supprime les fichiers du coffre et la clé du coffre dans le trousseau de votre système, et le reste du dossier .zn (vos réglages) reste en place. Le coffre est conservé s'il est déverrouillé (lancez zn-gate lock, puis relancez uninstall) ou si l'ordinateur est géré par une organisation zn Team. Vous pouvez aussi supprimer tout le dossier à la main une fois vos valeurs récupérées. Un coffre ne peut plus être récupéré ensuite.

Le programme lui-même

npm uninstall -g zn-gate

Si vous avez aussi installé le paquet Python, pip uninstall zn-gate le retire.

Vérifier que c'est désactivé

npx -y zn-gate check

uninstall le lance pour vous à la fin. S'il signale encore quelque chose comme en place, la ligne indique quelle partie reste et quoi lancer.

À lire aussi