Qwen Code CLI : l’agent terminal open source

Vous ouvrez un terminal dans votre projet. Vous tapez qwen. Une interface interactive apparaît. Vous demandez « explique-moi l’architecture de ce projet » et Qwen Code lit vos fichiers, reconstitue la structure, identifie les patterns, vous répond. Vous enchaînez « refactorise ce module pour utiliser async/await, crée les tests unitaires associés, vérifie que tout passe ». L’agent planifie, exécute, modifie les fichiers, lance les tests, corrige les erreurs, itère. En dix minutes, une refonte qui aurait pris deux heures.

C’est exactement ce que Claude Code a popularisé en 2024. Qwen Code propose la même expérience — avec une base open source, une licence Apache 2.0 pour le framework, et le choix du modèle sous-jacent. Cet article couvre l’installation au 16 avril 2026, les changements tarifaires récents (importants), la configuration en mode autonome avec les alternatives au free tier, et les forces/limites réelles face à Claude Code et Codex CLI.

Qu’est-ce que Qwen Code exactement

Qwen Code est un agent IA en ligne de commande, open source sous licence Apache 2.0, optimisé pour les modèles Qwen3-Coder. Le projet est forké de Google Gemini CLI (d’où une partie de l’architecture et de l’interface), avec des adaptations spécifiques : prompts customisés, protocole d’appel de fonctions adapté aux modèles Qwen, support des Skills et SubAgents.

Ce qui le distingue d’un simple chatbot terminal :

• Compréhension à l’échelle du dépôt — l’agent analyse des codebases entières, pas juste des fichiers isolés. Gestion intelligente du contexte pour dépasser les limites classiques.
• Multi-protocole — compatible avec les APIs OpenAI, Anthropic, Gemini. Vous pouvez donc l’utiliser avec à peu près n’importe quel modèle, pas seulement Qwen.
• Workflow agentique complet — Skills, SubAgents, Plan Mode, AI Code Review, Batch Runner, Cron Scheduled Tasks, Terminal Capture, GIF Recording.
• Intégration IDE optionnelle — plugins VS Code (Qwen Code Companion) et JetBrains (via Agent Client Protocol).
• MCP natif — supporte les serveurs MCP (Model Context Protocol) pour étendre les capacités avec des outils externes.

Installation au 16 avril 2026

Prérequis unique : Node.js version 20 ou supérieure. Vérifiez avec node --version. Si vous avez plus ancien, passez par nvm ou l’installateur officiel sur nodejs.org. Le reste s’installe en une commande.

macOS et Linux

# Installation via le script officiel
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"

# Alternative : via npm
npm install -g @qwen-code/qwen-code@latest

# Alternative : via Homebrew (macOS/Linux)
brew install qwen-code

# Vérifier l'installation (version ≥ 0.11.1 attendue)
qwen --version

Windows

# Ouvrir CMD en tant qu'administrateur
# (rechercher CMD → clic droit → Exécuter en tant qu'administrateur)

# Installation via le script officiel Windows
curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat

# Fermer et rouvrir CMD, puis vérifier
qwen --version

Redémarrez votre terminal après installation pour que les variables d’environnement prennent effet. C’est l’erreur la plus fréquente sur Windows et Linux — la commande qwen reste inconnue tant que vous ne relancez pas votre shell.

Configurer l’authentification après le 15 avril 2026

Le free tier étant désactivé, cinq options s’offrent à vous, chacune avec ses compromis :

Pour un développeur solo qui code tous les jours, la bascule vers Alibaba Cloud Coding Plan (~50 $/mois pour Pro, ~10 $/mois pour Lite) reste le meilleur rapport qualité-prix face à l’abonnement Claude Code ou Codex. Pour un usage ponctuel, OpenRouter permet de ne payer qu’à la consommation réelle. Pour la souveraineté absolue, la combinaison Qwen Code + Ollama local fonctionne parfaitement.

Configuration avec Coding Plan (méthode recommandée)

# Lancer Qwen Code depuis votre projet
cd mon-projet
qwen

# Au premier lancement, l'interface interactive propose
# de choisir la méthode d'authentification.
# Sélectionner : Alibaba Cloud Coding Plan
# Entrer votre API key Coding Plan (récupérée sur Bailian)

