Configurare Qwen Code: installazione, provider, interfaccia tedesca e API

Qwen Code è l'agente di coding AI open source (Apache-2.0) del team Qwen di Alibaba. La configurazione richiede quattro passaggi: installarlo, avviarlo nel progetto con qwen, scegliere il provider con /auth e assegnare un'attività. Informazione importante: la quota gratuita Qwen OAuth è terminata il 15 aprile 2026 — chi segue una guida precedente non può più proseguire gratuitamente in questo modo. Questa pagina segue il menu /auth attuale, mostra come passare al tedesco, configurare un endpoint personale per Claude o GPT e usare i comandi principali. L'ultima versione è la v0.24.7, pubblicata su npm il 29 settembre 2026; le release arrivano almeno settimanalmente: verifica la tua versione con qwen --version.

Installazione

I comandi provengono dal README ufficiale. Con l'installer standalone non devi installare Node.js separatamente; solo per npm Node.js 22 o versione successiva è obbligatorio.

# macOS / Linux (offizieller Standalone-Installer)
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 (benötigt Node.js 22 oder neuer)
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 abbiano effetto. Qwen Code era originariamente basato su Google Gemini CLI v0.8.2, ma dalla v0.1 è sviluppato indipendentemente e non è più sincronizzato con l'originale. Le impostazioni e le quote di Gemini CLI non si applicano qui.

Primo avvio e interfaccia in tedesco

cd /pfad/zu/ihrem-projekt
qwen

# in der Sitzung:
/language ui de-DE        # Oberfläche auf Deutsch
/language output German   # Antworten des Modells auf Deutsch
/auth                     # Anbieter und API-Key einrichten

Dopo /language ui de-DE, Qwen Code mostra le proprie denominazioni tedesche, ad esempio „Authentifizierungsmethode auswählen“ o „Werkzeug-Genehmigungsmodus“; questa pagina usa gli stessi termini. La lingua delle risposte è separata e viene impostata con /language output German.

Oltre al terminale sono disponibili un'app desktop, un'interfaccia web nel browser (qwen serve --open, sperimentale), integrazioni per VS Code, Zed e JetBrains e la modalità headless per script e CI (qwen -p "..."). Tutto si trova nello stesso repository gratuito; l'inferenza viene pagata separatamente.

Scegliere il provider con /auth

/auth (alias /login) apre „Authentifizierungsmethode auswählen“ con tre opzioni di primo livello. Chi vuole ancora scegliere Qwen OAuth vede: „Eingestellt — wechseln Sie zu Coding Plan oder API Key“.

I tre percorsi ModelStudio non sono tre metodi di pagamento della stessa fattura: la documentazione assegna a ciascuno un endpoint e una chiave distinti, e il tipo di chiave e baseUrl devono corrispondere. Il Coding Plan il 1° ottobre 2026 risultava „begrenzt verfügbar, wer zuerst kommt, täglich um 0 Uhr (UTC+8) aufgefüllt“ — quindi potrebbe non essere acquistabile in un determinato giorno. Un'attività consuma più chiamate al modello nel Coding Plan; Alibaba indica tipicamente 5–10 per le attività semplici e 10–30 o più per quelle complesse. Il confronto dei costi è trattato in dettaglio nella pagina inglese Qwen Code pricing.

Usare Claude o GPT: Custom Provider in settings.json

La documentazione sull'autenticazione consiglia per provider di terze parti come OpenAI, Anthropic, Google, OpenRouter o un endpoint personale il blocco modelProviders in ~/.qwen/settings.json. Per Kunavo è configurato così:

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

# Den Key nicht in settings.json schreiben, sondern in .qwen/.env oder die Umgebung
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

Quattro punti che fanno risparmiare tempo nella risoluzione dei problemi:

