Skip to main content
A maioria dos problemas se resolve nos primeiros passos deste fluxo, sem precisar esperar resposta humana. Siga a ordem — cada passo resolve a causa mais comum antes de tentar o próximo.
1

Rode o diagnóstico

Verifica estrutura, licença, ajuda/coia, plugins e dependências da instalação. Guarde o resultado — ele acelera qualquer contato posterior com o suporte. Detalhe de cada verificação em Doctor: diagnóstico da instalação.
2

Pergunte com o problema em suas palavras

Dentro do agente, a ajuda roda o diagnóstico e responde com base na documentação real do sistema e nos erros já conhecidos — nunca “de memória”. Cobre a maior parte dos sintomas: veja também Erros comuns e Perguntas frequentes.
3

Revise os plugins do agente

Resolve o sintoma mais comum depois de instalar ou atualizar: o host do agente (Claude Code, Codex ou Cursor) continuar com comportamento antigo por não ter recarregado o registro dos plugins.
4

Confirme que está na versão mais recente

Boa parte dos comportamentos estranhos já tem correção em uma versão mais nova. Passo a passo completo em Atualizar o Zoryon COIA.
5

Proteja seus dados com backup

Antes de qualquer investigação mais profunda ou reinstalação, garanta que o hub do seu negócio está salvo no repositório privado. Veja Backup no GitHub se o backup ainda não estiver configurado.
Documento reprovado no verificador (gate) não é um problema de instalação — é o sistema segurando material abaixo do padrão antes de virar entrega final. Não é caso para o fluxo acima; veja a explicação em Erros comuns.

​
Persistiu depois do fluxo completo?

Escreva para o suporte da Zoryon usando o e-mail do recibo de compra da sua licença. Inclua, se possível:

Resultado do doctor

A saída completa de zoryon --doctor, incluindo qualquer FAIL.

O que você tentou

Quais dos passos acima já foram feitos e o que aconteceu em cada um.

Host do agente

Claude Code, Codex, Cursor, Cowork, Gemini ou Grok — e a versão, se souber.

Quando começou

Se foi logo depois de instalar, atualizar, ou durante uma produção específica.
Central pública de ajuda: zos-help.zoryon.co. Dentro do agente, /ajuda <descreva o problema> continua sendo o caminho mais rápido antes de escrever para o suporte.