# Alternative : commande auth en dehors de la session
qwen auth

Configuration BYOK avec provider custom

Pour pointer Qwen Code vers un autre provider (OpenRouter, Fireworks, votre endpoint local Ollama), éditez le fichier de configuration :

# Emplacement du fichier de config
# Global : ~/.qwen/settings.json
# Projet : .qwen/settings.json (dans le dossier du projet)

mkdir -p ~/.qwen
nano ~/.qwen/settings.json

# Exemple de configuration pour Ollama local
{
  "env": {
    "OLLAMA_API_KEY": "EMPTY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-local",
        "name": "Qwen3-Coder via Ollama local",
        "baseUrl": "http://localhost:11434/v1",
        "envKey": "OLLAMA_API_KEY"
      }
    ]
  }
}

Les commandes essentielles au quotidien

Qwen Code reprend le modèle des slash-commands popularisé par Claude Code et Codex. Voici les plus utiles, celles qui changent vraiment la productivité :

La commande /plan est particulièrement utile sur les tâches complexes. Elle force l’agent à proposer un plan détaillé avant toute action, que vous validez ou modifiez avant exécution. C’est l’équivalent du Plan Mode de Claude Code — et ça évite beaucoup d’erreurs coûteuses sur les refactors ambitieux.

Mode non-interactif pour scripts et CI

Pour intégrer Qwen Code dans des scripts shell, des pipelines CI/CD ou des automatisations cron, utilisez le flag -p (prompt) :

# Génération de code en une commande
qwen -p "Écris un serveur HTTP Flask minimal en Python"

# Sortie texte brut (pour piping)
qwen -p "Résume les changements du dernier commit" -o text | tee resume.md

# Dans un pipeline CI
qwen -p "Analyse ce PR et liste les risques de régression" \
  -o text > pr-analysis.md

# Avec contexte fichier
qwen -p "Refactorise cette classe pour utiliser async/await" \
  --file src/database.py

Les fonctionnalités avancées qui changent la donne

Skills — workflows réutilisables

Une Skill Qwen Code est un dossier contenant un fichier SKILL.md et des ressources associées, qui décrit un workflow complet (ex. : « migrer une API REST vers GraphQL », « créer une page produit e-commerce selon les conventions internes »). L’agent charge la Skill au besoin et suit les instructions. C’est comparable aux Skills de Claude (modèle identique), sauf que vos Skills Qwen Code sont 100 % open source et partageables via Git ou npm.

Usage :

# Structure d'une skill Qwen
.qwen/skills/
  ma-skill/
    SKILL.md              # Instructions principales
    references/
      template.html       # Ressources associées
      examples.md

# Déclenchement dans une session
> Use the skill ma-skill to create a new product page

SubAgents — délégation de tâches

Un SubAgent est une instance secondaire de Qwen Code, lancée depuis la session principale, avec un périmètre et un prompt spécifiques. Utile pour paralléliser ou pour isoler un contexte sensible. Exemple concret : l’agent principal travaille sur le backend, un SubAgent s’occupe en parallèle de mettre à jour la documentation, un autre vérifie les tests.

Cron Scheduled Tasks

Fonctionnalité arrivée fin 2025 avec les Qwen Code Weekly : planifier des tâches agentiques récurrentes. Par exemple : « tous les lundis à 9h, analyse les issues GitHub fermées de la semaine précédente, produis un rapport, commite-le dans docs/weekly-review.md ». L’agent tourne seul, selon le planning, sans intervention humaine.

AI Code Review

Commande /review. Qwen Code analyse un diff (commit, PR, fichiers modifiés) et produit une revue structurée : problèmes détectés, améliorations suggérées, questions à poser à l’auteur. Comparable à ce que propose GitHub Copilot Review ou DeepSource, mais entièrement en local/auto-hébergé si vous le voulez.

Intégration IDE : VS Code et JetBrains

Pour les devs qui préfèrent ne pas vivre dans le terminal, deux intégrations existent :

Qwen Code vs Claude Code vs Codex CLI

Comparaison honnête sur les dimensions qui comptent pour un choix éclairé :

