Qwen Code

Qwen Code lit ses endpoints dans modelProviders de ~/.qwen/settings.json — une entrée avec un baseUrl et un envKey place Claude et GPT dans son sélecteur /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"
  }
}

Étape par étape

1. Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
2. Ouvrez ~/.qwen/settings.json (créez-le s’il n’existe pas) et ajoutez-y les quatre blocs ci-dessus. La documentation recommande de déclarer modelProviders dans le fichier utilisateur « afin d’éviter les conflits de fusion entre les paramètres du projet et ceux de l’utilisateur ».
3. Si possible, placez la clé dans un emplacement plus sûr que env. Qwen Code la lit depuis process.env[envKey], et la documentation classe les sources de la plus prioritaire à la moins prioritaire : une export du shell, puis un fichier .env, puis le bloc env dans settings.json — qu’elle signale comme un stockage en texte brut. Le bloc env ci-dessus est le minimum pour que cela fonctionne, pas la meilleure solution à conserver.
4. Exécutez qwen. Avec security.auth.selectedType défini sur openai et model.name correspondant à un id que vous avez déclaré, aucune étape interactive /auth n’est nécessaire — la documentation l’indique explicitement après l’exemple utilisant un seul fichier.
5. Donnez-lui une tâche qui lit et modifie un fichier, pas une simple salutation. Qwen Code est un agent : les appels d’outils et le streaming sont les fonctionnalités qu’un premier essai doit mettre à l’épreuve, et ce sont elles qui échoueraient en premier avec un point de terminaison seulement partiellement compatible.
6. Ajoutez d’autres entrées sous modelProviders.openai pour changer de modèle à l’exécution avec /model. Ces modifications sont rechargées à chaud dans une session en cours ; providerProtocol est lu une seule fois au démarrage et nécessite un redémarrage.

Vérifié avec Page d’authentification de Qwen Code, option 4 : clé API (flexible) le 21 septembre 2026. Les paramètres tiers évoluent ; si le nom d’un champ ne correspond plus à ce que vous voyez ici, cette page fait autorité, pas celle-ci.

Vérifiez avant de déboguer le client

Une requête suffit à déterminer si l’échec vient de l’endpoint, de la clé ou du fichier de configuration. Si cette requête renvoie du JSON, la même URL de base et la même clé fonctionnent dans 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-..."

Quel identifiant de modèle saisir dans le champ

Tous les modèles textuels sont accessibles sous forme d’identifiant de modèle — la liste à jour se trouve sur GET /v1/models, et le catalogue avec les prix sur la page des modèles. Les tarifs sont en USD par million de tokens, entrée / sortie.

Trois points que la documentation clarifie et que l’on devine souvent à tort

Ces informations proviennent de la page d’authentification et de la référence des fournisseurs de modèles citées ci-dessus ; chacune peut faire perdre un temps précieux au débogage si on la devine au lieu de la vérifier.

1. Une entrée modelProviders a priorité sur les options de la CLI. L’ordre documenté, du plus prioritaire au moins prioritaire, est le suivant : les remplacements effectués via /auth dans la session en cours, puis le envKey du fournisseur de modèles sélectionné, ensuite les arguments de la CLI comme --openai-api-key, puis les variables d’environnement, et enfin security.auth.apiKey dans les paramètres. La plupart des gens s’attendent à ce que l’option l’emporte. Ce n’est pas le cas — c’est pourquoi --openai-base-url peut sembler ignoré.
2. security.auth.apiKey et security.auth.baseUrl sont obsolètes. La référence le précise et recommande de migrer vers modelProviders. Si un ancien tutoriel vous demande de modifier ces deux clés, il vous fait emprunter une voie en cours d’abandon.
3. wireApi détermine le format des requêtes, et aucune détection ne signale une incompatibilité. Si vous l’omettez, le format Chat Completions est utilisé, comme dans le bloc ci-dessus. Définir "wireApi": "responses" exige un point de terminaison réellement compatible avec Responses, et la documentation indique clairement qu’il n’y a ni détection du point de terminaison ni basculement automatique en cas d’échec d’une requête. Kunavo prend en charge /v1/responses ainsi que /v1/chat/completions, mais aucune de ces deux associations n’a été testée sur cette page ; commencez donc par la valeur par défaut.

Si vous êtes venu ici pour le niveau gratuit

Une grande partie de ce qui s’écrit encore sur Qwen Code décrit une connexion OAuth Qwen assortie d’un quota quotidien gratuit. Cette option n’existe plus : la documentation indique que son offre gratuite a pris fin le 15 avril 2026 et que Qwen OAuth n’est plus une option sélectionnable dans la boîte de dialogue /auth. Elle en répertorie maintenant trois : Alibaba ModelStudio — avec Coding Plan, Token Plan et Standard API Key dans son sous-menu —, Fournisseurs tiers et Fournisseur personnalisé, décrit comme permettant de connecter « un serveur local, un proxy ou un fournisseur non pris en charge ». Kunavo est le troisième de ces choix. Notez également que les éléments du sous-menu ModelStudio ne sont pas trois façons de payer une même facture : chacun a son propre hôte et sa propre clé, et une clé Coding Plan ne fonctionnera pas sur un hôte Token Plan.