Desinstalar zn-gate

Cómo quitar zn-gate de tu ordenador, en un solo paso con zn-gate uninstall o pieza por pieza. Tu código no cambia.

Ver .md

Puedes quitar zn-gate en un solo paso o pieza por pieza. En ambos casos, ejecuta los comandos tú mismo, en tu propia terminal: zn-gate se niega a desinstalarse cuando lo ejecuta un agente de IA o un script, y tu agente no tiene permiso para ejecutarlo por ti.

Nada de esto cambia tu código.

En un solo paso: zn-gate uninstall

npx -y zn-gate uninstall

(Si instalaste zn-gate con npm install -g zn-gate, ejecuta zn-gate uninstall.)

Qué hace:

  1. Primero mira. Busca lo que zn-gate configuró para tu usuario y para la carpeta en la que estás: el plugin de Claude Code, los hooks de zn para cada agente y los servidores MCP que init --wrap-mcp envolvió. Muestra la lista con las rutas de los archivos. Solo encuentra los hooks de la carpeta en la que estás: si usaste --project en varios proyectos, ejecútalo de nuevo desde la carpeta de cada proyecto.
  2. Pregunta en tu terminal. No se quita nada hasta que respondas que sí a "Remove what is listed above?".
  3. Quita lo que listó. En los servidores MCP envueltos, restaura la copia de la configuración guardada antes de envolverlos (los cambios que hayas hecho en ese archivo desde entonces se pierden). Los hooks y el plugin se quitan igual que en los pasos manuales de abajo. Si un paso no se puede hacer, lo dice e imprime lo que debes ejecutar tú: por ejemplo, un servidor MCP envuelto sin copia guardada se deja como está (quita a mano el envoltorio "zn-gate shield"), y si no se encuentra el comando claude, el plugin no se quita y se imprime el comando para quitarlo.
  4. Conserva tu bóveda. La bóveda guarda tus secretos. Solo se borra si respondes que sí a una segunda pregunta, aparte, y la respuesta por defecto es no. Ese segundo sí borra los archivos de la bóveda y la clave de la bóveda en el llavero de tu sistema; el resto de la carpeta .zn (tus ajustes) se queda, así que bórrala a mano si quieres. La bóveda se conserva, sin borrarse, si está desbloqueada (ejecuta zn-gate lock y vuelve a ejecutar uninstall) o si el ordenador lo gestiona una organización zn Team. Borrarla no se puede deshacer.
  5. Termina con zn-gate check, para que veas que zn-gate está apagado, y muestra el último paso: npm uninstall -g zn-gate, que elimina el programa en sí.

Para ver la lista sin cambiar nada, añade --dry-run:

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

uninstall nunca modifica tus archivos .env. Si pasaste sus valores a la bóveda con env shadow, contienen marcadores como __ZN_API_KEY__. Vuelve a poner los valores reales antes de borrar la bóveda: consulta Tus archivos .env y la bóveda.

Pieza por pieza

Úsalo si solo quieres quitar una parte. Cada comando se ejecuta en tu propia terminal.

Plugin de Claude Code

claude plugin uninstall zn-gate@usezn

O, dentro de Claude Code, escribe /plugin, abre la pestaña Installed, elige zn-gate y pulsa Uninstall. Para quitar también la lista de plugins de usezn, ejecuta claude plugin marketplace remove usezn.

Hooks (Codex CLI, Cursor, OpenCode, Antigravity, ZCode desktop app, Gemini CLI, Copilot CLI o Claude Code sin el plugin)

npx -y zn-gate hooks uninstall claude-code

Usa codex, cursor, opencode, antigravity, zcode, gemini o copilot en lugar de claude-code para los demás. Añade --project si instalaste los hooks solo para un proyecto; ejecútalo desde la carpeta de ese proyecto. Antes se guarda una copia de seguridad del archivo de ajustes. En Claude Code también quita el servidor MCP secrets propio de zn. Añade --no-mcp para no tocar los servidores MCP.

Servidores MCP envueltos por init --wrap-mcp

npx -y zn-gate init --revert

Esto restaura cada archivo de ajustes de MCP tal como se guardó justo antes de que zn lo envolviera. Los cambios que hayas hecho después en esos archivos, como servidores MCP que hayas añadido, se pierden, así que vuelve a añadirlos después. Solo deshace el envoltorio de MCP: no quita el plugin ni ningún hook. Si solo ejecutaste init sin --wrap-mcp, no hay nada que restaurar.

Un servidor MCP de zn-gate que añadiste a mano (una entrada llamada zn-gate en los ajustes MCP de tu agente) no lo toca ninguno de los comandos de aquí: borra esa entrada tú mismo.

Tus archivos .env y la bóveda

Si ejecutaste env shadow, tu archivo .env contiene marcadores y los valores reales están en la bóveda. Si quitas zn-gate y borras la bóveda sin volver a poner los valores, esos valores se pierden. Vuelve a ponerlos antes, con el nombre de la copia cifrada que env shadow mostró cuando lo ejecutaste:

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

zn-gate guarda la bóveda y sus ajustes en una carpeta .zn dentro de tu carpeta personal. Quitar el plugin, los hooks o el programa la deja ahí. Para borrar la bóveda, responde que sí a la segunda pregunta de zn-gate uninstall: borra los archivos de la bóveda y la clave de la bóveda en el llavero de tu sistema, y el resto de la carpeta .zn (tus ajustes) se queda. Conserva la bóveda si está desbloqueada (ejecuta zn-gate lock y vuelve a ejecutar uninstall) o si el ordenador lo gestiona una organización zn Team. También puedes borrar la carpeta entera a mano cuando ya tengas tus valores de vuelta. Una bóveda no se puede recuperar después.

El programa en sí

npm uninstall -g zn-gate

Si también instalaste el paquete de Python, pip uninstall zn-gate lo elimina.

Comprueba que está apagado

npx -y zn-gate check

uninstall lo ejecuta por ti al final. Si todavía indica que algo sigue configurado, la línea dice qué parte queda y qué ejecutar.

Relacionado