O que você vê
A CLI imprime um erro como mokxi: <mensagem> (<código>, <request id>). A API devolve a mesma mensagem e o mesmo código na resposta JSON. O código entre colchetes é o título abaixo. Envie o request id quando escrever para nós.
How each tool works is in a API do Mokxi, the command line tool and CI; a extensão do VS Code está em GitHub e VS Code.
Minutos de simulação (quota_exceeded)
"Você usou todos os N minutos de simulação que seu plano inclui neste mês." O tempo simulado pela API conta para um total mensal: 100 minutos no Grátis, 2.000 no Pro, Estudante, Professor e Sala de aula, e 5.000 no Ultra (fora de venda; contas que o têm o mantêm). No Professor e no Sala de aula o professor e a turma compartilham um único conjunto, então a mensagem pode dizer "sua turma". A contagem recomeça no primeiro dia do mês (UTC), que a mensagem indica. Uma execução iniciada dentro do limite sempre termina, e nada é cobrado por passar dele. Circuitos rodados no editor nunca contam.
Muitas requisições (rate_limited)
- "Seu plano permite N requisições por minuto por token" ou "N simulações por hora por token". 60 requisições por minuto e 30 simulações por hora no Grátis, 600 de cada nos planos pagos. Espere os segundos indicados pelo cabeçalho
Retry-After. - "Muitas requisições sem token; envie um para o limite do seu plano."
- "A duração é X ms; seu plano roda no máximo N ms de tempo simulado por requisição." 10 segundos de tempo simulado por execução no Grátis, 60 nos planos pagos. Divida uma execução longa em execuções mais curtas.
Tokens (unauthorized, insufficient_scope, token_limit)
- "Send your token as "Authorization: Bearer mkx_..."", "that token is
not valid", "was revoked" or "has expired". Make a new token on
API tokens in Configurações, ou entre de novo com
mokxi login. - "Este token não tem o escopo ..." Crie um token com esse escopo marcado:
simulatepara execuções,projects:readeprojects:writepara projetos. - "Seu plano mantém N tokens de API ao mesmo tempo; revogue um primeiro." 5 no Grátis, 25 nos planos pagos.
- "Esse código é desconhecido ou expirou; comece de novo" (
mokxi login). Rode o login de novo e aprove o novo código em alguns minutos.
Plano necessário (license_required)
- "O Mokxi para VS Code faz parte do Pro." Comece o teste grátis de 7 dias do Pro, ou escolha Pro em /pricing.
- "O Mokxi CI é grátis para repositórios públicos." Execuções do GitHub Action, ou da CLI dentro de um job de CI, em um repositório privado precisam de um token de CI de uma conta Pro (defina-o como
MOKXI_TOKEN, ou como a entradatokenda Action). CI para repositórios privados vem com o Pro, o preço de estudante, Lifetime, Sala de aula e o teste, e com o Ultra para contas que ainda o têm. Rodar um sketch no seu próprio computador commokxi runcontinua grátis, sem conta. - "... You can keep using it until then." (December 11, 2026) A notice, not an error: accounts that used VS Code or CI before the change keep it until that date.
Ainda travado
Escreva para nós a partir de /support com as palavras exatas e o id da requisição.