Comment utiliser Qwen Code : installation, /auth, japonais et configuration API

Qwen Code est un agent de codage IA open source (Apache-2.0), publié par l’équipe Qwen d’Alibaba. Son utilisation se déroule en quatre étapes : « installer → lancer qwen dans le projet → configurer la destination avec /auth → demander une tâche ». Cependant, le quota gratuit de Qwen OAuth ayant pris fin le 15 avril 2026, une connexion conforme aux anciennes explications ne permet plus de l’utiliser gratuitement. Cette page explique successivement comment commencer selon le menu /auth actuel, passer à l’affichage japonais, configurer un fournisseur personnalisé pour utiliser Claude ou GPT et utiliser les commandes courantes. La dernière version est v0.24.7, publiée sur npm le 29 septembre 2026 ; les versions sortent au moins une fois par semaine, vérifiez donc votre version locale avec qwen --version.

Installation

Voici la procédure du README officiel. Avec l’installateur autonome, vous n’avez pas besoin de préparer Node.js vous-même. Node.js 22 ou version ultérieure n’est requis que si vous utilisez 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

Après l’installation, 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 son développement est indépendant depuis v0.1 et n’est plus synchronisé avec le projet amont. Les paramètres et quotas gratuits de Gemini CLI ne s’appliquent donc pas tels quels.

Premier lancement et passage au japonais

cd /path/to/your-project
qwen

# セッション内で：
/language ui ja-JP          # 画面表示を日本語に
/language output Japanese   # モデルの回答を日本語に
/auth                       # 接続先と API キーを設定

Avec /language ui ja-JP, l’interface passe en japonais et les écrans suivants affichent les libellés japonais propres à Qwen Code, tels que « sélectionner une méthode d’authentification » et « mode d’approbation des outils ». Nous reprenons les mêmes libellés sur cette page. La langue des réponses est distincte de la langue de l’interface et se définit avec /language output Japanese.

En plus du terminal, des applications de bureau, une interface Web accessible dans le navigateur (qwen serve --open, fonctionnalité expérimentale), des intégrations pour VS Code, Zed et JetBrains, ainsi qu’une exécution sans interface pour les scripts et la CI (qwen -p "...") sont disponibles. Toutes sont incluses dans le même dépôt gratuit ; les frais d’inférence sont distincts.

Choisir la destination avec /auth

Ouvrez /auth (également appelé /login) pour afficher l’écran « sélectionner une méthode d’authentification » ; les choix de premier niveau sont au nombre de trois. Si vous essayez de sélectionner Qwen OAuth, le message « terminé — passez au Coding Plan ou à l’API Key » s’affiche.

Les trois options ModelStudio ne correspondent pas à trois manières de régler une même facture. La documentation attribue à chacune un point de terminaison et une clé distincts ; elles ne fonctionnent que si le type de clé correspond à baseUrl. Au 1er octobre 2026, le Coding Plan est affiché comme « quantité limitée, premier arrivé, premier servi ; réapprovisionnement chaque jour à 0 h (UTC+8) », avec des jours où il est possible de s’inscrire et d’autres non. Une requête du Coding Plan se transforme en plusieurs appels de modèles en interne ; selon Alibaba, elle consomme 5 à 10 appels pour une tâche simple et 10 à 30 appels, voire davantage, pour une tâche complexe. La comparaison des tarifs est expliquée en détail dans Qwen Code pricing, la version anglaise.

Utiliser Claude ou GPT : configurer un fournisseur personnalisé dans settings.json

La documentation d’authentification de Qwen Code recommande ~/.qwen/settings.json de modelProviders pour connecter des services tiers tels qu’OpenAI, Anthropic, Google, OpenRouter ou votre propre point de terminaison. 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

Voici les quatre points essentiels.