La force unique de Qwen Code dans ce comparatif : vous pouvez y brancher n’importe quel modèle via une API compatible. Vous êtes sous abonnement Claude Pro et vous voulez tester Claude Opus 4.7 dans Qwen Code ? C’est possible. Vous voulez alterner Qwen3-Coder pour le volume et GPT-5.4 pour les cas difficiles ? Configuration en 30 secondes. Claude Code et Codex CLI vous lockent dans leur écosystème — Qwen Code vous donne le choix.

Quand Qwen Code est le bon choix

• Vous voulez du self-hosting complet — Qwen Code + Qwen3-Coder en local via Ollama. Zéro dépendance cloud, votre code ne sort pas de votre machine.
• Vous êtes multi-modèle — vous utilisez Claude ET GPT ET Gemini selon les tâches. Qwen Code les unifie dans un seul agent CLI.
• Vous êtes sensible au coût — Coding Plan Pro à ~50 $/mois contre un abonnement Claude Code qui grimpe vite selon l’usage. Pour un volume important, l’écart est significatif.
• Vous avez besoin d’un framework ouvert — contribution, fork, audit de sécurité du code de l’agent. Qwen Code est la seule option sérieuse sur ce critère.
• Vous voulez tester avant d’investir — installation rapide, configuration avec votre API existante (pas forcément Qwen), possibilité de désinstaller proprement.

Quand rester sur Claude Code ou Codex

• Maturité produit prioritaire — Claude Code et Codex ont une UX plus polie, moins d’aspérités. Pour une équipe qui veut du clé-en-main, le confort de ces deux outils est au-dessus.
• Écosystème MCP déjà configuré — si vous avez 20 MCP Claude officiels branchés, migrer représente un coût que le gain ne compense pas toujours.
• Qualité maximale sur tâches complexes — Claude Opus 4.7 avec Extended Thinking garde l’avantage sur les refactors très ambigus. Qwen Code avec Qwen3-Coder est excellent mais ne surpasse pas systématiquement Opus.
• Communauté et support — Claude Code a une documentation française, des milliers de tutoriels vidéo, une communauté Discord active. Qwen Code est en forte croissance mais la communauté francophone reste embryonnaire.

Notre avis : l’outil qui rend le code agentique accessible hors écosystème fermé

Qwen Code a vraiment pris son envol en 2025-2026. Le rythme de releases est soutenu (une newsletter hebdomadaire « Qwen Code Weekly » détaille les nouveautés), la communauté de contributeurs grossit, l’intégration IDE s’étoffe. Au moment où je vous écris, c’est la seule alternative open source sérieuse à Claude Code et Codex.

La discontinuation du free tier le 15 avril 2026 est un revers pour la découverte facile de l’outil, mais elle le met sur un pied d’égalité avec ses concurrents propriétaires : plus personne n’offre vraiment du gratuit illimité en 2026 pour du code agentique premium. L’avantage relatif de Qwen Code reste intact : choix du provider, self-hosting possible, framework ouvert, compatibilité multi-modèle.

Pour un développeur indépendant ou une équipe tech moderne, tester Qwen Code en parallèle de votre outil actuel est un investissement minimal (1 heure d’installation et configuration) avec un upside important : soit vous découvrez qu’il couvre 80 % de vos besoins à moindre coût, soit vous obtenez une deuxième option pour diversifier votre stack. Dans les deux cas, c’est plus riche que de rester mono-outil.

Ce que cela change pour vous

Action concrète cette semaine : installez Qwen Code (15 minutes), configurez-le avec un provider gratuit pour le test — OpenRouter a souvent des crédits d’essai, sinon votre Ollama local suffit — et utilisez-le sur un projet personnel pendant 3 à 5 jours. Vous aurez une intuition claire de ce qu’il apporte par rapport à votre outil actuel.

Si vous venez de Claude Code, la transition est naturelle : les slash-commands sont similaires, le Plan Mode fonctionne de la même façon, les Skills ont la même structure. Vous garderez probablement les deux, en basculant selon le cas d’usage.

L’article suivant bascule sur la production : l’API Qwen et Model Studio pour intégrer Qwen dans des applications métier. Endpoint EU Francfort pour la conformité RGPD, tarification tiered, cache contextuel, fine-tuning LoRA, déploiement vLLM. C’est l’article destiné aux tech leads, architectes et CTOs qui veulent industrialiser Qwen dans leur stack.