Desinstalar o zn-gate

Como remover o zn-gate do seu computador, em um único passo com zn-gate uninstall ou peça por peça. Seu código não muda.

Ver .md

Você pode remover o zn-gate em um único passo ou peça por peça. Nos dois casos, execute os comandos você mesmo, no seu próprio terminal: o zn-gate se recusa a desinstalar quando um agente de IA ou um script o executa, e seu agente não tem permissão para executá-lo por você.

Nada disso altera o seu código.

Em um passo: zn-gate uninstall

npx -y zn-gate uninstall

(Se você instalou o zn-gate com npm install -g zn-gate, execute zn-gate uninstall.)

O que ele faz:

  1. Primeiro ele olha. Ele encontra o que o zn-gate configurou para o seu usuário e para a pasta em que você está: o plugin do Claude Code, os hooks do zn para cada agente e os servidores MCP que o init --wrap-mcp envolveu. Mostra a lista com os caminhos dos arquivos. Ele só encontra os hooks da pasta em que você está: se você usou --project em vários projetos, execute-o de novo na pasta de cada projeto.
  2. Ele pergunta no seu terminal. Nada é removido até você responder sim a "Remove what is listed above?".
  3. Ele remove o que listou. Nos servidores MCP envolvidos, ele restaura a cópia da configuração salva antes de envolvê-los (as alterações que você fez nesse arquivo desde então são perdidas). Os hooks e o plugin são removidos como nos passos manuais abaixo. Se um passo não puder ser feito, ele avisa e mostra o que você deve executar por conta própria: por exemplo, um servidor MCP envolvido sem cópia salva é deixado como está (remova à mão o envoltório "zn-gate shield"), e se o comando claude não for encontrado, o plugin não é removido e o comando para removê-lo é mostrado.
  4. Ele mantém o seu cofre. O cofre guarda os seus segredos. Ele só é apagado se você responder sim a uma segunda pergunta, separada, cuja resposta padrão é não. Esse segundo sim apaga os arquivos do cofre e a chave do cofre no chaveiro do seu sistema; o resto da pasta .zn (as suas configurações) permanece, então apague-a à mão se quiser. O cofre é mantido, e não apagado, se estiver desbloqueado (execute zn-gate lock e rode o uninstall de novo) ou se o computador for gerenciado por uma organização zn Team. Apagá-lo não pode ser desfeito.
  5. Ele termina com zn-gate check, para você ver que o zn-gate está desligado, e mostra o último passo: npm uninstall -g zn-gate, que remove o próprio programa.

Para ver a lista sem alterar nada, adicione --dry-run:

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

O uninstall nunca edita os seus arquivos .env. Se você moveu os valores deles para o cofre com env shadow, eles contêm marcadores como __ZN_API_KEY__. Coloque os valores reais de volta antes de apagar o cofre: veja Seus arquivos .env e o cofre.

Peça por peça

Use isto se quiser remover apenas uma parte. Cada comando é executado no seu próprio terminal.

Plugin do Claude Code

claude plugin uninstall zn-gate@usezn

Ou, dentro do Claude Code, digite /plugin, abra a aba Installed, escolha o zn-gate e clique em Uninstall. Para remover também a lista de plugins da usezn, execute claude plugin marketplace remove usezn.

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

npx -y zn-gate hooks uninstall claude-code

Use codex, cursor, opencode, antigravity, zcode, gemini ou copilot no lugar de claude-code para os outros. Adicione --project se você instalou os hooks para um único projeto; execute o comando na pasta desse projeto. Antes, é gravado um backup do arquivo de configurações. No Claude Code, ele também remove o servidor MCP secrets do próprio zn. Adicione --no-mcp para não mexer nos servidores MCP.

Servidores MCP envolvidos pelo init --wrap-mcp

npx -y zn-gate init --revert

Isso restaura cada arquivo de configurações do MCP como estava salvo logo antes de o zn envolvê-lo. As alterações que você fez depois nesses arquivos, como servidores MCP que você adicionou, são perdidas, então adicione-os de novo depois. Ele só desfaz o envolvimento do MCP: não remove o plugin nem nenhum hook. Se você só executou init sem --wrap-mcp, não há nada para restaurar.

Um servidor MCP do zn-gate que você adicionou à mão (uma entrada chamada zn-gate nas configurações MCP do seu agente) não é tocado por nenhum dos comandos daqui: apague essa entrada você mesmo.

Seus arquivos .env e o cofre

Se você executou env shadow, o seu arquivo .env contém marcadores, e os valores reais estão no cofre. Se você remover o zn-gate e apagar o cofre sem colocar os valores de volta, esses valores se perdem. Coloque-os de volta antes, com o nome da cópia criptografada que o env shadow mostrou quando você o executou:

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

O zn-gate guarda o cofre e as configurações dele em uma pasta .zn dentro da sua pasta pessoal. Remover o plugin, os hooks ou o programa deixa essa pasta lá. Para apagar o cofre, responda sim à segunda pergunta do zn-gate uninstall: ele apaga os arquivos do cofre e a chave do cofre no chaveiro do seu sistema, e o resto da pasta .zn (as suas configurações) permanece. Ele mantém o cofre se estiver desbloqueado (execute zn-gate lock e rode o uninstall de novo) ou se o computador for gerenciado por uma organização zn Team. Você também pode apagar a pasta inteira à mão depois de ter os seus valores de volta. Um cofre não pode ser recuperado depois disso.

O próprio programa

npm uninstall -g zn-gate

Se você também instalou o pacote Python, pip uninstall zn-gate o remove.

Confira se está desligado

npx -y zn-gate check

O uninstall executa isso por você no final. Se ainda aparecer algo como configurado, a linha diz qual parte sobrou e o que executar.

Relacionado