# Qwen Code e Qwen 3.7-max: configurar o Token Plan > Instalação do Qwen Code no Node.js 22, ligação ao Token Plan internacional e três problemas que causam erros 401: o endereço da API, a chave e a atribuição do lugar. Source: https://ailoot.ai/blog/pt-pt/qwen-code-token-plan-setup/ Canonical: https://ailoot.ai/blog/pt-pt/qwen-code-token-plan-setup/ Language: pt-PT Publisher: Ailoot (https://ailoot.ai/) Translation: guide-207 Revision: sha256-91de0ddace6a0c995c65054694d2d0ebeda7f2bb749f9765ac01c44fb3ce94d4 Documentação de referência do Ailoot: [ailoot.ai/docs/](https://ailoot.ai/docs/). **Atualizado em 03.10.2026:** desde a publicação, três coisas mudaram. A Alibaba encerrou as novas compras do Coding Plan — o nível Lite já em março, e o Pro está esgotado. O Token Plan passou de uma quota semanal para uma mensal. Foi lançado um modelo mais recente, o Qwen3.8-max. Também corrigi um erro na descrição da chave do Token Plan — é importante para esse mesmo erro 401 e explico-o abaixo. ## O que é o Qwen Code e porque não é apenas mais uma cópia?
Ponto-chave O Qwen Code é um agente de IA de código aberto para terminal, da Alibaba, que funciona como o Claude Code: é executado no terminal do VS Code, lê o seu projeto, escreve código e executa comandos. A principal diferença é o acesso a mais de uma dezena de modelos através de uma única subscrição, incluindo Qwen 3.7, DeepSeek V4 e Kimi K2.
Quando ouvi falar do Qwen Code pela primeira vez, pensei: «Mais um clone do Claude Code que vai falhar ao segundo pedido.» Estava enganado. A Alibaba não copiou a interface — criou o seu próprio agente CLI de raiz, com compatibilidade total com a API da OpenAI. Isto significa que pode executar não só modelos Qwen, mas também DeepSeek, GLM, Kimi e até Claude através da API da Anthropic. Eis o que consegue fazer na prática: - Lê a estrutura do projeto e compreende o contexto (à semelhança do Claude Code com o ficheiro `CLAUDE.md`) - Executa comandos de shell, edita ficheiros e cria commits - Suporta Skills e SubAgents - Funciona no VS Code através do terminal integrado ou de uma extensão - Alterna entre modelos com um único comando `/model` Tem uma desvantagem, mas é fundamental: **o nível gratuito terminou a 15 de abril de 2026**. Antes, o Qwen OAuth oferecia 100 pedidos gratuitos por dia — agora só existem opções pagas. Mesmo assim, o Qwen Code pago custa bastante menos do que uma subscrição Claude Pro. Se está a escolher entre ferramentas neste momento, abordei todas as opções no guia [«Com o que programar em 2026: 8 ferramentas de IA»](https://ailoot.ai/blog/pt-pt/ai-coding-tools/). ## Quanto custa e que plano deve escolher?
Ponto-chave A Alibaba oferece três opções de pagamento: pagamento por token, a subscrição Coding Plan e a subscrição Token Plan. Para vibe coding diário, o Token Plan oferece a melhor relação qualidade-preço: um valor mensal fixo, mais de 10 modelos e sem necessidade de contar tokens.
A confusão sobre os planos é a maior dor de cabeça ao configurar o Qwen Code. A Alibaba usa nomes diferentes para as mesmas coisas em várias partes da consola e até a extensão do VS Code mostra as opções erradas. Eis como funciona na prática (verificado na documentação da Alibaba Cloud, atualizada em 28.09.2026). | Plano | O que é | Para quem se destina | Custo aproximado | |----|----|----|----| | **Pay-as-you-go** | Paga separadamente por cada milhão de tokens | Utilização ocasional, para experimentar | \$0.30–1.20 por 1M de tokens | | **Coding Plan** | Uma subscrição individual com uma quota mensal (a quota semanal foi descontinuada em 22.09.2026) | Atualmente indisponível para novos subscritores — as compras do nível Lite foram encerradas em 20.03.2026 e o Pro está esgotado | atualmente indisponível para novas contas | | **Token Plan Team Edition, Standard Seat** | 25 000 créditos por lugar por mês, mais de 10 modelos | Vibe coding diário com alternância entre modelos | \$20/lugar por mês em promoção (preço normal: \$30) | Na experiência descrita pelo autor, foi escolhido o **Token Plan**, porque uma única subscrição dá acesso ao Qwen 3.7-max (e ao mais recente Qwen3.8-max), DeepSeek V4 Pro e GLM-5. Todos os modelos usam o mesmo conjunto de créditos. Alterne com o comando `/model` — não precisa de comprar uma chave separada para cada fornecedor. **Importante:** Coding Plan e Token Plan são **produtos diferentes** com endereços de API diferentes. Uma chave do Coding Plan tem o prefixo `sk-sp-`. Uma chave do Token Plan não tem qualquer prefixo — é assim que a documentação oficial do Qwen Code a descreve. Se trocar o endereço ou a chave entre produtos, receberá um erro 401. E, como o Coding Plan já não aceita novas compras, o Token Plan é atualmente a única opção funcional para a maioria dos leitores. ## Como instalar o Qwen Code?
Ponto-chave Há duas opções: através do npm (`npm install -g @qwen-code/qwen-code@latest`) ou do Homebrew (`brew install qwen-code`). Precisa do Node.js 22 ou posterior. Depois da instalação, execute `qwen` no terminal.
Verifique a versão do Node.js antes de instalar: ```bash node --version ``` Precisa da versão **22 ou posterior**. Se tiver uma versão mais antiga, atualize-a através de [nodejs.org](https://nodejs.org/en/download) ou com o `nvm`: ```bash nvm install 22 nvm use 22 ``` Em seguida, instale o Qwen Code com um comando: ```bash npm install -g @qwen-code/qwen-code@latest ``` Ou utilize o Homebrew no macOS: ```bash brew install qwen-code ``` Confirme a instalação: ```bash qwen --version ``` Se for apresentada uma versão, está pronto. Inicie o Qwen Code com o comando `qwen` no terminal. No VS Code, abra o terminal integrado (Ctrl+`) e escreva `qwen\`. Também existe uma **extensão do VS Code** — `Qwen Code Companion`, da QwenLM, no marketplace. Acrescenta uma barra lateral de chat, semelhante à do GitHub Copilot. Uso essa extensão — é mais prática do que apenas o terminal. ## Como criar uma conta e comprar o Token Plan?
Ponto-chave Registe-se na consola internacional da Alibaba Cloud (modelstudio.console.alibabacloud.com), adicione um cartão aceite pelo fornecedor e subscreva o Token Plan. O processo inteiro demora 10 minutos.
Passo a passo: 1. Aceda a [modelstudio.console.alibabacloud.com](https://modelstudio.console.alibabacloud.com/) 2. Clique em **Free Sign Up**, no canto superior direito 3. Introduza o seu endereço de e-mail (o Gmail funciona) e confirme o código recebido na caixa de entrada 4. Adicione o seu número de telefone 5. Adicione um cartão aceite pelo fornecedor. A Alibaba cobrará \$1 para o verificar e reembolsará o valor no prazo de 1–3 dias. 6. Na consola, encontre a secção **ModelStudio** e o separador **Token Plan** 7. Escolha o nível **Standard** (o mínimo para começar) 8. Confirme o pagamento Após a compra, será encaminhado para a página **My Subscriptions**. Aí verá: - **Standard Seat: 0/1** — significa que comprou um lugar, mas ainda não o atribuiu a si próprio - Clique em **Assign** — selecione a sua conta e confirme - O estado deverá mudar para **1/1** A chave da API não funcionará sem este passo. Na experiência descrita pelo autor, este processo demorou 20 minutos. ## Onde obter a chave da API e o endereço correto?
Ponto-chave A chave da API e o endereço da API (Base URL) estão na página Management Platform. Para o Token Plan internacional, o endereço é `https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`. Não o confunda com o endereço normal do DashScope — a chave do Token Plan não funcionará nesse endereço.
Na página **My Subscriptions**, clique no botão roxo grande **Go to Management Platform**. Abrir-se-á um painel separado. Selecione **Overview** no menu à esquerda. Nesta página, verá duas secções: **Plan-specific API Key** — a sua chave pessoal. Está oculta por asteriscos. Clique no **ícone de cópia** ao lado (não a selecione com o rato — os asteriscos serão copiados). As chaves do Token Plan não têm prefixo. Não é um erro de digitação nas instruções; a documentação oficial do Qwen Code descreve-as assim. Se vir `sk-sp-`, trata-se de uma chave do **Coding Plan**, um produto diferente — copiou a chave errada. **Plan-specific Base URL** — duas opções: - Para ferramentas compatíveis com OpenAI (Qwen Code): `https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` - Para ferramentas compatíveis com Anthropic: `https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic` Lembre-se: **só estes endereços funcionam com uma chave do Token Plan**. O endereço padrão `dashscope-intl.aliyuncs.com` destina-se a chaves normais (pay-as-you-go), enquanto `coding-intl.dashscope.aliyuncs.com` é o endereço do Coding Plan. Uma chave do Token Plan usada com qualquer um deles devolverá um erro 401. ## Como ligar o Qwen Code ao VS Code?
Ponto-chave Configure a extensão do VS Code através do ficheiro `~/.qwen/settings.json`. Tem de introduzir a chave, o endereço de API correto e o modelo. Eis uma configuração pronta a usar — copie-a e substitua a chave pela sua.
Se instalou a **extensão Qwen Code Companion** a partir do marketplace do VS Code: 1. Abra a paleta de comandos (Cmd+Shift+P) 2. Escreva **Qwen Code: Choose Provider** 3. Se vir um menu de opções, **não escolha Coding Plan** (é um produto diferente). Escolha **Standard API Key** 4. Cole a chave da Management Platform — as chaves do Token Plan não têm um prefixo fixo 5. Região: **Singapore** 6. Modelo: `qwen3.7-max` Se receber um erro depois disto, **configure-o manualmente através do ficheiro**. Por vezes, a extensão preenche o endereço errado. Abra ou crie o ficheiro `~/.qwen/settings.json` e cole: ```json { "env": { "TOKEN_PLAN_API_KEY": "YOUR-KEY-FROM-MANAGEMENT-PLATFORM" }, "modelProviders": { "openai": [ { "id": "qwen3.7-max", "name": "qwen3.7-max", "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1", "envKey": "TOKEN_PLAN_API_KEY", "generationConfig": { "extra_body": { "enable_thinking": true }, "contextWindowSize": 262144 } }, { "id": "qwen3.6-plus", "name": "qwen3.6-plus", "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1", "envKey": "TOKEN_PLAN_API_KEY", "generationConfig": { "extra_body": { "enable_thinking": true }, "contextWindowSize": 1000000 } }, { "id": "deepseek-v4-pro", "name": "deepseek-v4-pro", "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1", "envKey": "TOKEN_PLAN_API_KEY", "generationConfig": { "extra_body": { "enable_thinking": true }, "contextWindowSize": 1000000 } } ] }, "security": { "auth": { "selectedType": "openai" } }, "model": { "name": "qwen3.7-max" } } ``` Substitua `YOUR-KEY-FROM-MANAGEMENT-PLATFORM` pela sua chave da Management Platform. Reinicie o VS Code. Está feito. ## Porque aparece o erro 401 e como o corrigir?
Ponto-chave Em 90% dos casos, um erro 401 ao configurar o Qwen Code significa que o endereço da API ou a chave estão errados. Token Plan, Coding Plan e pay-as-you-go usam endereços diferentes e as respetivas chaves não são intercambiáveis.
O autor descreveu os erros que encontrou durante a configuração. Eis a lista completa das causas dos erros 401 e como as verificar: | Sintoma | Causa | Solução | |----|----|----| | `invalid_api_key` | É enviada uma chave do Token Plan para o endereço do DashScope (ou vice-versa) | Verifique a Base URL. Para o Token Plan: `token-plan.ap-southeast-1...`; para o Coding Plan: `coding-intl.dashscope...` | | `invalid access token` | O lugar Standard Seat não foi atribuído (0/1) | Aceda a My Subscriptions — clique em Assign — deverá aparecer 1/1 | | `invalid_api_key` | A extensão do VS Code gerou a sua própria chave através do fluxo de autenticação em vez de usar o Token Plan | Abra `~/.qwen/settings.json` — confirme que a chave corresponde à apresentada pela Management Platform (não a confunda com a chave do Coding Plan, que tem o prefixo `sk-sp-`) | | `invalid_api_key` | Foi copiado um espaço ou uma quebra de linha juntamente com a chave | Apague a chave e copie-a novamente com o ícone de cópia (não a selecione com o rato) | | `model not found` | O modelo não está incluído no seu plano | Consulte a lista Available Models na página da subscrição | | `Insufficient quota` | Os créditos esgotaram-se | Consulte Usage em My Subscriptions. Se estiver nos 100%, aguarde pela reposição ou compre um Boost Pack | **Verificação rápida da chave através do terminal:** ```bash curl -s -o /dev/null -w "%{http_code}" -X POST \ "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"qwen3.7-max","messages":[{"role":"user","content":"hi"}],"max_tokens":5}' ``` Se devolver `200`, a chave funciona e o problema está nas definições da extensão. Se devolver `401`, a chave ou o endereço estão errados. ## Que modelos estão disponíveis e qual deve escolher?
Ponto-chave O Token Plan oferece mais de 10 modelos de 5 fornecedores; o novo modelo de topo Qwen3.8-max foi adicionado em agosto de 2026. Para vibe coding, o modelo principal para o dia a dia é o qwen3.6-plus (um equilíbrio entre preço e qualidade). Para tarefas complexas, use o qwen3.7-max ou o mais recente qwen3.8-max. Para edições rápidas, use o qwen3.6-flash.
Eis os modelos realmente úteis para vibe coding: | Modelo | Quando o utilizar | Consumo de créditos | |----|----|----| | **qwen3.8-max** | O novo modelo de topo da Alibaba (lançado em agosto de 2026), qualidade máxima em tarefas complexas | Elevado — os créditos esgotam-se mais depressa do que com o 3.7-max | | **qwen3.7-max** | Arquitetura complexa, refatoração de um projeto grande, geração de raiz | Elevado — a quota esgota-se numa semana com programação diária | | **qwen3.6-plus** | Modelo principal para o dia a dia: edições, melhorias, revisões, explicações | Médio — suficiente para um mês, com 2–4 horas de utilização por dia | | **qwen3.6-flash** | Edições rápidas, perguntas simples, formatação | Baixo | | **deepseek-v4-pro** | Alternativa ao Qwen: por vezes melhor em tarefas algorítmicas e matemática | Médio | | **kimi-k2.6** | Contexto longo: leitura de grandes bases de código, análise de documentação | Médio | Alterne entre modelos com o comando `/model` diretamente na sessão do Qwen Code — não precisa de alterar as definições nem de reiniciar. **Começaria com o `qwen3.6-plus`.** Se ao fim de uma semana sentir que a quota se esgota demasiado depressa, passe a usar o `qwen3.6-flash` para o trabalho de rotina e reserve o `qwen3.7-max` apenas para tarefas complexas. ## Qwen Code ou Claude Code — qual deve utilizar?
Ponto-chave O Claude Code produz código de melhor qualidade e compreende melhor o contexto. O Qwen Code custa menos e dá acesso a vários modelos através de uma única subscrição. A combinação ideal: Claude Code para o trabalho principal e Qwen Code para tarefas paralelas e experiências.
A análise descreve um mês de trabalho do autor com ambas as ferramentas. Eis uma comparação baseada nessa experiência: | Critério | Claude Code | Qwen Code | |----|----|----| | Qualidade do código | Melhor — entretanto, a Anthropic lançou modelos mais recentes (Opus 5.5, 22.09.2026); a diferença não diminuiu | Boa, mas mesmo o novo modelo de topo Qwen3.8-max fica atrás dos principais modelos da Anthropic em testes independentes | | Compreensão do projeto | `CLAUDE.md` + leitura aprofundada da árvore do projeto = funciona como uma pessoa | Mecânica semelhante, mas menos refinada | | Preço | Claude Pro \$20/mês (Max \$100–200/mês para programação intensiva) | Token Plan Standard a partir de \$20/mês, inclui mais de 10 modelos | | Seleção de modelos | Apenas Claude (Opus/Sonnet/Haiku) | Qwen + DeepSeek + GLM + Kimi + MiniMax | | Código aberto | Não (código fechado) | Sim (licença MIT) | | Extensão do VS Code | Nativa, estável | Disponível, mas pouco aperfeiçoada — por vezes tem problemas com a chave | **Quando o Qwen Code compensa mais:** - Precisa de acesso a vários modelos (DeepSeek para matemática, Kimi para contexto longo) - Está a experimentar abordagens diferentes para a mesma tarefa - Tem um orçamento limitado, mas programa todos os dias - Quer uma ferramenta de código aberto que possa personalizar **Quando o Claude Code é indispensável:** - Um projeto crítico em que a qualidade do código representa dinheiro - Trabalho com um grande projeto legado (o Opus mantém melhor o contexto) — abordei à parte [como não esgotar os limites do Claude Code](https://ailoot.ai/blog/pt-pt/claude-code-token-limits-saving/) - Precisa de uma extensão do VS Code estável, sem configuração manual A combinação na experiência descrita pelo autor: **Claude Code para o projeto principal**, **Qwen Code para experiências e tarefas paralelas**, onde pode experimentar rapidamente uma ideia com um modelo mais barato. Para uma comparação detalhada com outras ferramentas, consulte [Cursor vs Claude Code](https://ailoot.ai/blog/pt-pt/cursor-vs-claude-code/) e [Codex vs Claude Code](https://ailoot.ai/blog/pt-pt/codex-vs-claude-code-choice/). ## Três problemas com que toda a gente se depara
Ponto-chave Token Plan e Coding Plan são produtos diferentes, com endereços diferentes. A extensão do VS Code preenche a chave errada. É necessário atribuir o lugar manualmente. Estes três problemas podem custar entre 30 minutos e várias horas — passei pelos três e registei as soluções.
### Problema 1: Token Plan ≠ Coding Plan A Alibaba usa nomes diferentes para estes produtos em várias partes da consola. A opção «Coding Plan» na extensão do VS Code **não é o Token Plan**. Tenha em conta: em 20.03.2026, o Coding Plan Lite já não aceita novas compras e o Pro está esgotado — se ainda não o tiver, só pode escolher o Token Plan. Os produtos têm endereços de API diferentes: - **Token Plan**: `https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` - **Coding Plan**: `https://coding-intl.dashscope.aliyuncs.com/v1` Se comprou o Token Plan, mas configurou a extensão como Coding Plan, receberá um erro 401. E vice-versa. ### Problema 2: A extensão do VS Code gera a sua própria chave Quando faz a configuração na interface gráfica da extensão (Cmd+Shift+P - Qwen Code: Choose Provider), por vezes a extensão gera **a sua própria chave** através da API de autenticação da Alibaba. Esta chave tem um formato diferente e não está associada à sua subscrição Token Plan. Solução: depois de a configurar através da interface gráfica, abra `~/.qwen/settings.json` e confirme que a chave em `env` corresponde à apresentada pela **Management Platform** (Overview - Plan-specific API Key). Se não corresponder, substitua-a manualmente. ### Problema 3: O lugar Standard Seat não foi atribuído Depois de comprar o Token Plan, verá `Standard Seat: 0/1` na página My Subscriptions. Isto significa que o lugar foi comprado, mas **não está associado à sua conta**. A chave da API não funcionará até clicar em **Assign**. Na experiência do autor, a investigação do erro 401 demorou 20 minutos até reparar nesta linha. ## Como confirmar que está tudo a funcionar?
Ponto-chave Dois passos: primeiro, verifique a chave com curl no terminal (deverá devolver 200); depois, escreva qualquer prompt no Qwen Code. Se o curl funcionar, mas a extensão não, o problema está nas definições do ficheiro `~/.qwen/settings.json`.
**Passo 1. Verifique a chave através do terminal:** ```bash curl -X POST \ "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"qwen3.6-plus","messages":[{"role":"user","content":"Hello"}]}' ``` Se a resposta contiver texto do modelo, a chave e o endereço estão a funcionar. **Passo 2. Verifique no Qwen Code:** Abra o VS Code — terminal integrado — e escreva `qwen`. Se iniciar, escreva algo: ``` O que é este projeto nesta pasta? ``` O Qwen Code irá ler a estrutura e responder. Se o fizer, a configuração está concluída. **Passo 3. Verifique o consumo de créditos:** Cinco minutos após os primeiros pedidos, aceda a Management Platform — Overview — Usage Consumption. A percentagem deverá ser superior a zero. Se continuar nos 0% após mais de 10 pedidos, está a usar o endereço errado (os pedidos estão a sair da subscrição, a passar para pay-as-you-go ou a não chegar a lado nenhum). ## E a seguir?
Ponto-chave O Qwen Code está configurado — pode começar a fazer vibe coding. Mas a ferramenta é apenas o início. A diferença entre «instalei o CLI» e «estou a criar um produto com IA» está na metodologia de trabalho com o contexto.
Instalou o Qwen Code e está a funcionar. Pode abrir qualquer projeto e começar a desenvolvê-lo através de um diálogo com a IA. A pergunta seguinte é: porque é que o mesmo prompt no Qwen Code produz um ótimo resultado num projeto e disparates noutro? Tudo depende do contexto. Se o projeto contiver uma estrutura `business/` com o público, os produtos e os objetivos, a IA trabalha como parceira. Se a pasta estiver vazia, alucina.
### Fontes - [Qwen Code no GitHub](https://github.com/QwenLM/qwen-code) — código-fonte e documentação, verificados em 03.10.2026 - [Alibaba Cloud ModelStudio](https://modelstudio.console.alibabacloud.com/) — consola para gerir subscrições e chaves - [Visão geral do Token Plan](https://www.alibabacloud.com/help/en/model-studio/token-plan-overview) — planos atuais e estado do Coding Plan, atualização da Alibaba em 28.09.2026, consultado em 03.10.2026 - [Documentação do Qwen Code: Autenticação](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) — formatos das chaves do Token Plan e do Coding Plan, consultada em 03.10.2026
Continue a explorar o Ailoot em [ailoot.ai](https://ailoot.ai/). ## Perguntas frequentes ### O que devo verificar primeiro se uma chave Token Plan devolver 401? Confirme que a chave e o Base URL pertencem ao Token Plan, e não ao Coding Plan ou ao DashScope normal. Copie a chave pelo botão da consola e confirme que o Standard Seat comprado está atribuído. Compare depois as definições guardadas na extensão com essa mesma configuração. ### Um pedido bem-sucedido no terminal prova que a extensão VS Code está configurada? Não. Verifica a chave, o endpoint e o modelo desse pedido. Teste um prompt separadamente no Qwen Code e compare o Base URL e a chave guardados com os do pedido funcional. Verifique também a utilização na subscrição pretendida. ## 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.