Glosario

Significado breve de las palabras que se usan en la documentación de zn-gate. Cuando una página explica una palabra con más detalle, la palabra enlaza a ella. ¿No sabes por dónde empezar? Empieza por Instalar.

Tu configuración

• Agente de código: un programa como Claude Code, Codex CLI, Cursor u OpenCode que lee tus archivos y ejecuta comandos por ti. Consulta Instalar.
• Terminal: la ventana donde escribes comandos. Ejecuta los comandos de instalación de zn-gate en tu propia terminal, no a través de un agente.
• Node.js: el programa que ejecuta los comandos npm de zn-gate. npx viene incluido. Puedes descargarlo en nodejs.org.
• Servidor MCP: una herramienta que tu agente puede llamar. MCP es el estándar con el que los agentes se conectan a herramientas. zn-gate también puede funcionar como uno. Consulta Clientes y herramientas MCP.
• Plugin: el complemento de zn-gate para Claude Code. Configura los hooks de zn-gate y sus servidores MCP en un solo paso. Consulta Claude Code.
• Llavero (keychain): el almacén de contraseñas de tu sistema operativo. zn-gate puede guardar ahí una clave de API opcional. Consulta Connect.

Secretos

• Secreto: un valor que da acceso a algo, como una clave de API, un token o una contraseña.
• Archivo .env: un archivo de un proyecto que guarda secretos y otros ajustes de tu aplicación.
• Almacén cifrado (vault): un almacén cifrado en tu máquina donde zn-gate guarda los valores reales de tus secretos. Consulta Scrubber y almacén de secretos.
• Marcador: un sustituto de un secreto, como __ZN_STRIPE_KEY__. Tu agente ve el marcador. El valor real se queda en el almacén. Consulta Scrubber y almacén de secretos.
• Ocultar (redact): sustituir un secreto en un texto por un marcador o una etiqueta, para que nadie que lea el texto vea el valor. Consulta Ocultación de secretos.
• Shadow (env shadow): mover los valores secretos de un archivo .env al almacén y dejar marcadores en su lugar. Consulta Scrubber y almacén de secretos.
• Scrubber: la parte de zn-gate que sustituye los secretos por marcadores en lo que tu agente lee, ejecuta y envía. Los valores se quedan en el almacén. Consulta Scrubber y almacén de secretos.

Comprobaciones y protección

• Hook: una pequeña comprobación que tu agente ejecuta antes o después de leer un archivo, ejecutar un comando o recibir tu prompt. zn-gate usa hooks para bloquear o para ocultar. Consulta Cómo funciona zn-gate.
• Proxy (shield): una capa que se sitúa entre tu agente y un servidor MCP y comprueba lo que pasa por ella. Consulta Proteger servidores MCP.
• Modo shadow (--shadow): una forma de desplegar zn-gate en la que las decisiones se registran, pero no se bloquea ni se cambia nada. No es lo mismo que env shadow, descrito arriba. Consulta Cómo funciona zn-gate.
• Inyección de prompt: texto que intenta que un agente ignore tus instrucciones, por ejemplo escondido dentro de un archivo o de una página web. Consulta Modelo de amenazas.
• Clasificador: un modelo que reparte los textos en grupos, como seguro o intento de inyección.
• Galvanize: las comprobaciones de inyección de prompt de zn. Se ejecutan en local como reglas, y el clasificador abierto Galvanize 2 está disponible como segunda opinión opcional. Consulta Galvanize 2.
• Comprobación en la nube: una segunda comprobación opcional, con el clasificador Galvanize 2 de usezn.com, del texto que se envía a la herramienta analyze_prompt de zn-gate. Está desactivada hasta que la actives. Consulta Qué sale de tu máquina.

Comandos y registros

• Autoprueba (zn-gate test): ejecuta los ejemplos incluidos en zn-gate.
• Reach (zn-gate reach): un informe de solo lectura de a qué pueden acceder tus agentes de código en esta máquina. Muestra nombres, nunca valores. Consulta Reach.
• Audit (zn-gate audit): lee los archivos de configuración de agentes de un repositorio, sin ejecutar nada, e informa de lo que se ejecutaría. Consulta Audit.
• Scan (zn-gate scan): revisa los prompts, el Markdown, las skills y los archivos de configuración de una carpeta en busca de secretos filtrados y de trampas de inyección de prompt. Consulta Scan.
• Evidence (el registro de auditoría local): un registro de cada decisión de shield en tu máquina. Cada entrada está encadenada a la anterior, así que se pueden detectar cambios. Consulta Registro de auditoría local.