zn-gate para o Claude Code

Você precisa do Node.js 18 ou mais recente, do Git e do Claude Code 2.1.295 ou mais recente. Cole cada linha em um terminal e pressione Enter depois de cada uma:

claude plugin marketplace add usezn/zn
claude plugin install zn-gate@usezn

Depois, inicie uma nova sessão do Claude Code.

Já executou zn hooks install claude-code antes? Execute primeiro zn hooks uninstall claude-code; caso contrário, os dois conjuntos de hooks rodam.

O que você recebe

• O Claude Code fica bloqueado de ler arquivos .env com valores reais e arquivos de credenciais.
• Os segredos presentes no que as ferramentas dele devolvem são trocados por marcadores ou removidos antes de o modelo vê-los.
• Um segredo colado em um prompt é bloqueado.
• O Claude pode verificar se um texto não confiável contém prompt injection.

Não coberto: sessões do Claude Code na nuvem, Cowork e conversas de chat.

Se o hook do zn não puder ser executado (por exemplo, se o node não estiver instalado), as chamadas de ferramenta rodam sem verificação e os prompts são bloqueados.

Mantenha os valores do seu .env no cofre

O agente não consegue ler arquivos .env com valores reais. Mova os valores para o cofre criptografado do zn-gate, e o arquivo mantém marcadores como __ZN_STRIPE_KEY__:

npx -y zn-gate unlock            # cria o cofre na primeira vez
npx -y zn-gate env shadow .env

Depois disso, o seu próprio app também lê os marcadores: inicie-o com o comando run do zn-gate depois de permiti-lo. O env shadow mostra como desfazer. Mais: o cofre.

Confira se funciona

Em um novo terminal, execute npx -y zn-gate check. Ele deve mostrar OK para o Claude Code. O que a saída significa.

No PowerShell do Windows, se o npm ou o npx disser "running scripts is disabled on this system", use npx.cmd no lugar de npx: veja Instalar.