Chiave API di Qwen Code: dove crearla, collegarla e calcolare il consumo

Qualcuno installa Qwen Code, lo avvia nel terminale e alla prima richiesta gli viene chiesta una chiave. Inizia così la ricerca: si digita «buy api key for qwen code» e si finisce su pagine in cui viene venduto un abbonamento oppure l’accesso già pronto di qualcun altro. Ecco che cos’è la chiave, dove ottenerla e quanto costa, passo dopo passo.

Partiamo dal punto principale: nessuno vende una chiave API come prodotto confezionato a sé. È una stringa di accesso che si crea autonomamente nell’account del fornitore del modello, ed è gratuito crearla. Servono soldi in seguito, quando si ricarica il saldo; a quel punto si applicano le condizioni del fornitore. Di seguito: dove ottenere una chiave, come collegarla a Qwen Code e quanto costa usarla.

Che cos’è esattamente una chiave API per Qwen Code?#

Qwen Code è un agente AI open source che funziona nel terminale e scrive codice per le tue attività. È gratuito, si installa tramite npm e non include una propria rete neurale. Il lavoro intelligente lo svolge il modello, che gira sui server del fornitore.

Qwen Code ha bisogno di un pass per raggiungere il modello. Quel pass è la chiave API: una lunga stringa simile a una password, che il fornitore crea appositamente per te. Quando l’agente invia una richiesta, allega la chiave; il fornitore la usa per identificare il mittente della richiesta, risponde e detrae il consumo dal tuo saldo.

Ne consegue un punto semplice che chiarisce metà della confusione. La chiave non si compra come prodotto su un marketplace: crei un account presso un fornitore, fai clic su «crea chiave» e ottieni la stringa gratuitamente. La ricerca «buy api key» in realtà significa «dove creo un account e come pago poi il consumo»; qui sotto trovi risposta a entrambe le domande.

In che cosa si differenzia una chiave API da un abbonamento e dal vecchio accesso gratuito?#

Dentro Qwen Code, /auth mostra le scelte di autenticazione supportate dalla versione installata. Scegli la piattaforma che ha emesso la chiave e il relativo piano. Le distinzioni sotto spiegano il vecchio accesso gratuito, Coding Plan e la chiave API standard usata qui; non sono un elenco completo del menu attuale.

La prima opzione è l’accesso gratuito tramite un account Qwen (Qwen OAuth). In passato consentiva di accedere al modello senza chiave, ma è stata interrotta.

La seconda opzione è l’abbonamento Coding Plan di Alibaba ModelStudio. Prevede un costo mensile fisso, una quota settimanale di richieste e un indirizzo di connessione separato.

La terza opzione è la chiave API di un fornitore di modelli. Non c’è un costo fisso: ricarichi il saldo e spendi man mano che lavori, in base al consumo di token. È un’opzione flessibile, adatta se usi l’agente in modo irregolare. Il resto dell’articolo è dedicato a questa modalità.

Dove puoi creare una chiave API per Qwen Code?#

Poiché Qwen Code supporta protocolli diversi, non sei limitato a un solo fornitore di chiavi. La documentazione ufficiale elenca esplicitamente i servizi a cui può collegarsi.

Di seguito è descritta la modalità di connessione diretta.

Per il percorso diretto, apri la console Alibaba Model Studio, seleziona la regione prevista e crea una chiave nella gestione delle chiavi API. Conserva regione e nome del workspace nella configurazione; non copiare la chiave in note condivise.

La guida alle regioni consiglia domini dedicati al workspace per la produzione. Copia l’API Host reale da Workspace Management e segui la guida agli URL di base; non inventare un ID del workspace. Endpoint DashScope condivisi ed endpoint dedicati sono opzioni diverse. Coding Plan e Token Plan usano a loro volta endpoint e chiavi propri. Copia l’URL di base completo compatibile con OpenAI dalla console del workspace nella regione scelta in DASHSCOPE_BASE_URL. Il JSON omette baseUrl; l’indirizzo viene fornito tramite OPENAI_BASE_URL prima dell’avvio. Usa valori reali della console, non un segnaposto del workspace.

