Comment utiliser Qwen Code : installation, choix du compte et du modèle, configuration API

Qwen Code est un agent de codage IA open source (Apache-2.0) publié par l’équipe Alibaba Qwen. Son utilisation se déroule en quatre étapes : « installation → exécution de qwen dans le projet → configuration de la cible de connexion avec /auth → demande de travail ». Cependant, l’offre gratuite Qwen OAuth a pris fin le 15 avril 2026 ; une connexion effectuée selon les anciennes instructions ne fonctionnera donc plus gratuitement. Autre point important pour les utilisateurs coréens : Qwen Code ne dispose pas d’interface en coréen. Cette page explique successivement la méthode de démarrage basée sur le menu /auth actuel, la configuration des réponses en coréen, la configuration personnalisée pour utiliser Claude et GPT, ainsi que les commandes courantes. La version la plus récente est v0.24.7, publiée sur npm le 29 septembre 2026, et de nouvelles versions sortent au moins une fois par semaine ; vérifiez donc la version installée avec qwen --version.

Installation

Voici les commandes du README officiel. Le script d’installation autonome évite de préparer Node.js vous-même ; Node.js 22 ou version ultérieure n’est requis qu’en cas d’installation avec 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

Rouvrez le terminal afin que les variables d’environnement soient prises en compte. Qwen Code était à l’origine basé sur Google Gemini CLI v0.8.2, mais depuis v0.1 il est développé indépendamment, sans synchronisation avec l’original. Les paramètres ou quotas gratuits de Gemini CLI ne s’appliquent pas tels quels.

Premier lancement et réponses en coréen

cd /path/to/your-project
qwen

# 세션 안에서:
/language output Korean   # 모델 답변을 한국어로 (UI는 한국어 미지원)
/auth                     # 공급자와 API 키 설정

Les langues intégrées de l’interface sont uniquement le chinois simplifié, l’anglais, le russe, l’allemand, le japonais, le portugais brésilien, le français et le catalan ; le coréen ne figure pas non plus dans les fichiers de traduction de l’interface du dépôt (vérification effectuée le 1er octobre 2026). Les menus s’affichent donc en anglais et cette page cite les intitulés anglais tels qu’ils apparaissent à l’écran. La langue des réponses du modèle est indépendante de celle de l’interface et peut être fixée au coréen avec /language output Korean.

Outre le terminal, il existe une application de bureau, une interface web accessible dans le navigateur (qwen serve --open, fonctionnalité expérimentale), des intégrations avec VS Code, Zed et JetBrains, ainsi qu’une exécution sans interface pour les scripts et la CI (qwen -p "..."). Tout est inclus dans le même dépôt gratuit, mais les coûts d’inférence sont facturés séparément.

Choisir la cible de connexion avec /auth

En ouvrant /auth(alias /login), l’écran « Select authentication method: » apparaît, avec trois choix principaux. Si vous tentez de sélectionner Qwen OAuth, le message « Discontinued — switch to Coding Plan or API Key » s’affiche.

Les trois options de ModelStudio ne sont pas trois méthodes utilisant la même facture. La documentation prévoit pour chacune un endpoint et une clé distincts ; elles ne fonctionnent pas si le type de clé et le baseUrl ne correspondent pas. Au 1er octobre 2026, le Coding Plan est indiqué comme disponible « en quantité limitée, selon le principe du premier arrivé, premier servi, réapprovisionné chaque jour à minuit (UTC+8) », de sorte que l’inscription peut être impossible certains jours. Dans le Coding Plan, une tâche correspond à plusieurs appels de modèle ; Alibaba explique que les tâches simples nécessitent généralement 5 à 10 appels et les tâches complexes 10 à 30 appels ou davantage. La comparaison des tarifs est détaillée sur la page anglaise Qwen Code pricing.

Utiliser Claude ou GPT : Custom Provider dans settings.json

La documentation d’authentification de Qwen Code recommande ~/.qwen/settings.json et modelProviders pour les connexions tierces telles qu’OpenAI, Anthropic, Google, OpenRouter ou un endpoint propriétaire. Pour Kunavo, procédez comme suit.

