Qwen Code : installer et utiliser l’agent de code open source pour le terminal

Un guide pas à pas pour installer Qwen Code, connecter un modèle (y compris un modèle local) et utiliser le Plan Mode et les validations en toute sécurité, d’après la documentation du projet.

Graphic of a code card showing a terminal command to install Qwen Code, the open-source terminal coding agent.

Qwen Code est né d’un projet construit sur Gemini CLI de Google, et il compte aujourd’hui plus de 30 000 étoiles GitHub à lui seul. D’après le README, le projet reposait à l’origine sur Gemini CLI v0.8.2, a cessé de se synchroniser avec le projet d’origine à partir de la v0.1 et est devenu un agent de code indépendant et multiprotocole.

À retenir

  • Qwen Code est un agent de code open source pour le terminal, sous licence Apache-2.0, né d’un fork de Gemini CLI.
  • Installez-le avec le script autonome, avec npm et Node.js 22 ou plus récent, ou avec Homebrew, puis lancez /auth pour connecter un modèle.
  • Aucune option de connexion n’est présentée comme gratuite : pour un coût nul, utilisez un serveur local Ollama, vLLM ou LM Studio.
  • Abordez une nouvelle base de code en Plan Mode, en lecture seule, vérifiez avec /diff et revenez en arrière avec /restore.

Ce guide montre comment installer Qwen Code, vous connecter (ou le brancher sur un modèle local gratuit) et l’utiliser en toute sécurité sur un vrai projet. Tout ce qui suit provient du README et de la documentation du projet sur GitHub, vérifiés le 15 novembre 2026. Aucune commande n’a été exécutée pour cet article : testez-les d’abord dans un dossier jetable.

Ce qu’il vous faut

  • Un terminal sous macOS, Linux ou Windows
  • Node.js 22 ou plus récent, si vous passez par npm
  • Un projet de code sur lequel le lancer (un dépôt de test est idéal)
  • Un moyen de payer ou d’héberger un modèle : un abonnement Qwen, une clé API ou un serveur de modèles local
Schéma des cinq options de connexion de Qwen Code, du Qwen Account à un fournisseur de modèle local personnalisé

Qu’est-ce que Qwen Code ?

C’est un agent de code open source qui tourne dans votre terminal, lit votre dépôt, modifie des fichiers et exécute des commandes. GitHub indique la licence Apache-2.0, et le README précise qu’il fonctionne avec les API d’OpenAI, Anthropic, Gemini et Qwen, ainsi qu’avec tout fournisseur tiers ou modèle local comme Ollama ou vLLM. Au 15 novembre 2026, la dernière version publiée est la v0.27.4.

Le projet publie aussi son propre benchmark : sur SWE-bench Verified, sept versions de Qwen Code ont obtenu une moyenne comprise entre 76,40 % et 77,80 % avec le même modèle, Qwen 3.7 Max. Il s’agit de l’évaluation des mainteneurs, pas d’un test indépendant.

En chiffres

30 000étoiles GitHub, plus de

77,80 %meilleure moyenne SWE-bench annoncée par le projet

v0.27.4dernière version publiée

Pas à pas

1. L’installer

Le README propose trois méthodes. La première est un installateur en une ligne pour Linux et macOS :

Terminal
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Envoyer un script directement dans votre shell, c’est une question de confiance. L’installateur est hébergé sur une adresse de stockage Alibaba Cloud ; si vous préférez, utilisez plutôt npm ou Homebrew :

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

Ou, sous macOS et Linux, avec Homebrew :

Terminal
brew install qwen-code

Pour Windows, le README fournit un installateur PowerShell. Après une installation autonome, redémarrez votre terminal pour que les variables d’environnement soient prises en compte.

2. Le lancer dans un projet

Terminal
cd ~/projects/my-app
qwen

Vous devriez voir une session interactive dans le terminal. Le README mentionne aussi une branche « 1.0 Preview », mais les instructions ci-dessous concernent la version principale.

3. Se connecter ou brancher un modèle

Tapez /auth. La documentation liste cinq choix principaux :

  1. Qwen Account with Subscription : connexion dans le navigateur avec un abonnement Plus ou Pro.
  2. QwenCloud : un Token Plan ou une Standard API Key facturée à l’usage.
  3. Alibaba ModelStudio : Coding Plan, Token Plan ou Standard API Key.
  4. Third-party Providers : une liste intégrée comprenant DeepSeek, Kimi, OpenRouter et d’autres, avec une clé API.
  5. Custom Provider : un serveur local, un proxy ou un fournisseur non pris en charge.

Aucune de ces options n’est présentée comme gratuite dans la documentation actuelle. Pour rester à coût nul, utilisez un modèle local. La documentation montre qu’Ollama, vLLM et LM Studio fonctionnent via une adresse compatible OpenAI. Notre guide pour faire tourner un modèle d’IA avec Ollama couvre la partie serveur. Enregistrez ensuite une configuration dans ~/.qwen/settings.json, adaptée de l’exemple de la documentation :

