Qwen Code : installation terminal et modes de modification

La question ressemble à ceci : comment faire pour que Qwen fonctionne correctement dans la console et écrive du code tout seul ? Il y a généralement une déception derrière : quelqu’un a installé Qwen Code, posé une question, reçu du texte et un morceau de code en réponse qu’il a dû copier à la main, alors qu’on lui avait promis un agent qui entrerait dans le projet et ferait tout lui-même.

C’est exactement ce qu’est Qwen Code : un agent à part entière. Il peut ouvrir et modifier des fichiers, et exécuter des commandes tout seul. Le comportement dépend du mode actif : Ask Permissions demande confirmation, Auto-Edit et Auto permettent davantage d’autonomie. Vérifiez la ligne d’état sans supposer que le nom Default désigne le choix initial de l’installation. Voici, dans l’ordre : l’installation, le lancement dans un projet, la connexion à un modèle après les changements d’avril, puis le passage à un mode dans lequel l’agent modifie le code sans poser de questions inutiles. Tout a été vérifié à partir de la documentation officielle de Qwen au 30 août 2026.

Ressources pratiques sur les modèles et les agents : documentation Ailoot.

Que signifie « Qwen Code écrit du code tout seul » ?#

La différence est simple. Un chat dans le navigateur répond à une question par du texte. Vous lisez la réponse, copiez le code, le collez dans votre fichier, l’exécutez vous-même, repérez vous-même l’erreur et la renvoyez dans le chat. Vous faites la navette entre le chat et le projet.

Un agent fonctionne autrement. Vous lui donnez une tâche en langage courant : « ajoute un formulaire de commentaires », « corrige cette erreur ». Il examine alors la structure du projet, trouve les fichiers concernés, apporte les modifications et lance une vérification. La documentation le dit clairement : l’agent établit un plan, écrit du code et s’assure qu’il fonctionne.

C’est de là que vient la confusion dans la question. « Qwen n’écrit pas de code tout seul » signifie presque toujours l’une de ces deux choses : soit la personne a ouvert un chat dans le navigateur au lieu de l’agent dans le terminal, soit l’agent est lancé, mais configuré dans un mode où il demande l’autorisation pour chaque modification. Le premier problème se résout en installant Qwen Code ; le second, en changeant de mode. Les deux solutions sont présentées ci-dessous.

Comment installer Qwen Code dans le terminal ?#

La méthode la plus rapide consiste à utiliser l’installateur officiel, qui sélectionne automatiquement la version adaptée à votre système.

Sur macOS et Linux, ouvrez le terminal et collez cette ligne :

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

Sous Windows, faites de même avec cette commande PowerShell :

irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

La deuxième option est npm, si vous l’avez déjà installé. Elle nécessite Node.js version 22 ou ultérieure :

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

Après l’installation, redémarrez le terminal. L’installateur ajoute la commande qwen aux chemins système, mais le terminal ne la reconnaîtra pas avant son redémarrage — c’est la raison la plus courante du message « Je l’ai installé, mais il ne trouve pas la commande ». Pour vérifier que tout est bien installé, exécutez :

qwen --version

Si un numéro de version s’affiche, l’agent est installé et prêt à être lancé dans votre projet.

Comment lancer Qwen Code dans votre projet ?#

Commencez par accéder au dossier qui contient votre code. C’est important : l’agent travaille dans le dossier depuis lequel il a été lancé et n’en voit que le contenu.

cd path-to-your-project
qwen

L’interface de l’agent s’ouvrira directement dans le terminal. La première fois, il vous proposera de connecter un modèle ; cette étape est expliquée dans la section suivante. Une fois le modèle connecté, vous pouvez donner une tâche à l’agent en langage courant pour voir ce à quoi il peut accéder :

what does this project do?

L’agent lira les fichiers, comprendra la structure et vous donnera une réponse utile. Ensuite, vous pourrez lui demander d’écrire et de modifier du code : « ajoute un bouton de déconnexion », « divise ce fichier en deux », « trouve pourquoi le test échoue ». Il trouvera les endroits concernés et effectuera lui-même les modifications.

Il existe aussi une deuxième façon de le lancer, avec une seule commande et sans interface. C’est utile pour les scripts et les tâches automatisées :

qwen -p "reread README and update the list of commands"

L’agent exécute la tâche puis se ferme, sans conversation. Vous n’en avez pas besoin pour commencer, mais cela pourra vous être utile par la suite.

Pourquoi l’agent est-il lancé sans rien faire tout seul ?#

Le premier obstacle est l’accès au modèle. Auparavant, Qwen Code proposait un accès gratuit : vous vous connectiez avec un compte qwen.ai et l’agent fonctionnait sans carte bancaire. Cet accès s’appelait Qwen OAuth et a été supprimé. La documentation sur l’autorisation le dit explicitement : l’offre gratuite Qwen OAuth a été arrêtée le 15 avril 2026 ; les identifiants enregistrés auparavant peuvent continuer à fonctionner brièvement, mais le serveur rejette les nouvelles requêtes. L’option « se connecter avec qwen.ai » a également été retirée du menu.