• baseUrl termina con /v1. La Referenza ai Model Provider afferma esplicitamente di impostare la /v1 radice dell'API, non /v1/chat/completions — il percorso viene aggiunto automaticamente dall'SDK. Con il percorso viene restituito un 404, non un errore di autenticazione.
• Dove si trova la chiave. Qwen Code la legge dalla variabile d'ambiente indicata da envKey. Ordine di precedenza: export della shell, poi un file .env (consigliato .qwen/.env; conta solo il primo file trovato), infine env in settings.json — lì la chiave è memorizzata in chiaro.
• Il file prevale sull'opzione CLI. Ordine: valori da /auth → voce modelProviders selezionata → argomenti CLI → variabili d'ambiente → settings.json. Per questo --openai-base-url a volte sembra non avere effetto. security.auth.apiKey e security.auth.baseUrl delle guide precedenti sono obsoleti.
• Inizia con Chat Completions. Senza wireApi viene usato Chat Completions. Con "responses" non sono disponibili né il rilevamento dell'endpoint né il fallback automatico. Le modifiche a modelProviders hanno effetto anche durante una sessione in corso (/model per riaprirla).

Nel catalogo Kunavo non esiste un modello testuale Qwen. Non è quindi un modo più economico per usare Qwen, ma un modo per usare Claude o GPT in Qwen Code tramite un saldo prepagato. Kunavo non ha eseguito Qwen Code personalmente contro il proprio endpoint; come la pagina inglese di configurazione di Qwen Code, la configurazione proviene dalla documentazione ufficiale. Mantieni una route funzionante mentre lo provi.

Prima attività e comandi importanti

Il README suggerisce come prima attività, in sintesi: „Spiega questo repository e mostrami da dove iniziare.“ In questo modo vengono verificati contemporaneamente l'accesso ai file e le chiamate agli strumenti — un semplice „Ciao“ non rivela i problemi di connessione.

Per yolo e le altre modalità automatiche, la documentazione stessa avverte di usarle solo in ambienti affidabili, isolati o usa e getta. I costi stimati in /stats model vengono calcolati da Qwen Code; l'importo effettivo è riportato nel registro di utilizzo del provider.

Limiti da conoscere

• La ricerca web integrata dipende dall'host. Usa la ricerca lato server di DashScope: è attiva per ModelStudio Standard API Key e Token Plan e per le voci su un host DashScope riconosciuto, disattivata per il Coding Plan (non verificata in quel caso) e disattivata per provider di terze parti ed endpoint personali su altri host (documentazione di web_search). Alternativa: un server di ricerca MCP.
• Con Kunavo è disponibile solo la chat. Kunavo non offre modelli di embedding, sintesi vocale o riconoscimento vocale. La Live Voice di Qwen Code richiede comunque un endpoint DashScope e continua a usare la propria chiave, indipendentemente da dove punti il modello di chat.

Pagare quando provi Kunavo

Kunavo funziona con un saldo prepagato senza abbonamento e fattura per token. La ricarica minima è di $10; nel checkout Stripe sono disponibili carte (Visa, Mastercard, American Express), Apple Pay, Google Pay e Link, e in Austria anche EPS — l'addebito diretto SEPA non è attualmente disponibile. Stripe offre Pay by Bank solo agli acquirenti nel Regno Unito, in Irlanda e Finlandia; in Germania è finora disponibile solo come anteprima chiusa (documentazione Stripe, aggiornata al 3 ottobre 2026). Dettagli in Fatturazione; con un account puoi creare la chiave. Dopo la prima attività, il registro di utilizzo mostra l'importo effettivo.

Domande frequenti

Verificato il 1° ottobre 2026: README di Qwen Code, documentazione relativa ad autenticazione, Model Providers, comandi e web_search (branch main), testi dell'interfaccia tedesca (packages/cli/src/i18n/locales/de.js), @qwen-code/qwen-code 0.24.7 su npm e pagine di Alibaba Cloud relative a Coding Plan e Token Plan. Kunavo non ha eseguito Qwen Code contro il proprio endpoint.