# Comment installer Qwen Code CLI : Tutoriel étape par étape pour l'agent d'intelligence artificielle de codage en terminal

Apprenez à installer Qwen Code CLI, l'agent d'IA de codage open-source pour votre terminal. Instructions étape par étape pour npm, script d'installation rapide, Homebrew et dépannage sur Windows, macOS et Linux.

Canonical URL: https://a2a-mcp.org/blog/qwen-cli-install-fr

Language: fr

Published: 2026-04-07

Updated: 2026-04-07

## 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](https://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** :

```bash
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
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)** :

```cmd
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 :

```bash
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) :

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

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

```bash
brew install qwen-code
```

## Étape 4 : Vérifiez l'installation

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

```bash
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 :

```bash
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 :

```bash
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 :

```bash
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 !