Qwen Code e Qwen 3.7-max: configurare Token Plan

Documentazione di riferimento Ailoot: ailoot.ai/docs/.

Aggiornato il 03.10.2026: dalla pubblicazione sono cambiate tre cose. Alibaba ha chiuso Coding Plan ai nuovi acquisti: il livello Lite è tornato a marzo, mentre Pro è esaurito. Token Plan è passato da una quota settimanale a una mensile. È stato rilasciato un modello più recente, Qwen3.8-max. Ho anche corretto un errore nella descrizione della chiave Token Plan: è importante proprio per quell’errore 401, e lo spiego qui sotto.

Che cos’è Qwen Code e perché non è solo un altro clone?#

Quando ho sentito parlare per la prima volta di Qwen Code, ho pensato: «un altro clone di Claude Code che si romperà al secondo prompt». Mi sbagliavo. Alibaba non ha copiato l’interfaccia: ha creato da zero il proprio agente CLI, ma con piena compatibilità con l’API OpenAI. Questo significa che al suo interno puoi usare non solo i modelli Qwen, ma anche DeepSeek, GLM, Kimi e persino Claude tramite l’API Anthropic.

Ecco cosa può fare concretamente:

• Legge la struttura del progetto e ne comprende il contesto (come Claude Code con CLAUDE.md)
• Esegue comandi shell, modifica file e crea commit
• Supporta Skills e SubAgents
• Funziona in VS Code tramite il terminale integrato o un’estensione
• Passa da un modello all’altro con un solo comando /model

C’è un inconveniente, ma è cruciale: il livello gratuito è stato chiuso il 15 aprile 2026. In precedenza, Qwen OAuth offriva 100 richieste gratuite al giorno; ora restano solo le opzioni a pagamento. Ma anche a pagamento Qwen Code costa sensibilmente meno di un abbonamento Claude Pro. Se stai scegliendo tra gli strumenti in questo momento, ho trattato tutte le opzioni nella guida «Con cosa programmare nel 2026: 8 strumenti AI».

Quanto costa e quale piano scegliere?#

La confusione sui piani è il principale grattacapo durante la configurazione di Qwen Code. Alibaba usa nomi diversi in parti diverse della console e persino l’estensione di VS Code mostra le opzioni sbagliate. Ecco come funziona davvero (verificato sulla documentazione di Alibaba Cloud, aggiornata lì il 28.09.2026).

Nell’esperienza descritta dall’autore, è stato scelto Token Plan perché un solo abbonamento dà accesso a Qwen 3.7-max (e al più recente Qwen3.8-max), DeepSeek V4 Pro e GLM-5. Tutti i modelli attingono allo stesso pool di Credits. Passa da uno all’altro con il comando /model: non devi acquistare una chiave separata per ogni provider.

Importante: Coding Plan e Token Plan sono prodotti diversi con indirizzi API diversi. Una chiave Coding Plan ha il prefisso sk-sp-. Una chiave Token Plan non ha alcun prefisso: è così che la descrive la documentazione ufficiale di Qwen Code. Se confondi l’indirizzo o la chiave tra i prodotti, riceverai un errore 401. E poiché Coding Plan è chiuso ai nuovi acquisti, Token Plan è attualmente l’unica opzione funzionante per la maggior parte dei lettori.

Come si installa Qwen Code?#

Controlla la versione di Node.js prima di installare:

node --version

Serve la versione 22 o successiva. Se hai una versione precedente, aggiorna tramite nodejs.org o con nvm:

nvm install 22
nvm use 22

Poi installa Qwen Code con un solo comando:

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

Oppure usa Homebrew su macOS:

brew install qwen-code

Verifica l’installazione:

qwen --version