Pour que l’agent puisse commencer à réfléchir à une tâche, vous devez donc connecter un modèle. La section suivante présente les options de connexion, payantes et locales gratuites.

La deuxième raison est moins évidente et plus frustrante. Le modèle est connecté, l’agent répond, mais il ne modifie aucun fichier : il montre seulement ce qu’il prévoit de faire et attend. Ce comportement est attendu dans Ask Permissions, qui demande confirmation avant modifications et commandes ; il ne prouve pas un mode initial universel. Pour qu’il travaille de manière autonome, vous devez changer de mode. C’est expliqué deux sections plus bas, où vous trouverez la réponse à la question d’origine.

Comment connecter un modèle maintenant que l’accès gratuit est fermé ?#

Dans l’agent, saisissez la commande :

/auth

Un menu proposant trois options principales s’ouvrira. Voici à quoi sert chacune d’elles.

Alibaba ModelStudio est l’option officielle des créateurs de Qwen. Elle propose un Coding Plan à prix fixe avec quota hebdomadaire pour un développeur individuel, un Token Plan avec facturation à l’usage pour les équipes, ainsi que la possibilité de connecter une clé ModelStudio existante. Il s’agit d’un accès payant au modèle « natif » de Qwen.

Les fournisseurs tiers vous permettent de choisir un fournisseur intégré et de le connecter avec une clé. La liste officielle comprend DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope et d’autres fournisseurs. Obtenez une clé auprès du fournisseur, saisissez-la, et l’agent utilisera le modèle de celui-ci.

Custom Provider permet de connecter votre propre serveur, proxy ou moteur local. C’est là que vous pouvez connecter un modèle qui fonctionne sur votre ordinateur via Ollama. Cette option prend en charge les formats OpenAI, Anthropic et Gemini ; elle fonctionne donc avec presque toutes les méthodes d’accès.

Vous pouvez également saisir la clé et les paramètres manuellement dans le fichier ~/.qwen/settings.json. Il contient le champ modelProviders (modèles disponibles), env (les clés elles-mêmes), security.auth.selectedType (le protocole à activer au démarrage) et model.name (le modèle par défaut). qwen démarrera alors avec ces paramètres et ne vous posera aucune question. Pour la première utilisation, il est plus simple de passer par /auth ; vous pourrez revenir au fichier lorsque vous voudrez enregistrer tous les paramètres.

Pour savoir ce qui est resté gratuit après avril, consultez l’article sur Qwen Code gratuit.

Quel mode activer pour que l’agent modifie du code tout seul ?#

Voici l’idée centrale : le mode d’accès détermine le degré d’autonomie de l’agent. Il existe cinq modes, du plus prudent au plus permissif.

Si l’agent vous montre seulement les modifications prévues et attend, il est probablement en mode Ask Permissions (appelé Default dans les anciennes versions). Vous devez alors confirmer manuellement chaque modification et chaque commande, ce qui donne l’impression que l’agent ne fait rien tout seul.

Pour qu’il modifie les fichiers sans vous demander confirmation, passez en mode Auto-Edit. Les modifications seront faites automatiquement, mais l’agent vous demandera toujours avant d’exécuter des commandes — une précaution raisonnable pour éviter d’exécuter rm au mauvais endroit par accident.

Auto utilise un évaluateur interne pour les actions nécessitant une évaluation. Choisissez-le explicitement après vérification de la version et de l’état actif ; le nom default conservé pour Ask Permissions est un alias de compatibilité, pas la preuve du mode initial.

YOLO est le mode le plus permissif. L’agent modifie des fichiers et exécute des commandes tout seul, sans rien demander. La documentation précise qu’il est réservé aux projets personnels de confiance et aux processus automatisés. Dans un projet professionnel, il est facile d’obtenir un résultat indésirable. Ne l’activez donc que l’esprit clair et, de préférence, sur une copie.

Comment changer de mode pendant une session ?#

Vous pouvez changer de mode au cours d’une tâche. Appuyez sur Shift+Tab pour passer au mode suivant. Sous Windows, la touche Tab standard fait la même chose. Le cycle est le suivant : Plan, confirmations, modifications automatiques, Auto, YOLO, puis retour à Plan.

Le mode actuel est toujours affiché dans la barre d’état en bas de l’interface. Prenez l’habitude de le vérifier avant de confier une tâche importante à l’agent, afin de ne pas lancer YOLO alors que vous vouliez simplement examiner un plan.

Une méthode adaptée aux débutants se déroule en trois étapes :

1. Lancez l’agent en mode Plan et demandez-lui d’analyser la tâche et de proposer un plan. Il ne touchera à rien : il lira le code et décrira uniquement ce qu’il a l’intention de faire.
2. Lisez le plan et, si vous êtes d’accord, passez en mode Auto-Edit ou Auto en appuyant sur Shift+Tab.
3. Demandez-lui de poursuivre. L’agent modifiera alors les fichiers tout seul pendant que vous surveillerez les résultats.

