Kling 4.0 ONLINE — Video incredibilmente reale | Provalo →
Setup agent

Connetti Qwen Code alla WaveSpeed LLM API

Copia il setup ~/.qwen/settings.json consigliato per Qwen Code, instrada le richieste a /v1/chat/completions e verifica le chiamate agent locali in WaveSpeed Logs.

L'agente di programmazione open source di Alibaba per il terminale, con provider personalizzati compatibili con OpenAI.

File di configurazione

~/.qwen/settings.json

Protocollo

Chat completions compatibili con OpenAI

Endpoint

/v1/chat/completions

Configurazione manuale

1

Crea una chiave di accesso WaveSpeed

2

Esporta localmente la chiave richiesta

3

Incolla la configurazione in~/.qwen/settings.json

4

Esegui qwen e controlla Logs

Chat completions compatibili con OpenAI

L’utilizzo appare in Dashboard e Logs

Cambia modello senza riscrivere il codice dell’agent

Configurazione con un solo comando

Configura Qwen Code, verifica che funzioni ed esegue un backup delle impostazioni precedenti. Aggiungi --undo per ripristinarle.

  1. 1

    Installa la CLI di WaveSpeed

    npm install -g @wavespeed/cli
  2. 2

    Accedi

    wavespeed login
  3. 3

    Configura Qwen Code

    wavespeed setup qwen

Non hai Node.js? Vedi le altre opzioni di installazione

Configurazione manuale

Modifica ~/.qwen/settings.json
// File: ~/.qwen/settings.json
{
  "modelProviders": {
    "wavespeed": [
      {
        "id": "deepseek/deepseek-v4.1-flash-1017",
        "name": "deepseek/deepseek-v4.1-flash-1017",
        "envKey": "WAVESPEED_API_KEY",
        "baseUrl": "https://llm.wavespeed.ai/v1"
      }
    ]
  },
  "providerProtocol": { "wavespeed": "openai" },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "deepseek/deepseek-v4.1-flash-1017" }
}

Non sostituire il nome della variabile

WAVESPEED_API_KEY è il nome della variabile d’ambiente letta dall’agent. Mantieni questo nome nel file di configurazione e inserisci la vera API key nella shell.

1

Temporaneo per questo terminale

Funziona finché non chiudi questa finestra del terminale.

export WAVESPEED_API_KEY="wsk_live_..."
2

Mantieni dopo il riavvio

Scrive la key nel profilo shell così i nuovi terminali possono leggerla.

echo 'export WAVESPEED_API_KEY="wsk_live_..."' >> ~/.zshrc
source ~/.zshrc

Guida integrazione agent

Usa Qwen Code con la WaveSpeed LLM API

Questa guida mostra come collegare Qwen Code a WaveSpeed AI con ~/.qwen/settings.json, Chat completions compatibili con OpenAI, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1 e modello predefinito deepseek/deepseek-v4.1-flash-1017. Copia la configurazione sopra, esporta la tua API key, avvia l’agent e verifica le richieste in Logs.

1

Crea una chiave di accesso WaveSpeed

2

Esporta localmente la chiave richiesta

3

Incolla la configurazione in

~/.qwen/settings.json
4

Esegui qwen e controlla Logs

Cosa configura questo setup di Qwen Code

Protocollo

Chat completions compatibili con OpenAI

Endpoint

/v1/chat/completions

Modello

deepseek/deepseek-v4.1-flash-1017

La configurazione pronta da copiare sopra è l’unico file Qwen Code da modificare per il setup consigliato: ~/.qwen/settings.json. Mantieni la API key nell’ambiente shell per non committarla in un repository.

Risoluzione problemi

La API key non viene letta

Esporta WAVESPEED_API_KEY nella stessa shell in cui esegui Qwen Code. Se usi un profilo shell, ricarica il terminale prima di avviare l’agent.

Le richieste falliscono con errore di protocollo o endpoint

Controlla che Qwen Code usi Chat completions compatibili con OpenAI ed endpoint /v1/chat/completions. Le discrepanze di protocollo sono la causa più comune di errori 404 o payload.

Il modello selezionato non funziona

Conferma che l’ID modello esista in WaveSpeed Models, poi incolla l’ID esatto in ~/.qwen/settings.json. Puoi iniziare dal modello predefinito mostrato in questa pagina.

In Logs non appare alcuna richiesta

Assicurati che Qwen Code usi la base URL WaveSpeed e la tua API key attuale. Poi invia un nuovo prompt dall’agent locale e aggiorna Logs.

Questa guida Qwen Code può apparire nei motori di ricerca?

Sì. Questa pagina è costruita come guida di setup indicizzabile per utenti che cercano Qwen Code custom provider, endpoint compatibile OpenAI, base URL e workflow di configurazione agent locale.