Live 18/11 · Cohorte 318 nov à 19h00 MSK — atelier pratique gratuit sur les agents IA · La Cohorte 3 démarre le 23/11Atelier 18/11 →Cohorte 3 (23/11)
SortieCode / SDK · Prêt à l'emploiHabr AI→ original

Configurer Qwen Code : QWEN.md, sous-agents et bac à sable pour ne plus gaspiller de tokens

Une fois installé, Qwen Code réexplore le dépôt à chaque session et redemande ce qu'on pourrait lui dire une seule fois, et c'est vous qui payez ces échanges en tokens. Il ne sait pas, par exemple, que le projet installe ses paquets avec pnpm et non avec npm, et il pose la question à chaque fois. Ces commandes et ces interdits s'écrivent dans le fichier QWEN.md, que l'agent lit au début de la session. Cette analyse, établie pour la version 0.28.0, présente six réglages qui réduisent le nombre de questions et les dépenses.

Traité par IA depuis Habr AI ; édité par Hamidun News
Configurer Qwen Code : QWEN.md, sous-agents et bac à sable pour ne plus gaspiller de tokens
Source : Habr AI. Collage: Hamidun News.
Écouter l'article
Fiche synthèse et chiffres clés
ParamètreDonnées
Source primaireHabr AI ↗
Rédacteur en chef
QWEN.md est envoyé à chaque requêteune ligne superflue se paie donc de nombreuses fois
Chiffre clé #2Le mode Auto fait vérifier chaque commande par un modèle : définissez-en un économique via /model --fast
Chiffre clé #3Un sous-agent relecteur sans write_file ni edit ne pourra physiquement pas modifier le code

Une fois installé, Qwen Code fonctionne « tel quel » : il réexplore le dépôt à chaque session, redemande sans cesse la même chose et dépense des tokens pour des informations qu'on aurait pu lui donner une seule fois. Imaginez un projet où les paquets s'installent avec pnpm et non avec npm, et où les tests se lancent par une commande particulière. L'agent l'ignore : à chaque session, soit il pose la question, soit il devine.

Ces informations s'écrivent une fois pour toutes dans le fichier QWEN.md, un aide-mémoire permanent du projet que l'agent lit au début de chaque session. Cette analyse a été vérifiée d'après la documentation de Qwen Code version 0.

