Come usare Qwen Code: installazione, scelta dell'account e del modello, configurazione API

Qwen Code è un agente di coding AI open source (Apache-2.0) pubblicato dal team Alibaba Qwen. Il suo utilizzo si articola in quattro fasi: “installazione → esecuzione di qwen nel progetto → configurazione della destinazione di connessione con /auth → richiesta di un'attività”. Tuttavia, poiché il livello gratuito Qwen OAuth è terminato il 15 aprile 2026, l'accesso eseguito seguendo le istruzioni precedenti non funziona più gratuitamente. E un punto che gli utenti coreani devono sapere subito: Qwen Code non dispone di un'interfaccia utente in coreano. Questa pagina spiega in sequenza come iniziare in base al menu /auth attuale, configurare le risposte in coreano, usare Claude e GPT con una configurazione personalizzata e utilizzare i comandi più comuni. La versione più recente è la v0.24.7 pubblicata su npm il 29 settembre 2026 e vengono rilasciate versioni almeno settimanalmente; verifica la versione installata con qwen --version.

Installazione

È il comando del README ufficiale. Con lo script di installazione autonoma non è necessario preparare Node.js direttamente; Node.js 22 o versione successiva serve solo per l'installazione tramite npm.

# macOS / Linux (공식 단독 설치 스크립트)
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

# Windows (PowerShell)
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

# npm (Node.js 22 이상 필요)
npm install -g @qwen-code/qwen-code@latest

# Homebrew (macOS / Linux)
brew install qwen-code

Riapri il terminale dopo l'installazione affinché le variabili d'ambiente vengano applicate. Qwen Code era originariamente basato su Google Gemini CLI v0.8.2, ma dalla v0.1 viene sviluppato autonomamente senza sincronizzarsi con l'originale. Le impostazioni o le quote gratuite di Gemini CLI non si applicano automaticamente.

Prima esecuzione e risposte in coreano

cd /path/to/your-project
qwen

# 세션 안에서:
/language output Korean   # 모델 답변을 한국어로 (UI는 한국어 미지원)
/auth                     # 공급자와 API 키 설정

Le lingue UI integrate sono solo cinese semplificato, inglese, russo, tedesco, giapponese, portoghese brasiliano, francese e catalano, e nei file di traduzione UI del repository non è presente il coreano (verificato il 1° ottobre 2026). I menu vengono quindi visualizzati in inglese e questa pagina cita alla lettera le frasi inglesi mostrate sullo schermo. La lingua delle risposte del modello è separata da quella dell'interfaccia e può essere impostata in coreano con /language output Korean.

Oltre al terminale, sono disponibili un'app desktop, una UI web accessibile dal browser (qwen serve --open, funzionalità sperimentale), integrazioni per VS Code, Zed e JetBrains, nonché un'esecuzione headless per script e CI (qwen -p "..."). Tutto è incluso nello stesso repository gratuito, mentre i costi di inferenza sono separati.

Scegliere la destinazione con /auth

Aprendo /auth(alias /login) viene mostrata la schermata “Select authentication method:” e le opzioni di primo livello sono tre. Se provi a scegliere Qwen OAuth, compare il messaggio “Discontinued — switch to Coding Plan or API Key”.

Le tre opzioni di ModelStudio non sono tre metodi che producono la stessa fattura. La documentazione assegna a ciascuna un endpoint e una chiave separati; se il tipo di chiave e baseUrl non corrispondono, il servizio non funziona. Al 1° ottobre 2026, il Coding Plan è indicato come “quantità limitata, in ordine di arrivo, rifornita ogni giorno alle 00:00 (UTC+8)”, quindi l'iscrizione potrebbe non essere disponibile a seconda del giorno. Nel Coding Plan, una singola attività viene calcolata come più chiamate al modello; Alibaba spiega che in genere si tratta di 5–10 chiamate per attività semplici e di 10–30 chiamate o più per quelle complesse. Il confronto delle tariffe è trattato in dettaglio nella pagina inglese Qwen Code pricing.

Usare Claude o GPT: Custom Provider in settings.json

La documentazione sull'autenticazione di Qwen Code raccomanda ~/.qwen/settings.json modelProviders per collegarsi a servizi di terze parti come OpenAI, Anthropic, Google, OpenRouter ed endpoint propri. Per Kunavo, la configurazione è la seguente.

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI 호환",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

# 키는 settings.json에 직접 쓰지 말고 .qwen/.env 나 환경 변수로
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