Code
{
  "env": { "OLLAMA_API_KEY": "ollama" },
  "modelProviders": {
    "openai": [
      {
        "id": "your-model-name",
        "name": "My local model",
        "envKey": "OLLAMA_API_KEY",
        "baseUrl": "http://localhost:11434/v1"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "your-model-name" }
}

Remplacez your-model-name par le nom exact du modèle indiqué par votre serveur. La documentation précise que model.name doit correspondre à l’une des valeurs id. Après l’enregistrement, lancez qwen.

4. Poser votre première question

Le README conseille de commencer par un prompt sûr, en lecture seule :

Code
Explain this repository and show me where to start.

Lancez ensuite /init, qui selon la documentation analyse le dossier courant et crée un premier fichier de contexte. Qwen Code charge automatiquement vos consignes QWEN.md et AGENTS.md. Si vous utilisez déjà des fichiers de skills, notre guide sur les agent skills dans Claude Code explique le principe, et Qwen Code mentionne son propre panneau /skills dans la documentation.

5. Choisir la liberté qu’on lui laisse

Qwen Code propose cinq modes d’autorisation : Plan, Ask Permissions, Auto-Edit, Auto et YOLO. Appuyez sur Shift+Tab (Tab sous Windows) pour passer de l’un à l’autre. La documentation présente Auto, où un classificateur approuve les actions sûres et bloque les actions risquées, comme le mode par défaut, mais la même page cite aussi Ask Permissions comme mode initial : vérifiez donc la barre d’état. Pour une nouvelle base de code, commencez en Plan Mode :

Code
/plan refactor the settings page

Le Plan Mode est en lecture seule : rien n’est modifié ni exécuté. Tapez /plan exit pour revenir à votre mode précédent. Réservez YOLO aux projets de confiance, comme le recommande la documentation.

6. Vérifier et annuler

Utilisez /diff pour ouvrir une vue interactive des modifications non commitées. Si une étape a mal tourné, /restore liste les points de restauration et ramène les fichiers du projet à leur état d’avant l’exécution d’un outil.

7. L’utiliser dans des scripts

D’après le README, le mode headless fonctionne depuis des scripts et la CI :

Terminal
qwen -p "Summarize the repository layout."
Diagramme : installer Qwen Code, connecter un modèle, planifier en lecture seule et vérifier les modifications

Erreurs courantes et solutions

  • qwen: command not found. Redémarrez votre terminal après l’installation, comme l’indique le README. Avec npm, vérifiez que Node.js est en version 22 ou plus récente.
  • La connexion dans le navigateur ne fonctionne pas. En CI ou dans des conteneurs sans surveillance, la documentation d’authentification recommande plutôt une méthode par clé API, avec des variables d’environnement.
  • qwen auth ne sert à rien. Cette commande a été supprimée. Lancez qwen, puis /auth. Lancez /doctor pour vérifier votre authentification actuelle.
  • Le modèle local expire. Vérifiez que la baseUrl se termine par /v1 et que le serveur tourne. Pour les serveurs lents, la documentation décrit un réglage streamIdleTimeoutMs.
  • Des doutes sur la sécurité du daemon. Si vous utilisez qwen serve ou qwen daemon start, sachez que d’après le README il écoute par défaut sur l’interface loopback sans authentification bearer : tout processus local capable de l’atteindre peut utiliser l’API complète, y compris l’exécution de code. Sur des machines partagées, définissez QWEN_SERVER_TOKEN et utilisez --require-auth.

Le saviez-vous ?

Par défaut, le daemon qwen serve écoute sur l’interface loopback sans authentification bearer : tout processus local capable de l’atteindre peut utiliser l’API complète, y compris l’exécution de code. Sur des machines partagées, définissez QWEN_SERVER_TOKEN et utilisez –require-auth.

Est-ce que ça vaut le coup ?

Si vous aimez le fonctionnement de Claude Code ou de Gemini CLI et voulez un outil que vous pouvez brancher sur votre propre modèle, Qwen Code n’est qu’à une courte installation. Commencez en Plan Mode, gardez un commit Git sous la main et considérez les chiffres du benchmark comme ceux des mainteneurs tant que vous ne l’avez pas essayé.

Questions fréquentes

Qwen Code est-il gratuit ?

L’outil lui-même est open source sous licence Apache-2.0, mais aucune des options de connexion de /auth n’est présentée comme gratuite dans la documentation actuelle. Pour rester à coût nul, branchez-le sur un modèle local via Ollama, vLLM ou LM Studio.

Comment installer Qwen Code ?

Le README propose trois méthodes : un installateur autonome en une ligne pour Linux et macOS, npm install -g @qwen-code/qwen-code@latest avec Node.js 22 ou plus récent, ou brew install qwen-code. Pour Windows, il existe un installateur PowerShell. Redémarrez ensuite votre terminal.

Qwen Code peut-il utiliser un modèle local avec Ollama ?

Oui. Enregistrez un fichier ~/.qwen/settings.json qui fait pointer un fournisseur compatible OpenAI vers http://localhost:11434/v1, et vérifiez que model.name correspond à l’une des valeurs id du fournisseur. Lancez ensuite qwen.

Qu’est-ce que le Plan Mode dans Qwen Code ?

Le Plan Mode est l’un des cinq modes d’autorisation et fonctionne en lecture seule : rien n’est modifié ni exécuté. Lancez-le avec /plan suivi de votre tâche, et tapez /plan exit pour revenir à votre mode précédent.

Petit quiz

Sur quel projet Qwen Code reposait-il à l’origine ?

  • Claude Code
  • Gemini CLI
  • Ollama

D’après le README, il reposait à l’origine sur Gemini CLI v0.8.2.

Quel mode est en lecture seule ?

  • Plan
  • YOLO
  • Auto-Edit

La documentation indique que le Plan Mode ne modifie et n’exécute rien.

Quelle commande ramène les fichiers du projet à un point de restauration ?

  • /diff
  • /init
  • /restore

/restore liste les points de restauration et ramène les fichiers à leur état d’avant l’exécution d’un outil.

Sources

Liens vérifiés pour la dernière fois le 15 novembre 2026.

Écrit par Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

À propos de Mindloop Experience

Réponses

Écrire une réponse

Plus d’articles de Mindloop Experience

Tout voir de Mindloop Experience

Vous pouvez applaudir jusqu’à 50 fois.