zn-gate pour Claude Code

Il vous faut Node.js 18 ou plus récent, Git et Claude Code 2.1.295 ou plus récent. Collez chaque ligne dans un terminal et appuyez sur Entrée après chacune :

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

Puis démarrez une nouvelle session Claude Code.

Vous avez déjà lancé zn hooks install claude-code ? Lancez d'abord zn hooks uninstall claude-code, sinon les deux jeux de hooks s'exécutent.

Ce que vous obtenez

• Claude Code ne peut plus lire les fichiers .env contenant de vraies valeurs ni les fichiers d'identifiants.
• Les secrets présents dans ce que renvoient ses outils sont remplacés par des marqueurs ou caviardés avant que le modèle ne les voie.
• Un secret collé dans un prompt est bloqué.
• Claude peut vérifier si un texte non fiable contient une injection de prompt.

Non couvert : les sessions Claude Code dans le cloud, Cowork et les conversations de chat.

Si le hook de zn ne peut pas s'exécuter (par exemple si node est absent), les appels d'outils s'exécutent sans contrôle et les prompts sont bloqués.

Placez les valeurs de votre .env dans le coffre chiffré

L'agent ne peut pas lire les fichiers .env contenant de vraies valeurs. Déplacez les valeurs dans le coffre chiffré de zn-gate : le fichier conserve des marqueurs comme __ZN_STRIPE_KEY__ :

npx -y zn-gate unlock            # crée le coffre la première fois
npx -y zn-gate env shadow .env

Ensuite, votre propre application lit aussi les marqueurs : lancez-la avec la commande run de zn-gate une fois que vous l'avez autorisée. env shadow indique comment annuler. Pour aller plus loin : le coffre.

Vérifiez que ça fonctionne

Dans un nouveau terminal, lancez npx -y zn-gate check. Il doit afficher OK pour Claude Code. Ce que signifie la sortie.

Sous Windows PowerShell, si npm ou npx affiche « running scripts is disabled on this system », utilisez npx.cmd à la place de npx : voir Installer.