Guide d'installation Qwen Code CLI : Configuration rapide Windows, macOS & Linux (2026)

Prérequis

Avant d'installer Qwen Code CLI (l'agent de codage IA officiel en ligne de commande, alimenté par les modèles Qwen), assurez-vous d'avoir les éléments suivants :

Node.js version 20 ou supérieure (recommandé : dernière version LTS). Téléchargez-le sur nodejs.org.
Un terminal ou une invite de commande avec des privilèges d'administrateur sur Windows.
Une connexion Internet pour télécharger les paquets et les modèles.
Facultatif mais recommandé : Git (pour une installation manuelle depuis les sources) et Homebrew sur macOS/Linux.

Vérifiez l'installation de Node.js :

node --version
npm --version

Le résultat attendu affiche des versions comme v20.x.x ou supérieures.

Étape 1 : Choisissez votre méthode d'installation

Qwen Code CLI offre plusieurs voies d'installation. Le script d'installation rapide est recommandé pour la plupart des utilisateurs car il gère automatiquement les dépendances.

Installation rapide (Recommandée)

Linux / macOS :

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

Windows (Exécutez l'invite de commande en tant qu'administrateur) :

curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat

Après l'exécution, redémarrez votre terminal pour actualiser le PATH.

Étape 2 : Installation manuelle via npm

Si vous préférez un contrôle manuel :

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

Ceci installe la commande qwen globalement.

Sur macOS/Linux avec sudo (si des problèmes de permissions surviennent) :

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

Étape 3 : Installation via Homebrew (macOS & Linux)

brew install qwen-code

Étape 4 : Vérifiez l'installation

Exécutez la commande suivante pour confirmer une installation réussie :

qwen --version

Vous devriez voir un résultat similaire à :

Qwen Code CLI v0.x.x

Étape 5 : Premier lancement et authentification

Lancez le CLI interactif :

qwen

Lors du premier lancement, le CLI vous demandera de vous authentifier avec votre compte Qwen (ouvre le navigateur pour une connexion en un clic). Après la connexion, il applique les paramètres par défaut et entre dans l'interface utilisateur terminal interactive.

Naviguez d'abord vers le répertoire de votre projet pour de meilleurs résultats :

cd /chemin/vers/votre/projet
qwen

À l'intérieur de la session, utilisez des commandes comme /help, /model pour changer de modèle, ou référencez des fichiers avec @nomdefichier.

Étape 6 : Installation manuelle depuis les sources (Avancée)

Pour les développeurs voulant les derniers changements non publiés :

git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code
npm install
npm install -g .

Ensuite, vérifiez avec qwen --version.

Problèmes Courants & Dépannage

Commande 'qwen' introuvable : Redémarrez votre terminal ou exécutez hash -r (Linux/macOS). Sous Windows, fermez et rouvrez l'Invite de Commandes. Assurez-vous que le répertoire bin global de Node.js est dans votre variable d'environnement PATH.
Erreurs de permission pendant npm install : Utilisez sudo sur Linux/macOS ou exécutez l'Invite de Commandes en tant qu'Administrateur sur Windows.
Version de Node.js trop ancienne : Mettez à jour vers Node 20+ en utilisant nvm ou l'installateur officiel.
Problèmes réseau avec les ressources Aliyun : Essayez la méthode npm en solution de repli.
Échec de l'installation sur Termux ou certaines distributions Linux : Utilisez l'option --ignore-scripts : npm install -g @qwen-code/qwen-code@latest --ignore-scripts.
Authentification non fonctionnelle : Assurez-vous que votre navigateur autorise les pop-ups et que vous possédez un compte Qwen valide.

Pour les problèmes persistants, consultez le dépôt GitHub officiel : https://github.com/QwenLM/qwen-code.

Prochaines Étapes

Explorez l'interface interactive : Tapez /help pour voir les commandes barre oblique disponibles.
Essayez la programmation agentique : Demandez à la CLI de refactoriser du code, d'expliquer des fichiers ou d'automatiser des tâches en utilisant le langage naturel.
Configurez les modèles : Utilisez /model pour sélectionner Qwen3-Coder ou d'autres moteurs pris en charge (y compris Ollama en local).
Intégrez avec VS Code : Installez l'extension Qwen Code Companion pour une intégration transparente avec l'éditeur.
Personnalisez les paramètres : Modifiez ~/.qwen/settings.json pour les thèmes, les modèles par défaut et les options avancées.

Vous êtes maintenant prêt à utiliser Qwen Code CLI comme un puissant programmeur pair IA directement dans votre terminal. Commencez par des invites simples comme "Expliquez cette base de code" ou "Refactorisez cette fonction pour de meilleures performances" à l'intérieur de votre dossier de projet.

Bon codage !