Dépannage
Ce guide fournit des solutions aux problèmes courants et des conseils de débogage, notamment sur les sujets suivants :
- Erreurs d’authentification ou de connexion
- Questions fréquentes (FAQ)
- Conseils de débogage
- Problèmes GitHub existants similaires au vôtre ou création de nouveaux problèmes
Erreurs d’authentification ou de connexion
-
Erreur :
Qwen OAuth free tier was discontinued on 2026-04-15- Cause : L’authentification OAuth de Qwen n’est plus disponible depuis le 15 avril 2026.
- Solution : Passez à une autre méthode d’authentification. Exécutez
qwen→/authet choisissez l’une des options suivantes :
-
Erreur :
UNABLE_TO_GET_ISSUER_CERT_LOCALLY,UNABLE_TO_VERIFY_LEAF_SIGNATUREouunable to get local issuer certificate- Cause : Vous pourriez être sur un réseau d’entreprise avec un pare-feu qui intercepte et inspecte le trafic SSL/TLS. Cela nécessite souvent qu’un certificat CA racine personnalisé soit approuvé par Node.js.
- Solution : Définissez la variable d’environnement
NODE_EXTRA_CA_CERTSavec le chemin absolu du fichier du certificat d’autorité de certification (CA) racine de votre entreprise.- Exemple :
export NODE_EXTRA_CA_CERTS=/path/to/your/corporate-ca.crt
- Exemple :
-
Erreur :
Device authorization flow failed: fetch failed- Cause : Node.js n’a pas pu atteindre les points de terminaison OAuth de Qwen (souvent un problème de proxy ou de confiance SSL/TLS). Lorsqu’il est disponible, Qwen Code affiche également la cause sous-jacente de l’erreur (par exemple :
UNABLE_TO_VERIFY_LEAF_SIGNATURE). Remarque : cette erreur est spécifique à l’ancien flux OAuth de Qwen. - Solution :
- Si vous utilisez encore l’authentification OAuth de Qwen, passez à une clé API ou à Coding Plan via
/auth. - Si vous êtes derrière un proxy, configurez-le via
qwen --proxy <url>(ou le paramètreproxydanssettings.json). - Si votre réseau utilise un CA d’inspection TLS d’entreprise, définissez
NODE_EXTRA_CA_CERTScomme décrit ci-dessus.
- Si vous utilisez encore l’authentification OAuth de Qwen, passez à une clé API ou à Coding Plan via
- Cause : Node.js n’a pas pu atteindre les points de terminaison OAuth de Qwen (souvent un problème de proxy ou de confiance SSL/TLS). Lorsqu’il est disponible, Qwen Code affiche également la cause sous-jacente de l’erreur (par exemple :
-
Problème : Impossible d’afficher l’interface utilisateur après un échec d’authentification
- Cause : Si l’authentification échoue après la sélection d’un type d’authentification, le paramètre
security.auth.selectedTypepeut être conservé danssettings.json. Au redémarrage, la CLI peut rester bloquée en essayant de s’authentifier avec le type d’authentification ayant échoué et ne pas afficher l’interface utilisateur. - Solution : Supprimez l’élément de configuration
security.auth.selectedTypedans votre fichiersettings.json:- Ouvrez
~/.qwen/settings.json(ou./.qwen/settings.jsonpour les paramètres spécifiques au projet) - Supprimez le champ
security.auth.selectedType - Redémarrez la CLI pour qu’elle vous demande à nouveau une authentification
- Ouvrez
- Cause : Si l’authentification échoue après la sélection d’un type d’authentification, le paramètre
Questions fréquentes (FAQ)
-
Q : Comment mettre à jour Qwen Code vers la dernière version ?
- R : Si vous avez installé Qwen Code avec l’installateur autonome, réexécutez la commande d’installation autonome. Si vous l’avez installé globalement via
npm, mettez-le à jour avec la commandenpm install -g @qwen-code/qwen-code@latest. Si vous l’avez compilé à partir des sources, récupérez les dernières modifications du dépôt, puis reconstruisez avec la commandenpm run build.
- R : Si vous avez installé Qwen Code avec l’installateur autonome, réexécutez la commande d’installation autonome. Si vous l’avez installé globalement via
-
Q : Où sont stockés les fichiers de configuration de Qwen Code ?
-
R : La configuration de Qwen Code est stockée dans deux fichiers
settings.json:- Dans votre répertoire personnel :
~/.qwen/settings.json. - Dans le répertoire racine de votre projet :
./.qwen/settings.json.
Référez-vous à Configuration de Qwen Code pour plus de détails.
- Dans votre répertoire personnel :
-
-
Q : Pourquoi ne vois-je pas les nombres de tokens en cache dans ma sortie de statistiques ?
- R : Les informations sur les tokens en cache ne sont affichées que lorsque des tokens en cache sont utilisés. Cette fonctionnalité est disponible pour les utilisateurs de clé API (par exemple, clé API Alibaba Cloud Model Studio ou Google Cloud Vertex AI). Vous pouvez toujours consulter votre utilisation totale de tokens avec la commande
/stats.
- R : Les informations sur les tokens en cache ne sont affichées que lorsque des tokens en cache sont utilisés. Cette fonctionnalité est disponible pour les utilisateurs de clé API (par exemple, clé API Alibaba Cloud Model Studio ou Google Cloud Vertex AI). Vous pouvez toujours consulter votre utilisation totale de tokens avec la commande
Messages d’erreur courants et solutions
-
Erreur :
EADDRINUSE(Adresse déjà utilisée) lors du démarrage d’un serveur MCP.- Cause : Un autre processus utilise déjà le port auquel le serveur MCP essaie de se lier.
- Solution : Arrêtez l’autre processus qui utilise le port ou configurez le serveur MCP pour utiliser un autre port.
-
Erreur : Commande introuvable (en essayant d’exécuter Qwen Code avec
qwen).- Cause : La CLI n’est pas correctement installée ou elle n’est pas dans le
PATHde votre système. - Solution :
La mise à jour dépend de la façon dont vous avez installé Qwen Code :
- Si vous avez installé
qwenavec l’installateur autonome, réexécutez la commande d’installation autonome, puis ouvrez un nouveau terminal. - Si vous avez installé
qwenglobalement, vérifiez que le répertoire binaire global denpmse trouve dans votrePATH. Vous pouvez mettre à jour avec la commandenpm install -g @qwen-code/qwen-code@latest. - Si vous exécutez
qwenà partir des sources, assurez-vous d’utiliser la commande correcte pour l’invoquer (par exemplenode packages/cli/dist/index.js ...). Pour mettre à jour, récupérez les dernières modifications du dépôt, puis reconstruisez avec la commandenpm run build.
- Si vous avez installé
- Cause : La CLI n’est pas correctement installée ou elle n’est pas dans le
-
Erreur :
MODULE_NOT_FOUNDou erreurs d’import.- Cause : Les dépendances ne sont pas installées correctement, ou le projet n’a pas été construit.
- Solution :
- Exécutez
npm installpour vous assurer que toutes les dépendances sont présentes. - Exécutez
npm run buildpour compiler le projet. - Vérifiez que la construction a réussi avec
npm run start.
- Exécutez
-
Erreur : “Operation not permitted”, “Permission denied” ou similaire.
- Cause : Lorsque le sandboxing est activé, Qwen Code peut tenter des opérations qui sont restreintes par votre configuration de sandbox, comme l’écriture en dehors du répertoire du projet ou du répertoire temporaire système.
- Solution : Consultez la documentation Configuration : Sandboxing pour plus d’informations, y compris la personnalisation de votre configuration de sandbox.
-
Qwen Code ne s’exécute pas en mode interactif dans les environnements “CI”
- Problème : Qwen Code n’entre pas en mode interactif (aucune invite n’apparaît) si une variable d’environnement commençant par
CI_(par exempleCI_TOKEN) est définie. Cela est dû au fait que le packageis-in-ci, utilisé par le framework d’interface utilisateur sous-jacent, détecte ces variables et suppose un environnement CI non interactif. - Cause : Le package
is-in-civérifie la présence deCI,CONTINUOUS_INTEGRATIONou toute variable d’environnement avec un préfixeCI_. Lorsque l’une d’entre elles est trouvée, il signale que l’environnement est non interactif, ce qui empêche la CLI de démarrer en mode interactif. - Solution : Si la variable préfixée par
CI_n’est pas nécessaire au fonctionnement de la CLI, vous pouvez la désactiver temporairement pour la commande. Par exemple :env -u CI_TOKEN qwen
- Problème : Qwen Code n’entre pas en mode interactif (aucune invite n’apparaît) si une variable d’environnement commençant par
-
Le mode DEBUG ne fonctionne pas à partir du fichier .env du projet
- Problème : Définir
DEBUG=truedans un fichier.envdu projet n’active pas le mode débogage pour la CLI. - Cause : Les variables
DEBUGetDEBUG_MODEsont automatiquement exclues des fichiers.envdu projet pour éviter toute interférence avec le comportement de la CLI. - Solution : Utilisez plutôt un fichier
.qwen/.env, ou configurez le paramètreadvanced.excludedEnvVarsdans votresettings.jsonpour exclure moins de variables.
- Problème : Définir
-
Le défilement du trackpad dans tmux modifie l’historique des invites au lieu de faire défiler la conversation
- Problème : Dans une session tmux, le défilement du trackpad ou de la molette peut parcourir les invites précédentes, comme si vous appuyiez sur
Flèche HautouFlèche Bas. - Cause : tmux peut traduire les gestes de défilement en séquences simples de touches de direction. Ces séquences sont impossibles à distinguer des véritables pressions de touches directionnelles lorsque qwen-code les reçoit.
- Solution : Activez
ui.useTerminalBuffer; utilisez ensuiteShift+Flèche Haut/Shift+Flèche Bas, ou la molette de la souris lorsque tmux transfère les événements de défilement à l’application. Si vous préférez le défilement de l’hôte, ajustez vos liaisons de souris tmux pour les événements de défilement.
- Problème : Dans une session tmux, le défilement du trackpad ou de la molette peut parcourir les invites précédentes, comme si vous appuyiez sur
L’extension IDE Companion ne se connecte pas
- Assurez-vous que VS Code a un seul dossier de travail ouvert.
- Redémarrez le terminal intégré après avoir installé l’extension afin qu’il hérite de :
QWEN_CODE_IDE_WORKSPACE_PATHQWEN_CODE_IDE_SERVER_PORT
- Si vous exécutez dans un conteneur, vérifiez que
host.docker.internalest résolu. Sinon, mappez l’hôte de manière appropriée. - Réinstallez l’extension avec
/ide installet utilisez “Qwen Code: Run” dans la Palette de commandes pour vérifier qu’elle se lance.
Codes de sortie
Le code de sortie indique la raison de l’arrêt de Qwen Code. Ceci est particulièrement utile pour les scripts et l’automatisation.
| Code de sortie | Type d’erreur | Description |
|---|---|---|
| 41 | FatalAuthenticationError | Une erreur s’est produite lors du processus d’authentification. |
| 42 | FatalInputError | Une entrée invalide ou manquante a été fournie à la CLI. (mode non interactif uniquement) |
| 44 | FatalSandboxError | Une erreur s’est produite avec l’environnement de sandboxing (par exemple Docker, Podman ou Seatbelt). |
| 52 | FatalConfigError | Un fichier de configuration (settings.json) est invalide ou contient des erreurs. |
| 53 | FatalTurnLimitedError | Le nombre maximum de tours de conversation pour la session a été atteint. (mode non interactif uniquement) |
Conseils de débogage
-
Débogage de la CLI :
- Utilisez l’option
--verbose(si disponible) avec les commandes de la CLI pour une sortie plus détaillée. - Consultez les journaux de la CLI, souvent situés dans un répertoire de configuration ou de cache spécifique à l’utilisateur.
- Utilisez l’option
-
Débogage du cœur :
- Vérifiez la sortie de la console du serveur pour les messages d’erreur ou les traces de pile.
- Augmentez la verbosité des journaux si configurable.
- Utilisez les outils de débogage Node.js (par exemple
node --inspect) si vous devez parcourir le code côté serveur.
-
Problèmes d’outils :
- Si un outil spécifique échoue, essayez d’isoler le problème en exécutant la version la plus simple possible de la commande ou de l’opération que l’outil effectue.
- Pour
run_shell_command, vérifiez d’abord que la commande fonctionne directement dans votre shell. - Pour les outils du système de fichiers, vérifiez que les chemins sont corrects et vérifiez les autorisations.
-
Vérifications préalables :
- Exécutez toujours
npm run preflightavant de valider le code. Cela peut détecter de nombreux problèmes courants liés au formatage, au linting et aux erreurs de type.
- Exécutez toujours
Problèmes GitHub existants similaires au vôtre ou création de nouveaux problèmes
Si vous rencontrez un problème qui n’est pas couvert ici dans ce Guide de dépannage, envisagez de consulter le suivi des problèmes de Qwen Code sur GitHub . Si vous ne trouvez pas de problème similaire au vôtre, envisagez de créer un nouveau problème GitHub avec une description détaillée. Les pull requests sont également les bienvenues !