C’è anche un’opzione gratuita che non richiede alcuna chiave: esegui un modello Qwen sul tuo computer tramite Ollama e collega Qwen Code come a un server personale. Servono una macchina potente e una configurazione separata. La guida su come avviare Qwen Code nel terminale mostra come eseguire l’agente in locale.

Come si aggiunge la chiave a Qwen Code per farlo funzionare?#

Salva una copia delle impostazioni esistenti e integra la connessione seguente in ~/.qwen/settings.json, senza sovrascrivere altri fornitori o preferenze. La configurazione illustrativa segue l’esempio di autenticazione Qwen Code con l’URL dello spazio di lavoro tramite OPENAI_BASE_URL, la chiave API letta dalla variabile d’ambiente indicata da envKey e senza il blocco env con il segreto in chiaro. qwen3-coder-plus è il modello dell’esempio ufficiale: verificane prima la disponibilità nella regione e nell’account, oppure usa un ID reale della console regionale in entrambi i campi.

Copia l’URL di base completo compatibile con OpenAI dalla console del workspace nella regione scelta in DASHSCOPE_BASE_URL. Il JSON omette baseUrl; l’indirizzo viene fornito tramite OPENAI_BASE_URL prima dell’avvio. Usa valori reali della console, non un segnaposto del workspace.

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "qwen3-coder-plus" }
}

openai sceglie il protocollo compatibile. envKey nomina la variabile letta da Qwen Code, non il valore della chiave. model.name deve corrispondere all’id configurato. Il riferimento ai fornitori documenta questi campi.

Su macOS o Linux, apri un terminale Bash, inserisci la chiave al prompt nascosto e avvia Qwen Code nello stesso terminale:

read -r -p 'Workspace OpenAI-compatible Base URL (copy from regional console): ' DASHSCOPE_BASE_URL
if [[ -z "$DASHSCOPE_BASE_URL" || ! "$DASHSCOPE_BASE_URL" =~ ^https:[/][/] || "$DASHSCOPE_BASE_URL" == *'{'* || "$DASHSCOPE_BASE_URL" == *'}'* ]]; then
  printf '%s\n' 'STOP: supply the real regional workspace Base URL.' >&2
else
  read -r -s -p 'DashScope API key: ' DASHSCOPE_API_KEY
  printf '\n'
  if [[ -n "$DASHSCOPE_API_KEY" ]]; then
    export DASHSCOPE_API_KEY
    export OPENAI_BASE_URL="$DASHSCOPE_BASE_URL"
    qwen
  else
    printf '%s\n' 'STOP: API key is empty.' >&2
  fi
fi

Su Windows usa PowerShell:

$env:DASHSCOPE_BASE_URL = Read-Host 'Workspace OpenAI-compatible Base URL (copy from regional console)'
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_BASE_URL) -or $env:DASHSCOPE_BASE_URL -notmatch '^https:[/][/]' -or $env:DASHSCOPE_BASE_URL -match '[{}]') {
  throw 'Supply the real regional workspace Base URL.'
}
$qwenKey = Read-Host 'DashScope API key' -AsSecureString
$env:DASHSCOPE_API_KEY = [System.Net.NetworkCredential]::new('', $qwenKey).Password
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_API_KEY)) {
  throw 'API key is empty.'
}
$env:OPENAI_BASE_URL = $env:DASHSCOPE_BASE_URL
qwen

Questi comandi tengono il segreto fuori dal JSON e dalla cronologia dei comandi; il processo lo riceve comunque nel proprio ambiente. Non stamparlo, non inserirlo in Git e non incollarlo in un prompt. Adottando questa configurazione, rimuovi una vecchia voce env contenente il segreto. In un nuovo terminale devi fornire di nuovo la variabile.

