Limite do ZCode atingido? Como verificar cotas e cartões de redefinição
Guia prático para separar o App Usage local das cotas remotas do GLM Coding Plan, descobrir qual contador bloqueou o trabalho, conferir a conexão da conta, usar um cartão antes do vencimento e escolher uma forma segura de continuar.
Conteúdo
Quando o ZCode informar que um limite foi atingido, não conclua nada pelo gráfico local de tokens. Abra Usage Statistics → Coding Plan, confira os contadores de 5 horas e semanal e identifique qual deles realmente acabou. Se houver Reset, abra o painel, confirme a cota aplicável e o vencimento do cartão. Se não houver cartão, verifique se o ZCode está conectado à conta correta da Z.ai ou BigModel e ao Coding Plan dessa conta. Depois, espere a renovação, use um cartão elegível ou mude conscientemente para outro provedor com cota e cobrança separadas.
A distinção essencial é: App Usage é histórico local, Coding Plan é cota remota de assinatura e uma API Key geral tem acesso e faturamento próprios. Um medidor não recarrega nem comprova automaticamente o estado do outro.
Este guia foi conferido nas documentações oficiais do ZCode e da Z.ai em 3 de outubro de 2026. Regras e elegibilidade podem mudar; os contadores e botões exibidos na sua conta são a referência final.
Decisão em 60 segundos
- Abra Usage Statistics e escolha Coding Plan, não App Usage.
- Confira as cotas de 5 horas, semanal e, se a tarefa usou ferramentas, MCP.
- Confirme o Coding Plan correto da Z.ai ou BigModel e a conta pessoal ou de equipe esperada.
- Se houver Reset, leia o tipo de cota e o vencimento antes de usar.
- Sem cartão, aguarde o horário mostrado no contador esgotado ou escolha deliberadamente outro provedor configurado.
- Antes de voltar a uma tarefa longa, envie uma instrução curta de teste.
Isso evita confundir estatística local com saldo da assinatura ou tratar um saldo de API separado como continuação do plano.
Leia o medidor correto
A documentação oficial de Usage Stats separa duas visualizações com finalidades diferentes.
| Visualização ou cota | O que mostra | O que não prova |
|---|---|---|
| App Usage | Sessões locais no dispositivo atual, incluindo tokens, mensagens, dias ativos e distribuição de modelos | Se a cota remota do GLM Coding Plan acabou |
| Coding Plan: 5-hour | Saldo da janela curta ativa | Se a cota semanal ainda está disponível |
| Coding Plan: weekly | Saldo do ciclo semanal | Se a janela de 5 horas já voltou |
| MCP quota | Chamadas restantes de ferramentas cobertas | Se a geração normal do modelo também acabou |
| Provedor separado por API Key | Disponibilidade e saldo daquele provedor | Uma recarga do Coding Plan da Z.ai ou BigModel |
Um número alto em App Usage mostra apenas atividade local. Um número baixo também não garante cota remota, pois o plano pode ter sido usado em outro dispositivo, ferramenta compatível ou conexão de equipe.
Descubra qual cota está bloqueando
O Coding Plan aplica mais de um limite. Confira todos os contadores visíveis.
A cota de 5 horas está zerada, mas a semanal não
A janela curta é o bloqueio imediato. Use um cartão de 5 horas se o ZCode exibir um; caso contrário, espere a renovação indicada na conta. A documentação atual do plano individual descreve esses créditos como atualizados dinamicamente após o consumo, mas o horário exato deve vir da interface.
A cota semanal está zerada
Um contador de 5 horas positivo não contorna um limite semanal esgotado. Procure um cartão semanal; se ele não existir, espere o próximo ciclo mostrado na conta. Os planos atuais descrevem um ciclo de sete dias, enquanto versões antigas ou planos de equipe podem mostrar regras próprias.
Só a cota MCP acabou
MCP é um fundo separado de ferramentas. Uma tarefa que precise de busca, leitura de páginas ou outra ferramenta coberta pode falhar com cota de modelo disponível. Teste uma solicitação pequena sem essa ferramenta. Isso não cria cota; apenas verifica se o caminho do modelo ainda funciona.
O painel Coding Plan sumiu ou não carrega
Investigue primeiro a conexão. Confirme conta, provedor, plano selecionado e acesso de rede antes de esperar por uma renovação que talvez não se aplique à conexão ativa.
Verifique a conta e o plano conectados
Abra o seletor de modelos, escolha Manage Models e vá para Settings → Model Settings. O guia oficial Connect Models & Plans afirma que uma conta Z.ai autorizada com GLM Coding Plan ativo usa diretamente o plano e a cota dessa conta.
Verifique nesta ordem:
- Provedor: Z.ai ou BigModel está habilitado.
- Conta: é a que possui a assinatura.
- Modo: o Coding Plan pretendido está ativo, não uma API Key diferente.
- Escopo: se houver plano pessoal e de equipe, o correto foi selecionado; uma entrada de equipe sem assento não fornece cota.
- Canal atual: o chat usa realmente esse provedor e plano.
A conexão também define a elegibilidade dos cartões. A documentação informa que eles só são entregues ao usuário conectado ao ZCode e ao Coding Plan da conta. Uma API Key sozinha, ou uma conta sem plano, não cumpre essa condição.
Se Connect permanecer em Loading, o FAQ oficial recomenda verificar o acesso de rede ao serviço e também a cota e as permissões de modelo da conta ou chave.
Use o cartão somente quando o ZCode o mostrar
O ZCode 3.8.1 ou posterior pode mostrar oportunidades de redefinição de 5 horas ou semanais no painel do provedor e em Coding Plan. Quando houver uma:
- Clique em Reset.
- Em Resettable quota, confirme qual cota será redefinida.
- Verifique o vencimento.
- Use dentro do prazo.
- Volte ao Coding Plan e confirme que o contador correto chegou a 100% e o cartão foi marcado como usado.
Os cartões expiram. Se houver vários, a documentação diz que o mais antigo é consumido primeiro.
Por que um cartão pode não aparecer
A ausência do botão não prova falha. Cartões automáticos de 5 horas são condicionais: é preciso estar no período de menor movimento aplicável, o uso deve ultrapassar um limite e o teto diário de emissão não pode ter sido atingido. A janela e o limite são parâmetros dinâmicos, e essa janela não é a mesma das idle-time tasks.
Não dependa de uma hora ou porcentagem mostrada no print de outra pessoa. A oportunidade só existe quando seu aplicativo a exibe. Sem cartão, confira a conta uma vez e planeje o trabalho pelo horário normal de renovação.
Escolha como continuar
Opção 1: esperar a cota bloqueadora voltar
É o caminho mais previsível quando a tarefa pode parar. Anote se falta a cota de 5 horas ou semanal e siga o horário da interface. Uma janela móvel não precisa reiniciar à meia-noite, e recuperar a janela curta não ignora uma semanal ainda zerada.
Enquanto espera, prepare o próximo prompt, remova contexto desnecessário, execute testes locais ou divida a tarefa em marcos verificáveis. Isso não aumenta cota, mas reduz tentativas desperdiçadas.
Opção 2: usar um cartão elegível
Use antes do vencimento e apenas na cota indicada. Um cartão de 5 horas não implica redefinir a semanal, e um cartão semanal não é saldo API geral. O sinal de sucesso é o contador-alvo voltar a 100%.
Opção 3: mudar deliberadamente para outro provedor
O ZCode aceita provedores e conexões por API Key independentes. Isso pode manter o trabalho, mas é outra rota, não uma extensão da assinatura esgotada.
Antes de mudar:
- confira a cota, os preços e os modelos do provedor;
- selecione-o explicitamente;
- envie uma instrução curta de teste;
- confirme qual conta será cobrada;
- nunca publique uma API Key em chat, captura ou issue.
O guia oficial diferencia Coding Plan de pacotes de recursos ou saldo pré-pago de API e avisa que a rota de coding e a rota geral não são intercambiáveis. Um saldo separado pode gerar cobrança separada e não restaura os contadores do plano.
Diagnóstico rápido
| O que aparece | Interpretação provável | Próxima ação | Sinal de sucesso |
|---|---|---|---|
| App Usage alto e Coding Plan saudável | O histórico local não é o limitador | Confira o canal e o erro exato | Um pedido curto funciona no plano correto |
| 5-hour = 0%, weekly disponível | A janela curta bloqueia | Cartão de 5 horas ou espera | O contador curto volta |
| weekly = 0% | O ciclo semanal bloqueia | Cartão semanal ou espera | O contador semanal volta |
| MCP = 0 com cota de modelo | Uma ferramenta pode estar limitada | Teste sem a ferramenta e aguarde MCP | O modelo comum funciona ou MCP retorna |
| Não há Reset | Nenhum cartão elegível está visível | Verifique login e plano; não presuma direito a um cartão | Ele aparece depois ou ocorre a renovação normal |
| Connect segue em Loading | Possível rede, acesso ou permissão | Confira conectividade e conta/chave | O provedor carrega e responde ao teste |
| Reset aplicado, erro continua | Cota errada, tela antiga ou canal diferente | Atualize e confirme o canal | O contador correto e o pedido funcionam |
Se a cota parece restaurada, mas ainda falha
Faça uma verificação controlada antes de repetir a tarefa longa:
- Atualize o provedor e Usage Statistics → Coding Plan.
- Confirme que a cota pertence ao mesmo plano pessoal ou de equipe selecionado.
- Abra uma conversa curta e envie uma instrução mínima.
- Se funcionar, retome a tarefa de um checkpoint.
- Se falhar, registre erro exato, horário e fuso, versão do ZCode, provedor, tipo de plano e capturas das cotas. Oculte chaves e dados sensíveis.
O guia oficial de Feedback & Support recomenda incluir contexto, passos de reprodução, capturas e logs relevantes. O ZCode também oferece feedback no aplicativo e no banner de erro.
Checklist final
Antes de iniciar uma sessão longa, confirme que:
- você leu Coding Plan, não apenas App Usage;
- sabe se 5-hour, weekly ou MCP está bloqueando;
- a conta e o plano pessoal ou de equipe corretos estão conectados;
- o cartão corresponde à cota certa e não venceu;
- o provedor alternativo é tratado como cota e cobrança separadas;
- um pedido curto funciona no canal escolhido.
A forma confiável de lidar com o limite do ZCode é diagnosticar primeiro o contador ativo, usar apenas a oportunidade mostrada na sua conta e considerar qualquer provedor alternativo um serviço separado.