Cette approche répond à la principale crainte des débutants : que l’agent casse immédiatement tout. Vous examinez d’abord le plan dans un mode sûr, puis vous le laissez poursuivre.

L’approche complète du vibe coding repose sur la méthode ; l’outil vient en second. Qwen, Claude ou autre : le modèle sous-jacent peut être remplacé. Trois bases vous aident à conserver vos résultats lorsque vous changez de modèle : un clone d’IA, un Second Brain et l’ingénierie du contexte. Ensemble, ils produisent des résultats prévisibles ; cela n’a rien à voir avec la chance d’un essai isolé.

Un modèle local sans carte bancaire#

Installez un modèle ouvert sur votre ordinateur via Ollama ou vLLM, puis connectez-le comme Custom Provider depuis le menu /auth. L’agent utilisera alors un modèle installé sur votre propre machine plutôt que le cloud d’Alibaba. Aucune carte bancaire ni clé n’est nécessaire, et il n’y a pas de limite de requêtes. Pour découvrir quels modèles ouverts peuvent programmer, consultez cet aperçu des modèles de programmation gratuits.

Le compromis concerne le matériel. Un modèle qui écrit du code de manière assez satisfaisante nécessite beaucoup de mémoire vidéo. C’est envisageable sur un ordinateur de jeu équipé d’une carte graphique puissante, mais sur un ordinateur portable ordinaire, le modèle risque de ne pas tenir en mémoire. Ou bien il peut mettre si longtemps à réfléchir à chaque réponse qu’il devient plus simple de chercher une autre option.

L’exécution en local présente un autre avantage : la confidentialité des données. Tout votre code reste sur votre ordinateur ; rien n’est envoyé au serveur d’un tiers. Pour un projet sensible, cela compte davantage que l’économie réalisée sur un abonnement.

Comment éviter que l’agent abîme le projet ?#

Un agent autonome est pratique tant qu’il fait ce que vous lui demandez. Pour qu’un faux pas ne vous coûte pas cher, adoptez trois habitudes.

Premièrement, utilisez Git. Si le projet est sous contrôle de version, vous pouvez voir chaque modification de l’agent et les annuler. Sans Git, un agent autonome est réellement risqué : il modifie quelque chose, et il n’y a aucun moyen de restaurer la version précédente. Avec Git, un simple petit commandement suffit pour revenir en arrière.

Deuxièmement, commencez en mode Plan. Avant de confier une tâche importante à l’agent, demandez-lui d’établir un plan dans un mode où il ne touchera à rien. Lisez-le et comprenez ce que l’agent compte faire, puis passez aux modifications.

Troisièmement, soyez prudent avec YOLO. Dans ce mode, l’agent exécute des commandes tout seul, y compris celles qui suppriment des fichiers. C’est trop risqué pour un projet professionnel. Réservez YOLO aux copies de travail et aux petites tâches où une erreur n’aura pas d’importance.

Ces trois habitudes répondent à la principale crainte : « J’ai programmé en vibe coding et j’ai tout cassé. » Pour en savoir plus sur l’annulation des modifications en vibe coding, consultez cet autre aperçu. Il porte sur Claude Code, mais le principe d’utiliser Git est exactement le même.

Par où commencer pour votre tâche ?#

Voici la procédure complète sous forme de liste. Suivez les étapes dans l’ordre :

1. Installez Qwen Code avec une seule commande et redémarrez le terminal.
2. Accédez au dossier du projet avec cd et exécutez qwen.
3. Connectez un modèle via /auth : un forfait payant ou un modèle local via Ollama si le paiement par carte n’est pas une option.
4. Donnez une tâche à l’agent en mode Plan et lisez son plan.
5. Passez en mode Auto-Edit ou Auto avec Shift+Tab, puis laissez-le travailler.
6. Placez le projet sous Git afin de pouvoir annuler toute modification.

En bref, « Qwen n’écrit pas de code tout seul » signifie presque toujours qu’aucun modèle n’est connecté ou que l’agent est en mode confirmation. Résolvez le premier problème dans le menu /auth, et le second en appuyant sur Shift+Tab jusqu’à atteindre Auto-Edit. Ensuite, l’agent travaille effectivement tout seul dans le terminal.

Si vous souhaitez comparer Qwen à d’autres agents pour votre tâche, consultez cet aperçu des alternatives à Claude Code. Qwen y figure avec les autres, afin que vous puissiez voir lequel convient à chaque besoin.

L’approche complète du vibe coding repose sur la méthode, et l’agent spécifique vient en second : un clone d’IA plus un Second Brain plus l’ingénierie du contexte. Vous pouvez changer l’outil sous-jacent ; la méthode reste la même. Ressources pratiques : documentation Ailoot.

Autres ressources et outils : Ailoot.