Prise en main
FAQ
Questions fréquentes sur zn-gate, le cloud optionnel et ce qui est gratuit.
Ai-je besoin d'un compte ou d'une clé API ?
Non. Tout ce qui fonctionne sur votre machine fonctionne sans compte, sans limite d'utilisation. Une clé API n'est utilisée que pour la seconde opinion optionnelle dans le cloud, et uniquement avec ZN_CLOUD=1.
Quelque chose quitte-t-il ma machine ?
Pas par défaut. La sortie des outils, les arguments des outils et les descriptions des outils MCP ne sont jamais envoyés, quelle que soit la configuration. Les prompts ne sont envoyés que si vous définissez à la fois ZN_CLOUD=1 et ZN_API_KEY, et les secrets sont masqués localement au préalable. Voir Ce qui quitte votre machine.
Quels agents sont pris en charge ?
Tout client MCP. Le guide de démarrage rapide contient les commandes pour Claude Code, Codex CLI, Cursor et OpenCode, et zn-gate init peut réécrire les configurations de Claude Desktop, Claude Code, Cursor, Codex CLI et OpenCode. Pour les agents que vous développez vous-même, un SDK Python et Node.js est disponible.
zn-gate ralentit-il mon agent ?
En général, bien en dessous d'une milliseconde. Mesuré le 2026-10-11 (Intel Xeon 2 vCPU, Node 24, zn-gate 1.4.1) : check_tool_result, y compris le masquage des secrets, a pris 0,30 ms au p50 et 0,81 ms au p99 pour une sortie d'outil de 4 Ko, et 3,8 ms au p50 pour 64 Ko. Pour reproduire, utilisez bench/bench_by_size.js dans le dépôt.
Bloque-t-il du contenu légitime ?
Parfois. Sur des fichiers source complets, les règles locales produisent actuellement de faux positifs sur des commentaires de code ordinaires. Utilisez le mode shadow (init --shadow ou shield --shadow) pour journaliser les détections sans bloquer pendant l'évaluation, et utilisez check_tool_result pour le contenu web et tiers plutôt que pour les fichiers de votre propre dépôt.
Voit-il les outils intégrés de mon agent ?
Oui, avec zn-gate 1.5 et versions ultérieures : le plugin zn-gate dans Claude Code (voir le Démarrage rapide), et zn hooks install codex, cursor ou opencode (npm) pour les autres agents. Il masque la sortie des outils intégrés de l'agent avant que le modèle ne la voie dans Claude Code et OpenCode ; Codex remplace le résultat par une copie masquée ; Cursor peut uniquement bloquer la lecture de fichiers secrets et ne permet pas aux hooks de réécrire la sortie des commandes shell ou des fichiers. Voir le Scrubber. Sans les hooks, une lecture de fichier native ou une commande shell ne passe pas par zn-gate, sauf si vous envoyez sa sortie à check_tool_result.
Existe-t-il des taux de détection ?
Pas encore pour zn-gate. Le auto-test (51 vecteurs) est un test de fumée, et non un taux de détection ou de faux positifs. Nous publierons des résultats sur un jeu de test tenu à l'écart, avec méthode et données, avant de citer un chiffre. Le modèle cloud, Galvanize 2, dispose de résultats sur jeu de test tenu à l'écart, avec méthode, dans son article de lancement. La page de documentation Galvanize présente ces résultats et, pour le modèle précédent, Galvanize-60M, son benchmark interne daté avec son jeu de données public.
Pour quoi facturez-vous ?
Uniquement pour ce qui ne peut pas tourner sur votre machine : Galvanize 2, un modèle ouvert, dans la vérification cloud optionnelle et, pour les équipes, les contrôles centralisés. zn-gate lui-même est sous licence MIT. Voir tarifs.
Comment le supprimer ?
npx -y zn-gate init --revert restaure vos configurations à partir de la sauvegarde. Pour un serveur autonome, supprimez l'entrée zn-gate de la configuration de votre agent.
Comment signaler une vulnérabilité ?
Écrivez à security@usezn.com. Politique, périmètre et safe harbor : sécurité.