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

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 :
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 :
npm install -g @qwen-code/qwen-code@latest
Ou, sous macOS et Linux, avec Homebrew :
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
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 :
- Qwen Account with Subscription : connexion dans le navigateur avec un abonnement Plus ou Pro.
- QwenCloud : un Token Plan ou une Standard API Key facturée à l’usage.
- Alibaba ModelStudio : Coding Plan, Token Plan ou Standard API Key.
- Third-party Providers : une liste intégrée comprenant DeepSeek, Kimi, OpenRouter et d’autres, avec une clé API.
- 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 :
{
"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 :
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 :
/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 :
qwen -p "Summarize the repository layout."

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 authne sert à rien. Cette commande a été supprimée. Lancezqwen, puis/auth. Lancez/doctorpour vérifier votre authentification actuelle.- Le modèle local expire. Vérifiez que la
baseUrlse termine par/v1et que le serveur tourne. Pour les serveurs lents, la documentation décrit un réglagestreamIdleTimeoutMs. - Des doutes sur la sécurité du daemon. Si vous utilisez
qwen serveouqwen 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éfinissezQWEN_SERVER_TOKENet 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.





Écrire une réponse