Come usare Qwen Code: installazione, /auth, interfaccia giapponese e configurazione API

Qwen Code è un agente di coding AI open source (Apache-2.0) pubblicato dal team Qwen di Alibaba. Il flusso d'uso ha 4 fasi: «installazione → avvio di qwen nel progetto → configurazione della destinazione con /auth → richiesta dell'attività». Tuttavia, poiché il livello gratuito Qwen OAuth è terminato il 15 aprile 2026, accedere come nelle guide precedenti non permette più di usarlo gratuitamente.Questa pagina illustra in ordine come iniziare seguendo l'attuale menu /auth, passare alla visualizzazione giapponese, configurare un provider personalizzato per usare Claude o GPT e usare i comandi più comuni. L'ultima versione è la v0.24.7, pubblicata su npm il 29 settembre 2026; le release arrivano almeno una volta alla settimana, quindi verifica la versione locale con qwen --version.

Installazione

Questa è la procedura del README ufficiale. Con l'installer autonomo non devi predisporre Node.js. Node.js 22 o superiore serve solo se usi 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

Dopo l'installazione, riapri il terminale per applicare le variabili d'ambiente. Qwen Code era originariamente basato su Google Gemini CLI v0.8.2, ma dalla v0.1 ha smesso di sincronizzarsi con upstream e viene sviluppato autonomamente. Le impostazioni e il livello gratuito di Gemini CLI non si applicano automaticamente.

Primo avvio e passaggio al giapponese

cd /path/to/your-project
qwen

# セッション内で：
/language ui ja-JP          # 画面表示を日本語に
/language output Japanese   # モデルの回答を日本語に
/auth                       # 接続先と API キーを設定

Con /language ui ja-JP l'interfaccia diventa giapponese e nelle schermate successive compaiono traduzioni proprie di Qwen Code come «Seleziona un metodo di autenticazione» e «Modalità di approvazione degli strumenti». Questa pagina usa la stessa terminologia. La lingua delle risposte è separata da quella dell'interfaccia e si specifica con /language output Japanese.

Oltre al terminale sono disponibili un'app desktop, una UI Web apribile nel browser (qwen serve --open, funzione sperimentale), integrazioni per VS Code, Zed e JetBrains, nonché l'esecuzione headless per script e CI (qwen -p "..."). Tutto è incluso nello stesso repository gratuito; il costo d'inferenza è separato.

Scegliere la destinazione con /auth

Aprendo /auth (detto anche /login) compare la schermata «Seleziona un metodo di autenticazione» con tre opzioni di primo livello. Se provi a scegliere Qwen OAuth, compare «Terminato — passa a Coding Plan o API Key».

I tre percorsi ModelStudio non sono semplicemente modi diversi di pagare la stessa fattura. La documentazione assegna a ciascuno un endpoint e una chiave diversi; non funzionano se il tipo di chiave non corrisponde a baseUrl. Al 1° ottobre 2026, per il Coding Plan compare «quantità limitata, in ordine di arrivo; rifornimento ogni giorno alle 00:00 (UTC+8)», quindi alcuni giorni è possibile iscriversi e altri no. Secondo Alibaba, una richiesta del Coding Plan diventa internamente più chiamate al modello e consuma da 5 a 10 chiamate per attività semplici e da 10 a 30 chiamate o più per attività complesse. Il confronto dei prezzi è trattato in dettaglio nella versione inglese di Qwen Code pricing.

Usare Claude o GPT: configurare Custom Provider in settings.json

La documentazione di autenticazione di Qwen Code raccomanda ~/.qwen/settings.json di modelProviders per collegarsi a OpenAI, Anthropic, Google, OpenRouter, endpoint propri e altri servizi di terze parti. 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

Ci sono quattro punti da tenere presenti.

• baseUrl è fino a /v1.Il riferimento del provider del modello specifica: «indicare la /v1 di API, non /v1/chat/completions. Il percorso della richiesta viene aggiunto dall'SDK». Se si include anche il percorso, si ottiene un 404 anziché un errore di autenticazione.
• Dove memorizzare la chiave. Qwen Code legge la chiave dall'ambiente usando il nome della variabile specificato in envKey. L'ordine di priorità è il comando export della shell, .env (.qwen/.env consigliato; viene usato solo il primo file trovato), quindi env in settings.json; quest'ultima opzione memorizza la chiave in chiaro, quindi è sconsigliata.
• Il file di configurazione prevale sui flag della CLI. L'ordine di risoluzione è: valore inserito in /auth → modelProviders selezionato → argomenti della CLI → variabili d'ambiente → settings.json. È per questo che --openai-base-url può sembrare ignorato. security.auth.apiKey e security.auth.baseUrl delle spiegazioni precedenti sono deprecati.
• Inizia con Chat Completions. Se ometti wireApi, viene usato il formato Chat Completions. Con "responses" non sono disponibili né il rilevamento automatico dell'endpoint né il fallback. Le modifiche a modelProviders si riflettono immediatamente anche nelle sessioni già avviate (riaprendo /model diventano visibili).

Il catalogo di Kunavo non include modelli testuali Qwen. Non è un modo economico per usare Qwen, ma un modo per usare Claude o GPT in Qwen Code con un unico saldo prepagato. Inoltre, Kunavo non ha verificato Qwen Code in esecuzione effettiva contro un proprio endpoint. La configurazione è stata creata a partire dalla documentazione ufficiale, come nella pagina di configurazione di Qwen Code in inglese. Provala mantenendo attivo il percorso attualmente funzionante.

Primo compito e comandi usati più spesso

Come nell'esempio del README, inizia con una richiesta del tipo «spiega questo repository e dimmi da dove iniziare a leggerlo» per verificare che lettura dei file e chiamate agli strumenti funzionino correttamente. Un semplice saluto non permette di individuare i problemi di connessione.

Le modalità di approvazione automatica come yolo sono accompagnate dall'avvertenza della documentazione: «usarle solo in ambienti affidabili, sottoposti a sandbox o usa e getta». Il costo stimato di /stats model è calcolato da Qwen Code e non corrisponde all'importo fatturato. Verifica l'importo effettivo nei dati di utilizzo della destinazione della connessione.

Limitazioni da conoscere

• La ricerca web_search integrata dipende dalla destinazione della connessione. Poiché usa la ricerca lato server di DashScope, è abilitata con una Standard API Key e un Token Plan di ModelStudio e con un endpoint che punti a un host DashScope riconosciuto; è disabilitata con Coding Plan (perché non è stata verificata su quell'endpoint) e con endpoint personalizzati di terze parti o di altri host (documentazione di web_search). Se necessario, aggiungi un server di ricerca MCP.
• Il percorso di 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, indipendentemente dalla destinazione del modello di chat, resta necessaria un'altra chiave.

Pagamenti per provare 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), Apple Pay, Google Pay e Link. Consulta le istruzioni sulla fatturazione, quindi crea un account e genera una chiave. Dopo la prima richiesta, il modo più affidabile per verificare l’importo effettivamente addebitato è consultare lo storico di utilizzo.

Domande frequenti

Verificato il 1° ottobre 2026: README di Qwen Code; documentazione di autenticazione, provider del modello, comandi e web_search (branch main); stringhe dell'interfaccia giapponese (packages/cli/src/i18n/locales/ja.js); @qwen-code/qwen-code 0.24.7 su npm; pagine Alibaba Cloud di Coding Plan e Token Plan. Kunavo non ha eseguito Qwen Code contro un proprio endpoint.