• baseUrl jusqu’à /v1. La référence des fournisseurs de modèles précise : « indiquez la route /v1 de l’API, et non /v1/chat/completions. Le chemin de la requête est ajouté par le SDK ». Si vous indiquez également le chemin, vous obtiendrez une erreur 404 et non une erreur d’authentification.
• Emplacement de la clé. Qwen Code lit la clé dans l’environnement sous le nom de variable indiqué dans envKey. L’ordre de priorité est le export du shell, .env (.qwen/.env recommandé ; seul le premier fichier trouvé est utilisé), puis env dans settings.json ; cette dernière option stocke la clé en clair et n’est donc pas recommandée.
• Le fichier de configuration l’emporte sur les indicateurs CLI. L’ordre de résolution est la valeur saisie dans /auth → le modelProviders sélectionné → les arguments CLI → les variables d’environnement → settings.json. C’est pourquoi --openai-base-url peut sembler ignoré. security.auth.apiKey et security.auth.baseUrl présents dans les anciennes explications sont obsolètes.
• Commencez par Chat Completions. Si vous omettez wireApi, le format Chat Completions est utilisé. Avec "responses", il n’y a ni détection automatique du point de terminaison ni solution de repli. Les modifications de modelProviders sont prises en compte immédiatement dans les sessions en cours (elles apparaissent après avoir rouvert /model).

Le catalogue Kunavo ne contient aucun modèle de texte Qwen. Il ne s’agit pas d’une méthode pour utiliser Qwen à moindre coût, mais d’une façon d’utiliser Claude ou GPT dans Qwen Code avec un seul solde prépayé. Kunavo n’a pas non plus validé Qwen Code en l’exécutant réellement contre son propre point de terminaison. La configuration a été créée à partir de la documentation officielle, comme dans la page de configuration de Qwen Code en anglais. Essayez-la sans supprimer le chemin qui fonctionne actuellement.

Première tâche et commandes courantes

Comme dans l’exemple du README, commencez par une demande telle que « explique ce dépôt et dis-moi par où commencer la lecture ». Cela permet de vérifier que la lecture des fichiers et les appels d’outils fonctionnent correctement. Un simple salut ne permet pas de détecter les problèmes de connexion.

Les modes d’approbation automatique tels que yolo sont accompagnés dans la documentation de l’avertissement « ne les utiliser que dans un environnement de confiance, isolé ou jetable ». 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 les relevés d’utilisation de la destination.

Limites à connaître

• La recherche web_search intégrée dépend de la destination. Elle utilise la recherche côté serveur de DashScope : elle est active avec une Standard API Key et un Token Plan ModelStudio, ainsi qu’avec une entrée pointant vers un hôte DashScope reconnu ; elle est désactivée avec le Coding Plan (car non vérifiée sur ce point de terminaison) et avec les points de terminaison personnalisés de fournisseurs tiers ou d’autres hôtes (documentation de web_search). Si nécessaire, ajoutez un serveur de recherche MCP.
• La route Kunavo est limitée au chat. Kunavo ne propose aucun modèle d’embeddings, de synthèse vocale ou de reconnaissance vocale. Live Voice de Qwen Code exige un point de terminaison DashScope ; quel que soit l’endroit où vous dirigez le modèle de chat, il utilise donc toujours une autre clé.

Paiement lors de l’essai de 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), Apple Pay, Google Pay et Link. Consultez les informations de facturation, puis créez un compte et générez une clé. Après le premier appel, vérifiez le montant réellement facturé dans l’historique d’utilisation.

Questions fréquentes

Vérifié le 1er octobre 2026 : README de Qwen Code ; documentations d’authentification, des fournisseurs de modèles, des commandes et de web_search (branche main) ; chaînes de l’interface japonaise (packages/cli/src/i18n/locales/ja.js) ; npm @qwen-code/qwen-code 0.24.7 ; pages Alibaba Cloud du Coding Plan et du Token Plan. Kunavo n’a pas exécuté Qwen Code contre son propre point de terminaison.