Qwen CLI : comment installer et utiliser Qwen Code (2026)

TL;DR

• Qwen CLI (officiellement Qwen Code) est l’agent de codage en terminal open-source d’Alibaba — un fork de Gemini CLI optimisé pour les modèles Qwen. Installez-le avec npm install -g @qwen-code/qwen-code@latest sur Node.js 22+.
• Le grand changement que la plupart des guides manquent : le palier gratuit Qwen OAuth a été abandonné le 2026-04-15. L’ancien « 2,000 requêtes gratuites par jour » ne fonctionne plus — vous avez désormais besoin d’un fournisseur d’API.
• Configurez-le en le pointant vers n’importe quel endpoint compatible OpenAI avec trois variables d’environnement : OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MODEL. C’est toute la configuration.
• Un seul endpoint peut exécuter Qwen *et* d’autres modèles. Pointez OPENAI_BASE_URL vers [Velokey](https://api.velokey.ai) et vous pouvez piloter Qwen Code avec qwen3.7-max, GPT, Claude ou GLM avec une seule clé.

Qu’est-ce que Qwen CLI (Qwen Code) ?

Qwen CLI est le nom courant de Qwen Code, un agent de codage IA open-source qui s’exécute dans votre terminal, créé par l’équipe Qwen chez Alibaba. Il lit et modifie votre base de code, exécute des commandes et travaille de manière agentique sur des tâches — dans le même esprit que Claude Code ou Gemini CLI. En fait, il a commencé comme un fork de Gemini CLI, adapté avec des prompts et des parseurs optimisés pour les modèles Qwen.

Deux choses sont bonnes à savoir avant l’installation. Premièrement, le package s’appelle @qwen-code/qwen-code, donc « qwen cli », « qwen-cli » et « qwen code cli » désignent tous le même outil. Deuxièmement — et c’est là que beaucoup se font piéger — il n’est pas verrouillé aux serveurs de Qwen. Il parle le protocole compatible OpenAI, vous pouvez donc l’exécuter avec l’API de Qwen, OpenRouter, un modèle local ou une passerelle. Ce qui compte plus que jamais maintenant, car le chemin gratuit a changé.

Comment installer Qwen Code CLI ?

Installez Qwen Code globalement avec npm, sur Node.js 22 ou plus récent :

npm install -g @qwen-code/qwen-code@latest
qwen --version

Si vous êtes sur macOS, Homebrew fonctionne aussi (brew install qwen-code), et il existe des installateurs autonomes pour Linux et Windows. Voici ce qui compte réellement au moment de l’installation :

Si qwen: command not found apparaît après l’installation, votre répertoire bin npm global n’est pas dans votre PATH — exécutez npm config get prefix, et ajoutez son /bin à PATH. Sous Linux, une erreur de permissions pendant l’installation globale signifie généralement que vous avez besoin de sudo ou, mieux, d’un Node géré par nvm afin que les installations globales ne touchent pas aux répertoires système.

Comment configurer Qwen CLI maintenant que le palier gratuit a disparu ?

Vous configurez Qwen Code avec une clé d’API compatible OpenAI, car le palier gratuit Qwen OAuth a été [abandonné le 2026-04-15](https://github.com/QwenLM/qwen-code/issues/3203) — des jetons mis en cache peuvent subsister quelque temps, mais les nouvelles connexions sont rejetées. Ce palier gratuit offrait auparavant 2,000 requêtes par jour et 60 par minute ; de nombreux tutoriels « utiliser Qwen Code gratuitement » le décrivent encore, et ils sont désormais erronés.

La configuration actuelle repose sur trois variables d’environnement. Définissez-les, exécutez qwen, puis choisissez « OpenAI » dans le menu d’authentification :

export OPENAI_API_KEY="your_api_key"
export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"
qwen

Vous préférez un fichier de configuration ? Qwen Code lit ~/.qwen/settings.json (ou un .qwen/settings.json local au projet), où vous définissez un fournisseur de modèle une seule fois :

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [{
        "id": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      }]
    }
  },
  "security": { "auth": { "selectedType": "openai" } }
}

Vos options de fournisseur aujourd’hui sont le ModelStudio Coding Plan d’Alibaba Cloud (un abonnement mensuel fixe), l’API DashScope facturée au token, OpenRouter, Fireworks ou tout autre endpoint compatible OpenAI. Les docs officielles d’authentification listent l’ensemble actuel — consultez-les plutôt qu’un ancien blog, puisque c’est précisément la partie qui est devenue obsolète.

Comment exécuter Qwen CLI avec n’importe quel modèle via un seul endpoint ?