{
  "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

Quatre éléments qui vous feront gagner du temps lors du débogage :

• baseUrl jusqu’à /v1. La documentation de référence des fournisseurs de modèles précise qu’il faut « indiquer la racine /v1 de l’API, et non le chemin complet /v1/chat/completions, car le SDK ajoute le chemin de la requête ». Si vous indiquez le chemin complet, vous obtiendrez une erreur 404, et non une erreur d’authentification.
• Où placer la clé. Qwen Code lit la clé dans la variable d’environnement dont le nom est indiqué dans envKey. L’ordre de priorité est : shell export, fichier .env (.qwen/.env recommandé, seul le premier fichier trouvé est utilisé), puis settings.json env ; cette dernière option stocke la clé en clair et n’est donc pas recommandée.
• Le fichier de configuration l’emporte sur les paramètres CLI. L’ordre de décision est : valeur saisie dans /auth → entrée modelProviders sélectionnée → arguments CLI → variables d’environnement → settings.json. C’est pourquoi --openai-base-url peut sembler ignoré. security.auth.apiKey et security.auth.baseUrl apparaissant dans les anciennes explications seront bientôt abandonnés.
• Commencez par Chat Completions. Si vous omettez wireApi, le format Chat Completions est utilisé. Si vous passez à "responses", il n’y a ni détection automatique de l’endpoint ni basculement automatique en cas d’échec. Les modifications de modelProviders sont prises en compte immédiatement, même dans une session en cours (elles deviennent visibles lorsque vous rouvrez /model).

Le catalogue Kunavo ne contient pas de modèles de texte Qwen. Il ne s’agit pas d’une méthode pour utiliser Qwen à moindre coût, mais d’une méthode pour utiliser Claude et GPT dans Qwen Code avec un seul solde prépayé. Kunavo n’a pas non plus vérifié Qwen Code en l’exécutant réellement sur son propre endpoint. Comme pour la page de configuration de Qwen Code en anglais, la configuration a été rédigée à partir de la documentation officielle. Testez-la en conservant votre méthode actuelle en parallèle.

Première tâche et commandes courantes

La première demande donnée en exemple dans le README ressemble à « Explique ce dépôt et indique-moi par où commencer ». Elle permet de vérifier en une seule fois la lecture des fichiers et les appels d’outils. Une simple salutation ne permet pas de détecter un problème de connexion.

Un mode d’approbation automatique comme yolo est explicitement accompagné de l’avertissement suivant dans la documentation : « utilisez-le uniquement dans un environnement fiable, placé dans un bac à sable ou pouvant être supprimé ». Le coût estimé de /stats model est calculé par Qwen Code et ne correspond pas au montant facturé. Vérifiez le montant réel dans l’historique d’utilisation du fournisseur connecté.

Limites à connaître

• Le web_search intégré est activé ou désactivé selon la cible de connexion. Comme il utilise la recherche côté serveur DashScope, il est activé pour ModelStudio Standard API Key, Token Plan et les entrées pointant vers un hôte DashScope reconnu ; il est désactivé dans Coding Plan (non vérifié sur cet endpoint) ainsi que sur les endpoints personnalisés de fournisseurs tiers ou d’autres hôtes (documentation de web_search). Si nécessaire, ajoutez un serveur de recherche MCP.
• La voie Kunavo est limitée au chat. Kunavo ne propose pas de modèles d’embeddings, de synthèse vocale ou de reconnaissance vocale. Live Voice de Qwen Code exige un endpoint DashScope ; il utilise donc la clé distincte correspondante, quel que soit l’endroit où vous faites fonctionner le modèle de chat.

Paiement lors d’un essai avec Kunavo

Kunavo fonctionne par rechargement prépayé, sans abonnement mensuel, et déduit la consommation du solde au token. Le rechargement minimum est de $10 ; le checkout Stripe accepte les cartes (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay et Link. Lorsque le checkout est affiché en wons, KakaoPay, Naver Pay, PAYCO, Samsung Pay et les cartes nationales dont les paiements internationaux ne sont pas activés sont également disponibles (la conversion en wons inclut les frais de change Stripe de 2–4 %, évitables en payant en dollars). Toss Pay n’est pas proposé. Consultez le guide de paiement, créez un compte et générez une clé. Après le premier appel, le plus fiable est de vérifier le montant réel dans l’historique d’utilisation.

Questions fréquentes

Vérification effectuée le 1er octobre 2026 : README de Qwen Code, documentation de l’authentification, des fournisseurs de modèles, des commandes et de web_search (branche main), liste des fichiers de traduction de l’interface du dépôt, @qwen-code/qwen-code 0.24.7 sur npm, pages Alibaba Cloud consacrées au Coding Plan et au Token Plan. Kunavo n’a pas exécuté Qwen Code sur son propre endpoint.