In Qwen Code usa /doctor per esaminare l’autenticazione e /model per controllare la scelta configurata. In una cartella di prova vuota e innocua, invia: «Rispondi con la parola connected. Non leggere o modificare file e non eseguire comandi.» Una risposta riuscita verifica una richiesta al modello e può generare costi. Un modello elencato in /model conferma soltanto la configurazione locale.

In caso di errore, registra il messaggio senza segreti e l’ID della richiesta se fornito. Controlla l’autenticazione separatamente da disponibilità del modello e fatturazione: verifica piattaforma emittente, regione/workspace, endpoint standard o del piano, ID del modello e saldo/quota nella stessa console. Un 401 può dipendere dall’abbinamento chiave/endpoint o dal piano e non dimostra un guasto del fornitore. Fermati dopo l’errore e correggi la differenza documentata prima di riprovare. L’articolo descrive un esempio basato sulla documentazione, non una richiesta a pagamento eseguita per questa guida.

Quanto costa usare una chiave API e che cosa fa aumentare la spesa?#

La differenza tra una chiave e un abbonamento è che non c’è un importo mensile fisso. Paghi ciò che il modello legge e scrive, misurato in token. Un token è un frammento di testo lungo all’incirca poche lettere. Ogni modello ha il proprio prezzo per milione di token in ingresso e per milione di token in uscita; questi ultimi costano quasi sempre di più.

Un milione di token sembra una quantità enorme, ma lavorando a un progetto grande se ne consumano più in fretta del previsto: a ogni richiesta l’agente legge per intero i tuoi file.

Ecco la conclusione pratica: la spesa dipende dalla quantità di testo elaborata dall’agente. File lunghi, sessioni lunghe e riletture continue del codice consumano il saldo più in fretta; il numero di attività è secondario. Un articolo separato spiega passo dopo passo come si calcola il consumo di token API e perché può esaurirsi senza che te ne accorga.

Perché i pagamenti vengono rifiutati?#

È qui che si commette un errore comune.

L’ostacolo si presenta al passaggio successivo. Hai creato la chiave, ma senza soldi sul saldo non spenderà nulla: il fornitore restituisce un errore di fondi insufficienti.

Se il rifiuto dipende dalla banca che ha emesso la carta, cambiare email, lingua dell’interfaccia o impostazioni del profilo non cambia le condizioni di pagamento. Il meccanismo è spiegato usando come esempio una carta estera per Claude.

Ricorda inoltre che la decisione finale spetta al gateway di pagamento. Può rifiutare il pagamento per motivi propri e non c’è alcuna garanzia che vada a buon fine.

Da dove conviene cominciare?#

Un breve piano passo dopo passo:

1. Identifica piattaforma e piano di fatturazione nelle opzioni di autenticazione del client installato. Il vecchio accesso OAuth gratuito è stato dismesso ad aprile 2026. Questa lista riguarda una chiave Model Studio standard a consumo; gli altri piani e piattaforme hanno percorsi documentati distinti.
2. Crea un account presso un fornitore. L’opzione più semplice è Alibaba direttamente.
3. Crea una chiave nell’account del fornitore, nella sezione delle chiavi di accesso. Crearla è gratuito; non ti serve una carta.
4. Integra la connessione regionale in ~/.qwen/settings.json senza valori segreti. Fornisci DASHSCOPE_API_KEY nel terminale di avvio, poi controlla modello selezionato e una risposta breve come mostrato sopra.
5. Per pagare il consumo, ti serve una carta emessa a tuo nome e accettata dal gateway di pagamento del fornitore. Il gateway stabilisce le condizioni per la ricarica; creare una chiave e pagare il consumo sono passaggi separati.

Vale anche la pena valutare quale modello ti serve. Per le attività più impegnative, scegli il più potente Qwen3-Coder-Plus; per risparmiare, scegli il modello più leggero Flash, che a parità di volume costa diverse volte meno. La guida su Qwen Code come alternativa a Claude Code mostra in che cosa Qwen Code differisce dagli altri agenti per terminale.

Altri materiali sono disponibili su Ailoot.