Pointez OPENAI_BASE_URL vers une passerelle et une seule clé exécute Qwen Code avec de nombreux modèles — sans jongler avec des comptes par fournisseur. Comme Qwen Code n’a besoin que d’un endpoint compatible OpenAI, Velokey fonctionne comme un remplacement direct : une seule clé donne accès à Qwen, GPT, Claude et GLM via la même URL de base.

export OPENAI_API_KEY="sk-your-velokey-key"
export OPENAI_BASE_URL="https://api.velokey.ai/v1"
export OPENAI_MODEL="qwen3.7-max"
qwen

Le gain pratique est de changer de backend sans se réauthentifier. Qwen Code est optimisé pour les modèles Qwen, donc [qwen3.7-max](/model/qwen3.7-max) est le choix par défaut naturel — mais si une tâche nécessite un modèle différent, changez une variable :

Comme la facturation se fait au token via des crédits, il n’y a pas d’abonnement séparé ni de plafond quotidien de requêtes — vous payez ce que l’agent utilise réellement. Pour comprendre comment ce calcul fonctionne, consultez notre guide des tarifs de l’API Claude ; le même modèle au token s’applique à Qwen et aux autres.

Pourquoi Qwen CLI ne fonctionne-t-il pas ? Erreurs courantes

La plupart des échecs de Qwen CLI sont des problèmes d’environnement ou d’authentification, pas des bugs — et ils se regroupent autour de quelques causes. Lancez qwen --safe-mode pour désactiver vos personnalisations ; si le problème disparaît, réactivez les paramètres un par un pour trouver le coupable.

Si votre clé est stockée dans un outil basé sur navigateur plutôt que dans une variable d’environnement, une session manquante peut déclencher une autre catégorie d’erreur — consultez notre guide pour corriger « API key not found in cookies ». Pour une procédure complète de bout en bout afin de brancher une clé d’API dans un client, comment appeler un modèle avec une clé d’API couvre le schéma de configuration.

Questions fréquentes

Comment installer Qwen CLI ?

Exécutez npm install -g @qwen-code/qwen-code@latest sur Node.js 22 ou plus récent, puis qwen --version pour confirmer. Sur macOS, vous pouvez aussi utiliser brew install qwen-code. Si vous obtenez command not found, ajoutez votre répertoire bin npm global (npm config get prefix + /bin) à votre PATH.

Qwen CLI est-il gratuit ?

Plus via le chemin intégré — le palier gratuit Qwen OAuth a été abandonné le 2026-04-15. Le CLI lui-même est open-source et gratuit, mais vous avez désormais besoin d’un fournisseur d’API : ModelStudio Coding Plan d’Alibaba, DashScope facturé au token, OpenRouter ou tout endpoint compatible OpenAI configuré avec votre propre clé.

Comment utiliser Qwen CLI avec ma propre clé d’API ?

Définissez trois variables d’environnement — OPENAI_API_KEY, OPENAI_BASE_URL et OPENAI_MODEL — puis exécutez qwen et sélectionnez « OpenAI » dans le menu d’authentification. Vous pouvez aussi définir un fournisseur dans ~/.qwen/settings.json. L’URL de base pointe vers le fournisseur compatible OpenAI que vous utilisez.

Quels modèles Qwen Code CLI prend-il en charge ?

Qwen Code est optimisé pour les modèles Qwen comme Qwen3-Coder, mais comme il parle le protocole compatible OpenAI, il s’exécute avec OpenAI, Anthropic, Gemini, OpenRouter, des modèles locaux via Ollama ou vLLM, et des passerelles. Définissez OPENAI_MODEL sur l’ID de modèle exposé par votre fournisseur.

Pourquoi Qwen CLI indique-t-il « command not found » ?

Votre répertoire bin npm global n’est pas dans votre PATH. Exécutez npm config get prefix pour trouver le préfixe d’installation, puis ajoutez son sous-dossier /bin à votre PATH et redémarrez votre shell. C’est l’erreur post-installation la plus courante et elle n’a rien à voir avec l’outil lui-même.

Puis-je exécuter Qwen CLI avec une passerelle au lieu de l’API de Qwen ?

Oui. Qwen Code accepte tout endpoint compatible OpenAI, vous pouvez donc pointer OPENAI_BASE_URL vers une passerelle et accéder à plusieurs modèles avec une seule clé. Définissez OPENAI_MODEL sur le modèle que vous voulez — un modèle Qwen pour la meilleure fidélité d’appel d’outils, ou un autre modèle selon la tâche.