Quattro accorgimenti per risparmiare tempo nel debugging:

• baseUrl fino a /v1. La documentazione di riferimento del provider del modello specifica di “indicare la radice /v1/chat/completions dell'API, non il percorso completo di /v1; l'SDK aggiunge il percorso della richiesta”. Se includi il percorso, otterrai 404, non un errore di autenticazione.
• Dove mettere la chiave. Qwen Code legge la chiave dalla variabile d'ambiente con il nome indicato in envKey. La priorità è: shell export, file .env(è consigliato .qwen/.env, viene usato solo il primo file trovato), settings.json con env; quest'ultimo non è consigliato perché salva il valore in chiaro.
• Il file di configurazione prevale sui flag CLI. L'ordine di determinazione è: valore inserito in /auth → voce modelProviders selezionata → argomenti CLI → variabili d'ambiente → settings.json. Ecco perché --openai-base-url sembra venire ignorato. security.auth.apiKey e security.auth.baseUrl menzionati nelle spiegazioni precedenti sono destinati a essere dismessi.
• All'inizio usa Chat Completions. Se ometti wireApi, viene usato il formato Chat Completions. Se passi a "responses", non sono disponibili né il rilevamento automatico dell'endpoint né il passaggio automatico a un'alternativa in caso di errore. Le modifiche a modelProviders si applicano immediatamente anche alle sessioni in esecuzione (sono visibili riaprendo /model).

Il catalogo Kunavo non include modelli testuali Qwen. Non è un modo economico per usare Qwen, ma un modo per usare Claude e GPT all'interno di Qwen Code con un unico saldo prepagato. Inoltre, Kunavo non ha verificato l'esecuzione effettiva di Qwen Code sul proprio endpoint. La configurazione è stata redatta consultando la documentazione ufficiale, come nella pagina inglese Qwen Code settings. Provala lasciando disponibile il percorso che usi attualmente.

Prima attività e comandi più usati

La prima richiesta mostrata come esempio nel README è qualcosa come “Spiega questo repository e dimmi da dove iniziare”. In questo modo puoi verificare in una volta sola la lettura dei file e le chiamate agli strumenti. Un semplice saluto non consente di individuare i problemi di connessione.

Le modalità di approvazione automatica come yolo sono accompagnate dalla stessa avvertenza nella documentazione: usale solo in ambienti attendibili, sandbox o sacrificabili. Il costo stimato di /stats model è un calcolo di Qwen Code, non l'importo addebitato. Verifica l'importo effettivo nella cronologia di utilizzo del provider collegato.

Limitazioni da conoscere

• web_search integrato viene attivato o disattivato in base alla destinazione di connessione. Poiché usa la ricerca lato server di DashScope, è attivo per le voci che usano una ModelStudio Standard API Key e Token Plan e indicano un host DashScope riconosciuto; è disattivato nel Coding Plan (non verificato su quell'endpoint) e anche negli endpoint personalizzati di terze parti o di altri host (documentazione di web_search). Se necessario, collega un server di ricerca MCP.
• Il percorso Kunavo è solo per la chat. Kunavo non dispone di modelli per embedding, sintesi vocale o riconoscimento vocale. Live Voice di Qwen Code richiede un endpoint DashScope, quindi usa la stessa chiave separata indipendentemente da dove indirizzi il modello di chat.

Pagamenti durante i test con Kunavo

Kunavo utilizza ricariche prepagate senza canone mensile e detrae il consumo dal saldo in base ai token. La ricarica minima è $10; nel checkout Stripe sono accettate carte (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay e Link. Se il checkout viene visualizzato in won, puoi scegliere anche Kakao Pay, Naver Pay, PAYCO, Samsung Pay e carte nazionali senza pagamenti internazionali abilitati (la conversione in won include la commissione di cambio Stripe del 2–4%, evitabile pagando in dollari). Toss Pay non è disponibile. Consulta le istruzioni sui pagamenti e crea un account per generare una chiave. Dopo la prima richiesta, verifica l’importo effettivo nello storico di utilizzo.

Domande frequenti

Verificato il 1° ottobre 2026: README di Qwen Code, documentazione sull'autenticazione, sui provider dei modelli, sui comandi e su web_search (branch main), elenco dei file di traduzione UI del repository, @qwen-code/qwen-code 0.24.7 su npm, pagine Alibaba Cloud del Coding Plan e del Token Plan. Kunavo non ha eseguito Qwen Code sul proprio endpoint.