# O Qwen Code deixou de funcionar: porquê e o que fazer em 2026
> Explico por que razão o Qwen deixou de funcionar: o acesso gratuito foi encerrado, confundiram-se o chat e o terminal e surgiu um erro 401. Como voltar a pôr o agente a funcionar sem cartão.
Source: https://ailoot.ai/blog/pt-pt/qwen-code-stopped-working/
Canonical: https://ailoot.ai/blog/pt-pt/qwen-code-stopped-working/
Language: pt-PT
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-208
Revision: sha256-40e5244a8a041ec072994f2bd1c73a6be6cc9bc213dab67b0fb6638820d7030a
A pergunta «O Qwen deixou de funcionar» pode referir-se a várias falhas diferentes, cada uma com uma solução própria. Primeiro, é preciso identificar exatamente o que está a falhar.
Abaixo, as falhas são apresentadas por ordem: o que aconteceu ao início de sessão gratuito, em que diferem o chat no browser e o Qwen Code no terminal, porque é que o agente arranca mas devolve um erro e como voltar a pôr tudo a funcionar sem cartão. Tudo foi verificado com base na documentação oficial do Qwen em 2 de setembro de 2026.
Pode encontrar informações sobre como trabalhar com o Ailoot na [documentação](https://ailoot.ai/docs/).
## O que significa «O Qwen deixou de funcionar»?
Ponto principal
Na maioria dos casos, «O Qwen deixou de funcionar» significa que o início de sessão gratuito foi desativado ou que o acesso ao modelo expirou. O bloqueio por país raramente está relacionado.
Primeiro, vale a pena perceber exatamente o que deixou de funcionar, porque as pessoas usam «não funciona» para descrever quatro situações diferentes. Uma pessoa não consegue iniciar sessão, a outra consegue arrancar o agente mas recebe um erro, uma terceira já não consegue abrir o chat no browser e uma quarta ficou sem quota. Cada situação tem a sua própria solução e, se começar pelo sítio errado, vai perder a noite.
É importante distinguir aqui duas questões que costumam ser confundidas nas queixas. Primeiro: o pedido chega ao servidor? Segundo: o servidor permite-lhe entrar sem o acesso necessário?
A conclusão simples para começar: não especule sobre VPN e bloqueios antes de verificar o início de sessão e o modelo. Na maioria dos casos, o Qwen «deixou de funcionar» precisamente porque os programadores do Qwen alteraram as regras de acesso para todos ao mesmo tempo, enquanto as definições antigas no seu computador permaneceram iguais.
## O que aconteceu ao início de sessão gratuito no Qwen?
Ponto principal
O início de sessão gratuito no Qwen através de OAuth foi encerrado em 15 de abril de 2026 para todos os utilizadores em todo o mundo. A documentação diz isso diretamente: o acesso gratuito terminou e o início de sessão pelo browser foi removido da lista de métodos de início de sessão. Se antes iniciava sessão «através de uma conta qwen.ai sem cartão» e isso deixou subitamente de funcionar, é exatamente por esta razão. O seu país não tem nada que ver com o encerramento.
A razão mais comum para algo «deixar de funcionar» é o encerramento do início de sessão gratuito. Antes, quando iniciava o Qwen Code pela primeira vez, abria-se uma página de início de sessão no browser; iniciava sessão na sua conta qwen.ai e o agente recebia uma quota gratuita de cerca de dois mil pedidos por dia. Muitos guias nos resultados de pesquisa ainda descrevem exatamente esta configuração.
Essa configuração já não existe. A documentação oficial de início de sessão diz, literalmente: «o seu nível gratuito foi descontinuado em 2026-04-15», o que significa que o acesso gratuito terminou em 15 de abril de 2026. Diz também que o início de sessão do Qwen através de OAuth foi removido da janela de seleção do método de início de sessão e permanece na documentação apenas como opção desativada. Foi uma decisão dos programadores do Qwen, aplicada a todos ao mesmo tempo, e não depende das definições locais anteriores do cliente.
Por isso, se antes «simplesmente funcionava sem cartão» e de repente deixou de funcionar, procure a causa no encerramento, não num bloqueio: o antigo início de sessão gratuito terminou e terá de o substituir por outro método de acesso. Qual? Mais abaixo, incluindo uma opção gratuita.
## Qwen no browser ou Qwen Code no terminal: qual deixou de funcionar?
Ponto principal
São dois produtos diferentes. O Qwen no browser (chat.qwen.ai) é um chat num site que responde com texto. O Qwen Code é um agente executado no terminal que abre e edita ficheiros de um projeto por iniciativa própria. Falham de formas diferentes: o chat costuma ter um problema ao iniciar sessão no site, enquanto o agente tem um problema ao ligar-se ao modelo. Primeiro, identifique qual estava a utilizar.
As pessoas usam a palavra «Qwen» para se referirem a duas coisas completamente diferentes, e essa confusão é outra fonte de queixas de que «deixou de funcionar».
A primeira é o chat no browser, em chat.qwen.ai. É um chat normal: acede à página, escreve uma pergunta e recebe uma resposta em texto. Copia manualmente o código. Se foi isto que «deixou de funcionar», o problema está quase sempre no início de sessão no próprio site ou numa restrição regional da página, e a solução está do lado do browser.
A segunda é o Qwen Code, uma ferramenta separada, instalada no terminal, que funciona como um agente de IA. Segundo a descrição oficial, é um agente de programação aberto que lê o projeto inteiro, abre ficheiros por iniciativa própria, edita-os e executa comandos. Não responde com texto numa janela; trabalha dentro da pasta que contém o código. E, quando «deixa de funcionar», isso significa outra coisa: na maioria dos casos, a ligação ao modelo falhou.
| Sinal | Qwen no browser | Qwen Code no terminal |
|----|----|----|
| Onde é executado | site chat.qwen.ai | o seu terminal, dentro do projeto |
| O que faz | responde a uma pergunta com texto | edita ficheiros e executa comandos por iniciativa própria |
| Falha típica | início de sessão no site, restrição regional da página | início de sessão desativado, chave expirada, ausência de modelo |
| Como resolver | do lado do browser | alterar o método de acesso ao modelo |
Primeiro, descubra qual estava a utilizar. O resto do artigo é sobretudo sobre o Qwen Code, porque «escrevia código sozinho e deixou de funcionar» refere-se ao agente no terminal. O chat no browser não funciona de todo dessa forma.
## Porque é que o Qwen Code arranca mas devolve um erro?
Ponto principal
Se o agente arrancar mas devolver um erro de acesso em todos os pedidos (muitas vezes com o código 401), isso significa que o modelo não está ligado ou que o acesso expirou. Depois do encerramento do início de sessão gratuito, o Qwen Code não tem para onde enviar pedidos até configurar um novo método: um plano da Alibaba Cloud, uma chave de um fornecedor terceiro ou um modelo local. O próprio agente está instalado e a funcionar.
Um cenário comum: o Qwen Code é instalado, o comando `qwen` é executado, a janela abre, mas, assim que lhe atribui uma tarefa, recebe um erro de acesso, normalmente com o código 401, que, na linguagem dos servidores, significa «acesso não confirmado». O próprio agente está bem; o problema está no modelo a que se liga.
A causa volta a ser o encerramento do início de sessão gratuito. Antes, o agente ligava-se ao modelo por predefinição através do início de sessão gratuito no qwen.ai. Agora que esse início de sessão foi removido, a definição no seu computador continua a apontar para o método antigo — e é por isso que recebe um erro. Até indicar um novo método de acesso, o agente não tem onde obter uma resposta.
De acordo com a documentação oficial, existem agora três métodos. O primeiro é um plano da Alibaba Cloud: Coding Plan, com uma quota semanal para uma pessoa; Token Plan, com preços de pagamento conforme a utilização para equipas; ou uma chave normal do Model Studio. O segundo é uma chave de um fornecedor terceiro: o Qwen Code pode funcionar com DeepSeek, Kimi, MiniMax, ModelScope e outros; a chave é introduzida no ficheiro de definições. O terceiro é usar o seu próprio modelo no seu próprio computador, sem qualquer chave. Esta última opção é gratuita e tem uma secção própria mais abaixo.
## Como voltar a pôr o Qwen a funcionar gratuitamente e sem cartão?
Ponto principal
O Qwen Code funciona gratuitamente e sem cartão com um modelo local no seu computador. A documentação oficial suporta-o explicitamente: o agente pode ligar-se a um servidor local através do Ollama ou do vLLM. Transfira um modelo Qwen para o seu computador, inicie um servidor local e indique ao agente o endereço desse servidor. Sem início de sessão, chave ou pagamento — mas precisa de um computador mais potente.
Se o seu objetivo é voltar a pôr o Qwen a funcionar sem gastar dinheiro nem usar cartão, há uma forma funcional: executar o modelo no seu próprio computador. O Qwen Code foi concebido para ser flexível neste aspeto. A descrição indica explicitamente que suporta qualquer fornecedor terceiro ou modelo local através do Ollama e do vLLM e que pode alternar entre eles quando quiser.
A ideia é simples. Instale no seu computador um programa que consiga executar modelos localmente (o Ollama é a opção mais simples), transfira um modelo Qwen através dele e será iniciado um servidor local na sua máquina. Depois, nas definições do Qwen Code, escolha «Custom Provider» e introduza o endereço desse servidor local. A partir daí, o agente envia pedidos diretamente para o modelo no seu computador, sem passar pela cloud.
Passos:
1. Instale o Ollama a partir do site oficial, ollama.com — está disponível para Windows, macOS e Linux.
2. Transfira através do Ollama um modelo Qwen do tamanho pretendido (quanto maior for o modelo, mais potente terá de ser o seu computador).
3. Inicie o Ollama — este iniciará um servidor local no seu computador.
4. No Qwen Code, abra as definições de acesso com o comando `/auth` e escolha «Custom Provider».
5. Introduza o endereço do servidor local do Ollama como um endpoint compatível, e o agente começará a funcionar através dele.
Esta opção tem um custo real: o hardware. O modelo é executado no seu computador, por isso um portátil fraco não consegue lidar com as versões mais exigentes; terá de escolher um modelo mais pequeno. Mas não precisa de início de sessão, chave ou cartão: os cálculos são efetuados localmente, sem contactar um modelo na cloud.
## Como ligar o Qwen através de um fornecedor terceiro se o seu computador não conseguir executar um modelo local?
Ponto principal
Se o seu computador não conseguir executar um modelo local, o Qwen Code pode ligar-se a um modelo utilizando uma chave de um fornecedor terceiro. O agente suporta DeepSeek, Kimi, MiniMax, ModelScope e outros serviços: obtenha uma chave de acesso junto do fornecedor, introduza-a no ficheiro de definições `~/.qwen/settings.json` e indique o modelo. A forma como paga pelo acesso é uma questão separada e não é abordada aqui.
Se o seu próprio computador não conseguir executar o modelo, a cloud continua a ser uma opção, e não tem de ser através do próprio Qwen. O agente pode ligar-se aos modelos de outros fornecedores usando uma chave; é uma funcionalidade normal, sem truques.
De acordo com a documentação, o Qwen Code funciona com chaves de diferentes fornecedores: DeepSeek, Kimi, MiniMax, Z.AI, ModelScope e outros. O processo é igual para todos: configure o acesso junto do fornecedor que escolher, obtenha uma chave, introduza-a no ficheiro de definições `~/.qwen/settings.json` e indique também o nome do modelo e o endereço do serviço. Depois disso, o agente recebe as respostas desse fornecedor. Deixa de se ligar através do início de sessão gratuito do Qwen, que está desativado. Para obter informações sobre como emitir uma chave e quanto custa utilizá-la, consulte [Chave de API para o Qwen Code](https://ailoot.ai/blog/pt-pt/qwen-code-api-key/).
Uma nota sobre o próprio Qwen: a Alibaba Cloud tem um plano para programadores com uma quota semanal, bem como uma chave normal do Model Studio. O acesso à rede do servidor e o pagamento pelo acesso são questões separadas; não as confunda ao diagnosticar o problema.
## O que fazer, passo a passo, se o Qwen deixou de responder?
Ponto principal
Primeiro, identifique o que está a utilizar: o chat no browser ou o Qwen Code no terminal. Depois, verifique o método de acesso: o início de sessão gratuito foi encerrado, por isso precisa de outra opção. A seguir, escolha um caminho com base no hardware e em ter ou não cartão: um modelo local gratuito ou a chave de um fornecedor terceiro. Verifique um eventual bloqueio de rede no seu país apenas no fim — quase nunca é a causa.
Eis tudo numa só sequência para não ter de andar a experimentar ao acaso. Siga os passos de cima para baixo e pare assim que encontrar a resposta.
1. Identifique o produto. O chat no browser e o Qwen Code no terminal são coisas diferentes, com modos de falha diferentes.
2. Lembre-se de como iniciava sessão. Se o início de sessão gratuito sem cartão funcionava antes, foi encerrado em 15 de abril de 2026; essa é a causa e terá de utilizar um novo método de acesso.
3. Leia a mensagem de erro. O código 401 e as mensagens sobre acesso significam que o modelo não está ligado. Não dizem nada sobre um bloqueio.
4. Escolha consoante o hardware. Se o seu computador for potente, execute um modelo local através do Ollama — é gratuito e não exige cartão. Se for fraco, ligue-se a um modelo utilizando uma chave de um fornecedor terceiro.
5. Verifique o acesso à rede separadamente, depois de verificar o produto, o método de início de sessão e a ligação ao modelo.
É assim que «O Qwen deixou de funcionar» se transforma numa sequência de passos claros e, em quase todos os casos, a causa acaba por ser uma alteração nas regras de acesso. O país só entra em consideração no fim.
### Fontes
- [Qwen Code - Autenticação (documentação oficial)](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/)
- [Qwen Code - repositório e descrição (GitHub)](https://github.com/QwenLM/qwen-code)
- [Ollama - execução de modelos localmente (site oficial)](https://ollama.com)
Conheça o [Ailoot](https://ailoot.ai/).
## Perguntas frequentes
### O que identifico antes de mudar definições Qwen?
Distinga primeiro chat no navegador do agente de terminal Qwen Code. No agente, leia o erro exato e confirme autenticação, modelo e endpoint antes de tratar como restrição de rede.
### Que compromisso implica substituir nuvem por um modelo local?
A inferência local evita custos API do modelo na nuvem, mas usa o seu hardware. Escolha um modelo suportado pela máquina, inicie o servidor, configure o agente e verifique uma tarefa real do projeto.
## Ailoot · A empresa e a sua carteira de projetos
A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.
A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.
A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.