Primeros pasos
Preguntas frecuentes
Preguntas habituales sobre zn-gate, la nube opcional y qué es gratuito.
¿Necesito una cuenta o una clave de API?
No. Todo lo que se ejecuta en tu máquina funciona sin ninguna de las dos cosas y sin límites de uso. Una clave de API solo se utiliza para la segunda opinión opcional en la nube, y únicamente junto con ZN_CLOUD=1.
¿Sale algo de mi máquina?
No por defecto. La salida de las herramientas, los argumentos de las herramientas y las descripciones de las herramientas MCP nunca se envían, en ninguna configuración. Los prompts solo se envían si estableces tanto ZN_CLOUD=1 como ZN_API_KEY, y los secretos se ocultan localmente antes. Consulta Qué sale de tu máquina.
¿Qué agentes son compatibles?
Cualquier cliente MCP. La guía de inicio rápido incluye comandos para Claude Code, Codex CLI, Cursor y OpenCode, y zn-gate init puede reescribir las configuraciones de Claude Desktop, Claude Code, Cursor, Codex CLI y OpenCode. Para los agentes que construyas tú mismo, existe un SDK de Python y Node.js.
¿Ralentiza zn-gate a mi agente?
Normalmente en menos de un milisegundo. Medido el 2026-10-11 (Intel Xeon de 2 vCPU, Node 24, zn-gate 1.4.1): check_tool_result, incluida la ocultación de secretos, tardó 0.30 ms p50 y 0.81 ms p99 para una salida de herramienta de 4 KB, y 3.8 ms p50 para 64 KB. Para reproducirlo, usa bench/bench_by_size.js en el repositorio.
¿Bloqueará contenido legítimo?
A veces. En archivos de código fuente completos, las reglas locales actualmente generan falsos positivos en comentarios de código corrientes. Usa el modo sombra (init --shadow o shield --shadow) para registrar las detecciones sin bloquear mientras lo evalúas, y usa check_tool_result para contenido web y de terceros en lugar de los archivos de tu propio repositorio.
¿Ve las herramientas integradas de mi agente?
Sí, con zn-gate 1.5 o posterior: el plugin de zn-gate en Claude Code (consulta el Inicio rápido), y zn hooks install codex, cursor u opencode (npm) en los demás agentes. En Claude Code y OpenCode oculta la salida de las herramientas integradas del agente antes de que el modelo la vea; Codex sustituye el resultado por una copia oculta; Cursor solo puede bloquear lecturas de archivos secretos y no permite que los hooks reescriban la salida de shell o de archivos. Consulta el Scrubber. Sin los hooks, una lectura de archivo o un comando de shell nativos no pasan por zn-gate a menos que envíes su salida a check_tool_result.
¿Hay tasas de detección?
Todavía no para zn-gate. La autoprueba (51 vectores) es una prueba de humo, no una tasa de detección ni de falsos positivos. Publicaremos resultados sobre un conjunto de prueba reservado, con método y datos, antes de citar cualquier cifra. El modelo en la nube, Galvanize 2, tiene resultados sobre conjunto reservado con método en su entrada de lanzamiento. La página de documentación de Galvanize recoge esos resultados y, para el modelo anterior, Galvanize-60M, su referencia propia fechada con su conjunto de datos público.
¿Qué cobráis?
Solo aquello que no puede ejecutarse en tu máquina: Galvanize 2, un modelo abierto, en la comprobación opcional en la nube y, para equipos, los controles centralizados. zn-gate en sí es MIT. Consulta los precios.
¿Cómo lo elimino?
npx -y zn-gate init --revert restaura tus configuraciones desde la copia de seguridad. Para un servidor independiente, elimina la entrada zn-gate de la configuración de tu agente.
¿Cómo informo de una vulnerabilidad?
Envía un correo a security@usezn.com. Política, alcance y puerto seguro: seguridad.