zn-gate para Claude Code

Necesitas Node.js 18 o posterior, Git y Claude Code 2.1.295 o posterior. Pega cada línea en una terminal y pulsa Intro después de cada una:

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

Después, abre una sesión nueva de Claude Code.

¿Ya ejecutaste zn hooks install claude-code antes? Ejecuta primero zn hooks uninstall claude-code; si no, se ejecutan los dos juegos de hooks.

Qué obtienes

• Claude Code no puede leer archivos .env con valores reales ni archivos de credenciales.
• Los secretos que devuelven sus herramientas se sustituyen por marcadores o se ocultan antes de que los vea el modelo.
• Un secreto pegado en un prompt se bloquea.
• Claude puede revisar si un texto no fiable contiene inyección de prompt.

No cubre: las sesiones de Claude Code en la nube, Cowork ni el chat.

Si el hook de zn no puede ejecutarse (por ejemplo, si falta node), las llamadas a herramientas se ejecutan sin comprobar y los prompts se bloquean.

Guarda los valores de tu .env en el almacén

El agente no puede leer archivos .env con valores reales. Mueve los valores al almacén cifrado de zn-gate: el archivo conserva marcadores como __ZN_STRIPE_KEY__:

npx -y zn-gate unlock            # crea el almacén la primera vez
npx -y zn-gate env shadow .env

Después, tu propia app también lee los marcadores: arráncala con el comando run de zn-gate una vez que lo hayas permitido. env shadow te dice cómo deshacerlo. Más información: el almacén.

Comprueba que funciona

En una terminal nueva, ejecuta npx -y zn-gate check. Debe mostrar OK para Claude Code. Qué significa la salida.

En PowerShell de Windows, si npm o npx dice «running scripts is disabled on this system», usa npx.cmd en lugar de npx: mira Instalación.