Se viene visualizzata una versione, sei pronto. Avvia Qwen Code con il comando qwen nel terminale. In VS Code, apri il terminale integrato (Ctrl+) e digita qwen`.

C’è anche un’estensione per VS Code: Qwen Code Companion di QwenLM nel marketplace. Aggiunge una barra laterale per la chat, come GitHub Copilot. Io uso quella: è più comoda del semplice terminale.

Come si crea un account e si acquista Token Plan?#

Passo dopo passo:

1. Vai su modelstudio.console.alibabacloud.com
2. Fai clic su Free Sign Up in alto a destra
3. Inserisci la tua email (Gmail funziona) e conferma il codice ricevuto nella posta in arrivo
4. Aggiungi il tuo numero di telefono
5. Aggiungi una carta accettata dal provider. Alibaba addebiterà $1 per verificarla e lo rimborserà in 1–3 giorni.
6. Nella console, trova la sezione ModelStudio e la scheda Token Plan
7. Scegli il livello Standard (il minimo per iniziare)
8. Conferma il pagamento

Dopo l’acquisto, arriverai alla pagina My Subscriptions. Lì vedrai:

• Standard Seat: 0/1: significa che hai acquistato una seat, ma non l’hai ancora assegnata a te stesso
• Fai clic su Assign, seleziona il tuo account e conferma
• Dovrebbe passare a 1/1

La chiave API non funzionerà se non esegui questo passaggio. Nell’esperienza descritta dall’autore, questo passaggio è costato 20 minuti.

Dove si trovano la chiave API e l’indirizzo corretto?#

Nella pagina My Subscriptions, fai clic sul grande pulsante viola Go to Management Platform. Si aprirà un pannello separato.

Seleziona Overview nel menu a sinistra. In questa pagina vedrai due sezioni:

Plan-specific API Key: la tua chiave personale. È mascherata con asterischi. Fai clic sull’icona di copia accanto (non selezionarla con il mouse: verranno copiati gli asterischi). Le chiavi Token Plan non hanno prefisso. Non è un refuso nelle istruzioni: la documentazione ufficiale di Qwen Code le descrive così. Se vedi sk-sp-, è una chiave Coding Plan di un altro prodotto: hai copiato quella sbagliata.

Plan-specific Base URL: due opzioni:

• Per gli strumenti compatibili con OpenAI (Qwen Code): https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
• Per gli strumenti compatibili con Anthropic: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

Ricorda: solo questi indirizzi funzionano con una chiave Token Plan. L’indirizzo standard dashscope-intl.aliyuncs.com è per le chiavi normali (pagamento a consumo), mentre coding-intl.dashscope.aliyuncs.com è l’indirizzo Coding Plan. Se usi una chiave Token Plan con uno dei due, riceverai un errore 401.

Come si collega a VS Code?#

Se hai installato l’estensione Qwen Code Companion dal marketplace di VS Code:

1. Apri la palette dei comandi (Cmd+Shift+P)
2. Digita Qwen Code: Choose Provider
3. Se vedi un menu di opzioni, non scegliere Coding Plan (è un prodotto diverso). Scegli Standard API Key
4. Incolla la chiave dalla Management Platform: le chiavi Token Plan non hanno un prefisso fisso
5. Regione: Singapore
6. Modello: qwen3.7-max

Se dopo questa procedura compare un errore, configuralo manualmente tramite il file. A volte l’estensione inserisce l’indirizzo sbagliato.

Apri o crea il file ~/.qwen/settings.json e incolla:

{
  "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" }
}

Sostituisci YOUR-KEY-FROM-MANAGEMENT-PLATFORM con la tua chiave dalla Management Platform. Riavvia VS Code. Fatto.

Perché compare un errore 401 e come si risolve?#

L’autore ha descritto gli errori incontrati durante la configurazione. Ecco l’elenco completo delle cause degli errori 401 e come verificarle:

Controllo rapido della chiave dal terminale:

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 restituisce 200, la chiave funziona e il problema è nelle impostazioni dell’estensione. Se restituisce 401, la chiave o l’indirizzo sono sbagliati.

Quali modelli sono disponibili e quale scegliere?#

Ecco i modelli davvero utili per il vibe coding:

Passa da un modello all’altro con il comando /model direttamente nella sessione Qwen Code: non serve modificare le impostazioni né riavviare.

Inizierei con qwen3.6-plus. Se dopo una settimana ti sembra che la quota si esaurisca troppo in fretta, passa a qwen3.6-flash per le attività di routine e riserva qwen3.7-max solo ai compiti complessi.

Qwen Code o Claude Code: quale dovresti usare?#

La recensione descrive un mese di lavoro dell’autore con entrambi gli strumenti. Ecco un confronto basato su quell’esperienza:

| Estensione VS Code | Nativa, stabile | Disponibile, ma ancora grezza: a volte ha problemi con le chiavi |

Quando Qwen Code conviene di più:

• Ti serve accesso a diversi modelli (DeepSeek per la matematica, Kimi per il contesto lungo)
• Stai sperimentando approcci diversi allo stesso compito
• Hai un budget limitato, ma programmi ogni giorno
• Vuoi uno strumento open source che puoi personalizzare

Quando Claude Code è indispensabile:

• Un progetto critico in cui la qualità del codice equivale a denaro
• Lavoro con un grande progetto legacy (Opus mantiene meglio il contesto): ho trattato separatamente come non esaurire i limiti di Claude Code
• Ti serve un’estensione VS Code stabile, senza configurazione manuale

La combinazione nell’esperienza descritta dall’autore: Claude Code per il progetto principale, Qwen Code per esperimenti e attività parallele, dove puoi provare rapidamente un’idea con un modello meno costoso. Per un confronto dettagliato con altri strumenti, consulta Cursor vs Claude Code e Codex vs Claude Code.

Tre insidie in cui incappano tutti#

Insidia 1: Token Plan ≠ Coding Plan

Alibaba chiama questi prodotti in modo diverso nelle varie parti della console. L’opzione «Coding Plan» nell’estensione VS Code non è Token Plan. Ricorda: dal 20.03.2026 Coding Plan Lite non accetta più nuovi acquisti e Pro è esaurito; se non lo hai già, puoi scegliere solo Token Plan. Hanno indirizzi API diversi:

• Token Plan: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
• Coding Plan: https://coding-intl.dashscope.aliyuncs.com/v1

Se hai acquistato Token Plan ma configurato l’estensione come Coding Plan, riceverai un errore 401. E viceversa.

Insidia 2: l’estensione VS Code genera una propria chiave

Quando completi la configurazione dall’interfaccia grafica dell’estensione (Cmd+Shift+P - Qwen Code: Choose Provider), a volte l’estensione genera una propria chiave tramite l’API Alibaba Auth. Questa chiave ha un formato diverso e non è collegata al tuo abbonamento Token Plan.

Soluzione: dopo aver completato la configurazione dall’interfaccia grafica, apri ~/.qwen/settings.json e assicurati che la chiave in env corrisponda a quella mostrata nella Management Platform (Overview - Plan-specific API Key). Se non corrisponde, sostituiscila manualmente.

Insidia 3: la Standard Seat non è stata assegnata

Dopo aver acquistato Token Plan, nella pagina My Subscriptions vedrai Standard Seat: 0/1. Significa che la seat è stata acquistata, ma non è collegata al tuo account. La chiave API non funzionerà finché non farai clic su Assign.

Nell’esperienza dell’autore, il debug dell’errore 401 è durato 20 minuti prima che si notasse questa riga.

Come si verifica che tutto funzioni?#

Passaggio 1. Controlla la chiave dal terminale:

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 la risposta contiene testo generato dal modello, la chiave e l’indirizzo funzionano.

Passaggio 2. Verifica in Qwen Code:

Apri VS Code, poi il terminale integrato e digita qwen. Se si avvia, scrivi qualcosa:

Che cos’è questo progetto in questa cartella?

Qwen Code leggerà la struttura e risponderà. Se lo fa, la configurazione è completa.

Passaggio 3. Controlla il consumo di Credits:

Cinque minuti dopo le prime richieste, vai su Management Platform - Overview - Usage Consumption. La percentuale dovrebbe essere diversa da zero. Se è allo 0% dopo oltre 10 richieste, stai usando l’indirizzo sbagliato (le richieste escono dall’abbonamento, vanno al pagamento a consumo o non arrivano da nessuna parte).

E adesso?#

Hai installato Qwen Code e funziona. Puoi aprire qualsiasi progetto e iniziare a svilupparlo dialogando con l’AI.

La domanda successiva è: perché lo stesso prompt in Qwen Code produce un ottimo risultato in un progetto e spazzatura in un altro? Dipende dal contesto. Se il progetto contiene una struttura business/ con il pubblico, i prodotti e gli obiettivi, l’AI lavora come un partner. Se la cartella è vuota, ha le allucinazioni.

Continua a esplorare Ailoot su ailoot.ai.