Qwen Code

Qwen Code legge gli endpoint da modelProviders in ~/.qwen/settings.json — una voce con baseUrl e envKey mette Claude e GPT nel suo selettore /model.

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

Passo dopo passo

1. Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
2. Apri ~/.qwen/settings.json (crealo se non esiste) e aggiungi i quattro blocchi precedenti. La documentazione consiglia di dichiarare modelProviders nel file a livello utente «per evitare conflitti di unione tra le impostazioni del progetto e quelle utente».
3. Se possibile, conserva la chiave in un posto più sicuro di env. Qwen Code la legge da process.env[envKey] e la documentazione ordina le fonti dalla più prioritaria alla meno prioritaria: una export della shell, poi un file .env, infine il blocco env in settings.json — che viene indicato come archiviazione in testo semplice. Il blocco env qui sopra è la configurazione minima funzionante, non la soluzione migliore da mantenere.
4. Esegui qwen. Con security.auth.selectedType impostato su openai e model.name corrispondente a un id che hai dichiarato, non serve alcun passaggio interattivo di /auth: la documentazione lo afferma chiaramente dopo l’esempio con un solo file.
5. Assegna un’attività che legga e modifichi un file, non un semplice saluto. Qwen Code è un agente: la prima esecuzione dovrebbe verificare le chiamate agli strumenti e lo streaming, che sarebbero i primi a non funzionare con un endpoint solo parzialmente compatibile.
6. Aggiungi altre voci sotto modelProviders.openai per cambiare modello durante l’esecuzione con /model. Le modifiche vengono caricate automaticamente nella sessione in corso; providerProtocol viene letto una sola volta all’avvio e richiede un riavvio.

Verificato rispetto a Pagina di autenticazione di Qwen Code, opzione 4: API Key (flessibile) il 21 settembre 2026. Le impostazioni di terze parti cambiano; se il nome di un campo qui non corrisponde più a quello visualizzato, fa fede quella pagina, non questa.

Verifica prima di eseguire il debug del client

Una sola richiesta stabilisce se il problema riguarda l'endpoint, la chiave o il file di configurazione. Se restituisce JSON, lo stesso base URL e la stessa chiave funzionano in Qwen Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quale model id inserire nel campo

Ogni modello di testo è raggiungibile come model id: l'elenco aggiornato è GET /v1/models e il catalogo con i prezzi è nella pagina dei modelli. Le tariffe sono in USD per 1M di token, input / output.

Tre cose chiarite dalla documentazione che molti presumono erroneamente

Queste informazioni provengono dalla pagina di autenticazione e dal riferimento ai provider di modelli citati sopra. Darle per scontate invece di leggerle fa perdere tempo prezioso nel debugging.

1. Una voce modelProviders ha la precedenza sui flag della CLI. L’ordine documentato, dal più prioritario, è: le modifiche apportate tramite /auth nella sessione in corso, poi envKey del provider di modelli selezionato, quindi gli argomenti della CLI come --openai-api-key, poi le variabili d’ambiente e infine security.auth.apiKey nelle impostazioni. Molti si aspettano che prevalga il flag. Non è così: per questo --openai-base-url può sembrare ignorato.
2. security.auth.apiKey e security.auth.baseUrl sono deprecati. Il riferimento lo specifica e consiglia di migrare a modelProviders. Se una vecchia guida ti fa modificare queste due chiavi, ti sta indirizzando verso un percorso destinato a essere dismesso.
3. wireApi determina il formato della richiesta e non viene rilevata alcuna incompatibilità. Se lo ometti, viene usato Chat Completions, come nel blocco qui sopra. Impostare "wireApi": "responses" richiede un endpoint effettivamente compatibile con Responses; la documentazione dichiara chiaramente che, in caso di errore della richiesta, non viene rilevato l’endpoint né viene eseguito alcun fallback automatico. Kunavo risponde sia a /v1/responses sia a /v1/chat/completions, ma questa pagina non ha testato nessuna delle due combinazioni, quindi inizia con l’impostazione predefinita.

Se sei arrivato qui cercando il piano gratuito

Gran parte delle informazioni ancora disponibili su Qwen Code descrive un accesso OAuth a Qwen con una quota giornaliera gratuita. Questa opzione non è più disponibile: la documentazione registra l’interruzione del piano gratuito il 15 aprile 2026 e afferma che Qwen OAuth non è più selezionabile nella finestra /auth. Ora sono elencate tre opzioni: Alibaba ModelStudio, con Coding Plan, Token Plan e Standard API Key nel sottomenu; Third-party Providers; e Custom Provider, descritto come un modo per connettere «un server locale, un proxy o un provider non supportato». Kunavo è il terzo. Nota inoltre che le voci del sottomenu ModelStudio non sono tre modi per pagare un’unica fattura: ciascuna ha il proprio host e la propria chiave, e una chiave Coding Plan non funziona con un host Token Plan.