Uso do Qwen Code esgotado? Identifique a cota e continue trabalhando
O Qwen Code não tem uma cota universal. Este guia mostra como identificar a autenticação ativa, conferir o limite correspondente e escolher uma forma compatível de continuar sem confundir Coding Plan, Token Plan, API padrão e provedores externos.
Conteúdo
Quando o Qwen Code informa que o uso acabou, não espere um “reset geral” nem procure o preço da API do Qwen3.8 Max. O Qwen Code é o cliente; a cota e a cobrança pertencem ao método de autenticação e ao provedor que atende à solicitação.
Execute /doctor dentro do Qwen Code. Em seguida, confira o nome da variável de credencial, o baseUrl, o modelo e a região, sem exibir a chave. Só então determine se a sessão usa o antigo Qwen OAuth, Alibaba Cloud Coding Plan, Token Plan, uma API Key padrão ou um provedor de terceiros/customizado. O antigo qwen auth status foi removido; a orientação atual usa /doctor para verificar e /auth para trocar a autenticação.
Qual cota realmente acabou
| Fonte | Sinal comum | O que “esgotado” significa | Como continuar |
|---|---|---|---|
| Qwen OAuth | Credenciais antigas de login no navegador | O nível gratuito foi encerrado, não está aguardando renovação | Use /auth e escolha uma opção atual |
| Coding Plan | Chave específica e endpoint coding...dashscope.aliyuncs.com | Um dos limites do plano ou um limite técnico separado | Aguarde a renovação correta ou mude de autenticação com cobrança separada |
| Token Plan | Chave própria e endpoint token-plan...maas.aliyuncs.com | Credits da edição, assento ou pacote | Aguarde o ciclo, adicione cota permitida ou troque a autenticação |
| API Key padrão | Endpoint regional comum do Model Studio | Saldo, cota grátis do modelo, cobrança por tokens ou rate limit | Ative/financie a cobrança, aguarde o limite ou troque o provedor |
| Provedor externo/custom | baseUrl, protocolo e modelo do provedor | Saldo, assinatura ou limites desse provedor | Consulte o painel ou troque com /auth |
O nome do modelo não identifica a cota. O mesmo modelo pode existir em rotas comerciais diferentes.
Diagnóstico seguro em cinco minutos
1. Guarde o erro exato
Registre mensagem, horário, modelo e momento da falha. Não exponha a API Key em capturas ou tickets. Uma mensagem explícita de cota é evidência melhor do que 401, 403, 429, timeout ou model not found genéricos.
2. Execute /doctor
A documentação oficial indica /doctor para verificar a autenticação atual. Anote tipo, provedor e categoria do endpoint. Se ainda for Qwen OAuth, não existe uma cota grátis que vá voltar.
Use /auth para trocar a fonte. /model seleciona um modelo já configurado; não garante mudança de conta, plano ou cobrança.
3. Revise os dois níveis de configuração
Verifique ~/.qwen/settings.json e .qwen/settings.json no projeto. A configuração do projeto pode substituir a do usuário; variáveis de ambiente e argumentos de inicialização têm prioridade ainda maior. Uma variável antiga pode continuar encaminhando solicitações ao provedor anterior.
Confira apenas dados não secretos: protocolo, nome da variável, baseUrl, ID do modelo e região. Não imprima o valor da chave. Se o segredo estiver no JSON, mova-o para uma fonte protegida quando possível.
4. Relacione endpoint e plano
O Coding Plan internacional usa endereço com coding-intl.dashscope.aliyuncs.com. O Token Plan internacional usa token-plan.ap-southeast-1.maas.aliyuncs.com. A rota padrão pay-as-you-go usa endpoints regionais diferentes.
A chave do Coding Plan e a chave geral do Model Studio não são intercambiáveis. Uma combinação incorreta pode gerar erro de autenticação; uma chave geral com o endpoint pay-as-you-go pode gerar cobranças separadas em vez de consumir a cota do plano.
5. Abra o console correto
Entre na conta, região e plano identificados. Veja uso restante, limite atingido, horário de renovação, assinatura, cobrança e avisos de serviço ou throttling.
Se você usa Coding Plan
Em 1º de outubro de 2026, a página internacional oficial lista o Pro por USD 50/mês com três limites simultâneos:
- 6.000 solicitações a cada cinco horas;
- 45.000 por semana;
- 90.000 por mês.
O primeiro limite atingido pausa as chamadas. Uma instrução pode gerar várias chamadas ao modelo, então tarefas agentes complexas consomem mais que perguntas curtas.
A cota de cinco horas é móvel; a semanal reinicia toda segunda-feira às 00:00 (UTC+08:00); a mensal reinicia na data de renovação às 00:00 (UTC+08:00). Esperar cinco horas não resolve um limite semanal ou mensal. Confirme o limite no console. Outras regiões podem ter preço, moeda ou disponibilidade diferentes.
Para continuar antes do reset, use /auth e mude para API Key padrão, Token Plan ou outro provedor. Isso cria outra rota de cota e cobrança; não amplia o Coding Plan. Mantenha chave e endpoint corretos juntos.
O Coding Plan é para uso interativo em ferramentas compatíveis. A página oficial proíbe sua chave em scripts automatizados ou backends.
Se você usa Token Plan
O Token Plan não compartilha o contador do Coding Plan. A documentação internacional atual o descreve em Credits; edições e cotas podem variar. O consumo depende do modelo, tokens, modo de raciocínio e chamadas de ferramentas.
Na Team Edition documentada, primeiro são consumidos os Credits do assento e depois um pacote compartilhado. Quando todos acabam, o serviço pausa até o próximo ciclo ou até adicionar um pacote permitido. O console mostra uso, reset, assentos e pacotes.
Confirme edição, região, Credits e endpoint dedicado. Não aplique os resets do Coding Plan. Para mudar a fonte de cobrança, use /auth de forma explícita.
Se você usa API Key padrão
A API padrão do Model Studio é pay-as-you-go. O limite depende de saldo e cobrança, cota grátis específica do modelo/região, rate limits e capacidade. Não há um “reset semanal do Qwen Code” universal.
Confira uso e cobrança na conta e região corretas. Se a cota grátis acabou ou não há saldo, ative ou financie a cobrança conforme as regras atuais. Se for apenas rate limit, aguarde a janela indicada.
401 ou 403 normalmente pedem verificação de chave, permissões, região e endpoint. 429 pode ser cota, rate limit ou throttling temporário. Leia o corpo da resposta e o painel.
Se você usa provedor externo
A cota comercial é definida pelo provedor. Verifique saldo, assinatura, acesso ao modelo, limites por minuto ou concorrência, renovação, endpoint e Model ID. Trocar de modelo no mesmo provedor pode continuar usando o mesmo saldo; trocar com /auth muda a rota de cobrança.
Cota ou erro de configuração?
- Mensagem explícita de Qwen OAuth encerrado: troque a autenticação.
- Limite do plano confirmado no console: siga a regra de recuperação.
401/403: revise chave, permissões, endpoint e região.model not found: revise modelos compatíveis; não prova falta de cota.429, fila ou interrupção curta: veja rate limit,Retry-After, status e console.- Timeout/rede: confira conectividade e estado do provedor.
Como verificar a recuperação
- Reinicie o Qwen Code para recarregar variáveis.
- Execute
/doctore confirme a autenticação esperada. - Use
/modele escolha um modelo compatível. - Envie uma solicitação pequena e somente leitura, como resumir um arquivo sem alterá-lo.
- Confirme o sucesso e o registro de uso no console correto.
- Só depois retome a tarefa longa.
Uma solicitação pequena comprova autenticação, endpoint e modelo, mas não garante que a cota restante suporte uma tarefa grande.
Erros comuns
- Esperar cinco horas após atingir o limite semanal ou mensal.
- Achar que reiniciar repõe cota.
- Trocar apenas chave ou endpoint.
- Ignorar configuração do projeto ou variáveis com maior prioridade.
- Usar
/modelcomo troca de cobrança. - Confundir preço por token do Qwen3.8 Max com limite do Qwen Code.
- Criar outra chave na mesma conta sem saldo.
- Usar chave do Coding Plan em automação.
Perguntas frequentes
Ainda existe uma cota grátis universal?
Não. O nível grátis do Qwen OAuth terminou em 15 de abril de 2026. Provedores podem oferecer créditos próprios ligados a conta, modelo e região específicos.
Reiniciar recupera o uso?
Não. Reiniciar apenas recarrega a configuração; quem repõe a cota é o provedor.
Trocar de modelo contorna o limite?
Somente se o novo modelo usar uma cota realmente independente. Modelos do mesmo plano frequentemente compartilham limite ou Credits.
Preciso de uma nova chave?
Só se a atual estiver inválida, revogada ou exposta. Outra chave da mesma conta esgotada normalmente não cria cota.