28.0 (novembre 2026) et couvre six réglages : QWEN.md, les règles, les modes de confirmation, les serveurs MCP (outils externes), les sous-agents (assistants spécialisés aux droits restreints) et le bac à sable (isolation des commandes de l'agent).

L'objectif est simple : que l'agent pose moins de questions, consomme moins et ne puisse pas causer de dégâts par accident. Le projet évolue vite : avec une autre version, vérifiez avec qwen --help.

Mémoire et règles : le dire une seule fois

Les réglages se trouvent à deux endroits : ~/.qwen/settings.json s'applique à vous dans tous les projets, tandis que .qwen/settings.json à la racine du dépôt ne vaut que pour ce projet et peut être commité pour que toute l'équipe en dispose. Inutile d'y mettre les clés API : des variables d'environnement ou les paramètres utilisateur existent pour cela.

QWEN.md est un simple fichier Markdown. Il peut y en avoir trois, et tous sont chargés en même temps : ~/.qwen/QWEN.md pour vous dans tous les projets, QWEN.md à la racine pour toute l'équipe, et .qwen/QWEN.local.md pour vous seul dans ce projet. Le fichier local est chargé après le fichier commun : il permet donc de compléter ou de remplacer les instructions d'équipe. Il faudra l'ajouter vous-même au .gitignore. Si le dépôt contient déjà un AGENTS.md destiné à d'autres outils d'IA, Qwen Code le lira aussi.

Le plus rapide pour démarrer est la commande /init : elle analyse le code et crée un brouillon avec les commandes de build et les conventions détectées. La règle d'or : rester court et concret. La documentation prévient que plus le fichier est long, moins le modèle le suit fidèlement. La consigne « utilise une indentation de 2 espaces en TypeScript » fonctionne ; « écris du code propre » ne fonctionne pas. De plus, QWEN.md est envoyé dans chaque requête de chaque session : chaque ligne superflue représente des tokens que vous payez de nombreuses fois.

En plus du fichier, il existe une mémoire automatique : Qwen Code enregistre lui-même des notes dans ~/.qwen/projects/<projet>/memory/. La commande /remember mémorise immédiatement, /forget supprime, /memory affiche les fichiers chargés. Mais la mémoire automatique fonctionne « dans la mesure du possible » : écrivez donc l'essentiel dans QWEN.md.

Quand le fichier enfle, on déplace une partie des instructions vers des règles, des fichiers Markdown placés dans .qwen/rules/. Une règle possède un champ paths: par exemple, 'src/*/.tsx'. Les instructions sur React n'entrent alors dans le contexte que lorsque l'agent ouvre un fichier correspondant. Tant qu'il modifie un Makefile, elles n'occupent aucune place. Une règle sans paths fonctionne comme QWEN.md. Les règles de projet ne sont chargées que si vous faites confiance au dossier (trusted folder).

Confirmations, MCP et sous-agents

Il existe cinq modes de confirmation : Plan (lecture seule), Ask Permissions (demande confirmation pour les modifications comme pour les commandes), Auto-Edit (modifie les fichiers seul, exécute les commandes avec votre accord), Auto (c'est un classifieur qui décide) et YOLO (tout en autonomie, uniquement dans un environnement isolé). On bascule avec Shift+Tab (Tab sous Windows) ou /approval-mode. Dans les versions récentes, Auto est le mode par défaut : chaque commande, accès réseau ou appel d'outil MCP est évalué par un modèle classifieur distinct.

Ce sont des requêtes supplémentaires à l'API. Si aucun modèle rapide n'est défini, c'est le modèle principal qui est utilisé, et chaque vérification coûte autant qu'une requête complète. Définissez donc un modèle économique avec /model --fast ou via "fastModel" dans les réglages, ou passez en Auto-Edit.

Les autorisations ciblées se définissent dans le bloc permissions : allow s'exécute sans question (par exemple git status et pnpm test), ask demande toujours confirmation (git push), deny interdit totalement (rm -rf et la lecture de .env). Le fichier .qwenignore, comme .agentignore ou .aiignore, fonctionne comme un .gitignore et économise du contexte, mais il ne protège pas les secrets : tous les outils n'en tiennent pas compte.

MCP (Model Context Protocol) est un standard ouvert pour connecter des bases de données, des trackers et de la documentation. Un serveur s'ajoute avec la commande qwen mcp add ; le drapeau --scope project l'enregistre dans les réglages du projet. Pour les services distants, le transport recommandé est http ; pour les programmes locaux et Docker, stdio ; sse est obsolète. Les descriptions des outils occupent aussi du contexte : ne connectez donc que le nécessaire et limitez l'ensemble via includeTools ou excludeTools.

Un sous-agent est un assistant distinct, avec ses propres instructions, ses outils et son contexte. Il peut lire cent fichiers, et l'agent principal n'en reçoit que le résultat. Les fichiers se trouvent dans .qwen/agents/ (ceux du projet sont prioritaires) ou ~/.qwen/agents/. Un relecteur configuré avec model: fast et les outils read_file, grep_search, glob et run_shell_command ne peut pas modifier le code, car il n'a ni write_file ni edit. La restriction fiable, c'est la liste tools, pas approvalMode : si la session principale tourne en YOLO, un sous-agent configuré en plan se retrouvera quand même en YOLO.

Bac à sable : ce que l'agent pourra faire sans même demander

Les modes déterminent si l'agent demande une confirmation ; le bac à sable détermine ce qu'il pourra faire même s'il n'a rien demandé. Si vous travaillez ne serait-ce qu'occasionnellement en Auto ou en YOLO, il vous en faut un. Les dernières versions pour Linux proposent un mode où Qwen Code lui-même fonctionne normalement, tandis que les commandes et les opérations sur les fichiers de l'agent s'exécutent en isolation via bwrap (Bubblewrap).

Commencez par /init, raccourcissez QWEN.md, déplacez les instructions spécifiques vers des règles, définissez /model --fast, répartissez les commandes entre allow et deny, créez un relecteur en lecture seule et activez le bac à sable.

Dossier

Questions clés sur cet article

Que sait-on sur Mémoire et règles : le dire une seule fois ?

Les réglages se trouvent à deux endroits : ~/.qwen/settings.json s'applique à vous dans tous les projets, tandis que .qwen/settings.json à la racine du dépôt ne vaut que pour ce projet et peut être commité pour que toute l'équipe en dispose. Inutile d'y mettre les clés API : des variables d'environnement ou les paramètres utilisateur existent pour cela. QWEN.md est un simple fichier Markdown.

Que sait-on sur Confirmations, MCP et sous-agents ?

Il existe cinq modes de confirmation : Plan (lecture seule), Ask Permissions (demande confirmation pour les modifications comme pour les commandes), Auto-Edit (modifie les fichiers seul, exécute les commandes avec votre accord), Auto (c'est un classifieur qui décide) et YOLO (tout en autonomie, uniquement dans un environnement isolé). On bascule avec Shift+Tab (Tab sous Windows) ou /approval-mode.

Que sait-on sur Bac à sable : ce que l'agent pourra faire sans même demander ?

Les modes déterminent si l'agent demande une confirmation ; le bac à sable détermine ce qu'il pourra faire même s'il n'a rien demandé. Si vous travaillez ne serait-ce qu'occasionnellement en Auto ou en YOLO, il vous en faut un. Les dernières versions pour Linux proposent un mode où Qwen Code lui-même fonctionne normalement, tandis que les commandes et les opérations sur les fichiers de l'agent s'exécutent en isolation via bwrap (Bubblewrap).

ZK
Zhemal Khamidun — CPO d'Alpina Digital, product manager d'AlpinaGPT. Conçoit des produits IA depuis 2019. Hamidun News est un projet personnel devenu un agrégateur en production avec plus de 6 000 lecteurs.
✦ Unified AI Workspace · Nomad

Test Frontier LLMs & Autonomous Agents in One Workspace

Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.

Try Nomad AI →Launch Nomad Agent
Qu'en pensez-vous ?
Chargement des commentaires…