Qwen Code e Qwen 3.7-max: configurar o Token Plan

Documentação de referência do Ailoot: 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?#

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».

Quanto custa e que plano deve escolher?#

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).

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?#

Verifique a versão do Node.js antes de instalar:

node --version

Precisa da versão 22 ou posterior. Se tiver uma versão mais antiga, atualize-a através de nodejs.org ou com o nvm:

nvm install 22
nvm use 22

Em seguida, instale o Qwen Code com um comando:

npm install -g @qwen-code/qwen-code@latest

Ou utilize o Homebrew no macOS:

brew install qwen-code

Confirme a instalação:

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?#

Passo a passo:

1. Aceda a 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?#

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?#

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:

{
  "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?#

O autor descreveu os erros que encontrou durante a configuração. Eis a lista completa das causas dos erros 401 e como as verificar:

Verificação rápida da chave através do terminal:

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?#

Eis os modelos realmente úteis para vibe coding:

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?#

A análise descreve um mês de trabalho do autor com ambas as ferramentas. Eis uma comparação baseada nessa experiência:

| 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
• 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 e Codex vs Claude Code.

Três problemas com que toda a gente se depara#

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?#

Passo 1. Verifique a chave através do terminal:

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?#

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.

Continue a explorar o Ailoot em ailoot.ai.