Primeiros passos

FAQ

Perguntas frequentes sobre o zn-gate, a nuvem opcional e o que é gratuito.

Ver .md

Preciso de uma conta ou de uma chave de API?

Não. Tudo que roda na sua máquina funciona sem uma, sem limites de uso. Uma chave de API só é usada na segunda opinião opcional na nuvem, e somente junto com ZN_CLOUD=1.

Algo sai da minha máquina?

Não por padrão. A saída das ferramentas, os argumentos das ferramentas e as descrições das ferramentas MCP nunca são enviados, em nenhuma configuração. Os prompts só são enviados se você definir tanto ZN_CLOUD=1 quanto ZN_API_KEY, e os segredos são ocultados localmente antes disso. Veja O que sai da sua máquina.

Quais agentes são suportados?

Qualquer cliente MCP. O guia de início rápido tem comandos para Claude Code, Codex CLI, Cursor e OpenCode, e o zn-gate init pode reescrever as configurações do Claude Desktop, Claude Code, Cursor, Codex CLI e OpenCode. Para agentes que você mesmo desenvolve, há um SDK para Python e Node.js.

O zn-gate deixa meu agente mais lento?

Normalmente, bem abaixo de um milissegundo. Medido em 11/10/2026 (Intel Xeon com 2 vCPUs, Node 24, zn-gate 1.4.1): check_tool_result, incluindo a ocultação de segredos, levou 0,30 ms no p50 e 0,81 ms no p99 para uma saída de ferramenta de 4 KB, e 3,8 ms no p50 para 64 KB. Para reproduzir, use bench/bench_by_size.js no repositório.

Ele bloqueia conteúdo legítimo?

Às vezes. Em arquivos de código-fonte completos, as regras locais atualmente geram falsos positivos em comentários comuns de código. Use o modo sombra (init --shadow ou shield --shadow) para registrar as detecções sem bloquear enquanto você avalia, e use check_tool_result para conteúdo da web e de terceiros, em vez dos arquivos do seu próprio repositório.

Ele enxerga as ferramentas nativas do meu agente?

Sim, com o zn-gate 1.5 e versões posteriores: o plugin zn-gate no Claude Code (veja o Início rápido), e zn hooks install codex, cursor ou opencode (npm) nos outros agentes. Ele oculta segredos da saída das ferramentas nativas do agente antes que o modelo a veja no Claude Code e no OpenCode; o Codex substitui o resultado por uma cópia oculta; o Cursor só consegue bloquear leituras de arquivos de segredos e não permite que os hooks reescrevam a saída de shell ou de arquivos. Veja o Scrubber. Sem os hooks, uma leitura nativa de arquivo ou um comando de shell não passa pelo zn-gate, a menos que você envie a saída para check_tool_result.

Existem taxas de detecção?

Ainda não para o zn-gate. O autoteste (51 vetores) é um teste de fumaça, não uma taxa de detecção ou de falsos positivos. Vamos publicar resultados em um conjunto de testes separado, com método e dados, antes de citar um número. O modelo na nuvem, Galvanize 2, tem resultados em conjunto de testes separado, com método, em seu post de lançamento. A página de documentação do Galvanize traz esses resultados e, para o modelo anterior, Galvanize-60M, seu benchmark datado de origem própria com o conjunto de dados público.

Pelo que vocês cobram?

Apenas pelo que não pode rodar na sua máquina: Galvanize 2, um modelo aberto, na verificação opcional na nuvem e, para equipes, controles centralizados. O zn-gate em si é MIT. Veja preços.

Como removo?

npx -y zn-gate init --revert restaura suas configurações a partir do backup. Para um servidor independente, remova a entrada zn-gate da configuração do seu agente.

Como reporto uma vulnerabilidade?

Envie um e-mail para security@usezn.com. Política, escopo e safe harbor: segurança.