Qwen Code et Qwen 3.7-max : configurer le Token Plan
MarkdownInstaller Qwen Code avec Node.js 22, connecter le Token Plan international et éviter trois pièges qui provoquent des erreurs 401 : l’adresse de l’API, la clé et l’attribution du siège.
Lire l’article complet
Documentation de référence d’Ailoot : ailoot.ai/docs/.
Mis à jour le 03.10.2026 : trois choses ont changé depuis la publication. Alibaba a fermé le Coding Plan aux nouveaux achats : l’offre Lite dès mars, et l’offre Pro est épuisée. Le Token Plan est passé d’un quota hebdomadaire à un quota mensuel. Un modèle plus récent, Qwen3.8-max, est sorti. J’ai également corrigé une erreur dans la description de la clé Token Plan : elle est importante pour cette erreur 401, et je l’explique ci-dessous.
Qu’est-ce que Qwen Code, et pourquoi n’est-ce pas juste une copie de plus ?
À retenir
Qwen Code est un agent IA open source pour terminal, créé par Alibaba, qui fonctionne comme Claude Code : il s’exécute dans le terminal de VS Code, lit votre projet, écrit du code et lance des commandes. La différence essentielle : l’accès à une douzaine de modèles avec un seul abonnement, dont Qwen 3.7, DeepSeek V4 et Kimi K2.
Quand j’ai entendu parler de Qwen Code pour la première fois, je me suis dit : « Encore un clone de Claude Code qui va planter au deuxième prompt. » Je me trompais. Alibaba n’a pas copié l’interface : l’entreprise a créé son propre agent CLI de zéro, avec une compatibilité complète avec l’API OpenAI. Cela signifie que vous pouvez y exécuter non seulement des modèles Qwen, mais aussi DeepSeek, GLM, Kimi et même Claude via l’API Anthropic.
Voici ce qu’il sait vraiment faire :
- Il lit la structure du projet et en comprend le contexte (comme Claude Code avec
CLAUDE.md) - Il exécute des commandes shell, modifie des fichiers et crée des commits
- Il prend en charge les Skills et les SubAgents
- Il fonctionne dans VS Code via le terminal intégré ou une extension
- Il permet de passer d’un modèle à l’autre avec une seule commande
/model
Il y a un inconvénient, mais il est de taille : l’offre gratuite a pris fin le 15.04.2026. Auparavant, Qwen OAuth offrait 100 requêtes gratuites par jour ; désormais, seules les options payantes subsistent. Mais même payant, Qwen Code coûte nettement moins cher qu’un abonnement Claude Pro. Si vous hésitez actuellement entre plusieurs outils, j’ai passé en revue toutes les options dans le guide « Avec quoi coder en 2026 : 8 outils d’IA ».
Combien ça coûte, et quelle offre choisir ?
À retenir
Alibaba propose trois options de paiement : le paiement au token, l’abonnement Coding Plan et l’abonnement Token Plan. Pour coder au quotidien avec l’IA, le Token Plan offre le meilleur rapport qualité-prix : un montant mensuel fixe, plus de 10 modèles et aucun token à compter.
La confusion autour des offres est le principal casse-tête de la configuration de Qwen Code. Alibaba utilise des noms différents selon les sections de la console, et même l’extension VS Code affiche les mauvaises options. Voici comment cela fonctionne réellement (vérifié dans la documentation Alibaba Cloud, mise à jour le 28.09.2026).
| Offre | Description | Pour qui | Coût approximatif |
|---|---|---|---|
| Pay-as-you-go | Vous payez séparément chaque million de tokens | Usage occasionnel, pour essayer | 0,30–1,20 $ par million de tokens |
| Coding Plan | Un abonnement individuel avec un quota mensuel (le quota hebdomadaire a été supprimé le 22.09.2026) | Actuellement indisponible pour les nouveaux abonnés : l’offre Lite n’est plus disponible à l’achat depuis le 20.03.2026, et l’offre Pro est épuisée | Actuellement indisponible pour les nouveaux comptes |
| Token Plan Team Edition, Standard Seat | 25 000 Credits par siège et par mois, plus de 10 modèles | Pour coder au quotidien avec l’IA et changer de modèle | 20 $/siège par mois en promotion (prix habituel : 30 $) |
D’après l’expérience décrite par l’auteur, le Token Plan a été choisi parce qu’un seul abonnement donne accès à Qwen 3.7-max (et au nouveau Qwen3.8-max), DeepSeek V4 Pro et GLM-5. Tous les modèles utilisent le même pool de Credits. Passez de l’un à l’autre avec la commande /model : vous n’avez pas besoin d’acheter une clé distincte pour chaque fournisseur.
Important : le Coding Plan et le Token Plan sont deux produits différents, avec des adresses d’API différentes. Une clé Coding Plan commence par sk-sp-. Une clé Token Plan n’a aucun préfixe : c’est ainsi que la documentation officielle de Qwen Code la décrit. Si vous confondez l’adresse ou la clé de ces deux produits, vous obtiendrez une erreur 401. Et puisque le Coding Plan n’est plus disponible à l’achat, le Token Plan est actuellement la seule option fonctionnelle pour la plupart des lecteurs.
Comment installer Qwen Code ?
À retenir
Deux possibilités : via npm (npm install -g @qwen-code/qwen-code@latest) ou Homebrew (brew install qwen-code). Il vous faut Node.js 22 ou une version ultérieure. Après l’installation, lancez qwen dans le terminal.
Vérifiez votre version de Node.js avant l’installation :
node --version
Il vous faut la version 22 ou ultérieure. Si vous avez une version plus ancienne, mettez-la à jour depuis nodejs.org ou avec nvm :
nvm install 22
nvm use 22
Installez ensuite Qwen Code avec une commande :
npm install -g @qwen-code/qwen-code@latest
Ou utilisez Homebrew sur macOS :
brew install qwen-code
Vérifiez l’installation :
qwen --version
Si une version s’affiche, vous êtes prêt. Lancez Qwen Code en tapant qwen dans le terminal. Dans VS Code, ouvrez le terminal intégré (Ctrl+) et tapez qwen`.
Il existe également une extension VS Code, Qwen Code Companion par QwenLM, dans le Marketplace. Elle ajoute une barre latérale de chat, comme GitHub Copilot. C’est celle que j’utilise : elle est plus pratique que le terminal seul.
Comment créer un compte et acheter le Token Plan ?
À retenir
Inscrivez-vous sur la console internationale Alibaba Cloud (modelstudio.console.alibabacloud.com), ajoutez une carte acceptée par le fournisseur et souscrivez au Token Plan. La procédure prend 10 minutes.
Étape par étape :
- Allez sur modelstudio.console.alibabacloud.com
- Cliquez sur Free Sign Up, en haut à droite
- Saisissez votre adresse e-mail (Gmail fonctionne) et confirmez le code reçu dans votre boîte de réception
- Ajoutez votre numéro de téléphone
- Ajoutez une carte acceptée par le fournisseur. Alibaba prélèvera 1 $ pour la vérifier, puis vous remboursera sous 1–3 jours.
- Dans la console, repérez la section ModelStudio, puis l’onglet Token Plan
- Choisissez l’offre Standard (l’offre minimale pour commencer)
- Confirmez le paiement
Après l’achat, vous arriverez sur la page My Subscriptions. Vous y verrez :
- Standard Seat: 0/1 : cela signifie que vous avez acheté un siège, mais que vous ne vous l’êtes pas encore attribué
- Cliquez sur Assign, sélectionnez votre compte et confirmez
- L’indicateur devrait passer à 1/1
La clé API ne fonctionnera pas sans cette étape. D’après l’expérience de l’auteur, celle-ci lui a pris 20 minutes.
Où trouver la clé API et la bonne adresse ?
À retenir
La clé API et l’adresse de l’API (Base URL) se trouvent sur la page Management Platform. Pour le Token Plan international, l’adresse est https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Ne la confondez pas avec l’adresse DashScope habituelle : la clé Token Plan n’y fonctionnera pas.
Sur la page My Subscriptions, cliquez sur le grand bouton violet Go to Management Platform. Un panneau distinct s’ouvrira.
Sélectionnez Overview dans le menu de gauche. Cette page contient deux sections :
Plan-specific API Key : votre clé personnelle. Elle est masquée par des astérisques. Cliquez sur l’icône de copie à côté (ne la sélectionnez pas avec la souris : les astérisques seraient copiés). Les clés Token Plan n’ont pas de préfixe. Ce n’est pas une faute dans les instructions : c’est ainsi que les décrit la documentation officielle de Qwen Code. Si vous voyez sk-sp-, c’est une clé Coding Plan, associée à un autre produit : vous avez copié la mauvaise clé.
Plan-specific Base URL : deux options :
- Pour les outils compatibles avec OpenAI (Qwen Code) :
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - Pour les outils compatibles avec Anthropic :
https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
N’oubliez pas : seules ces adresses fonctionnent avec une clé Token Plan. L’adresse standard dashscope-intl.aliyuncs.com est destinée aux clés habituelles (Pay-as-you-go), tandis que coding-intl.dashscope.aliyuncs.com est l’adresse du Coding Plan. Une clé Token Plan utilisée avec l’une ou l’autre renverra une erreur 401.
Comment connecter Qwen Code à VS Code ?
À retenir
Configurez l’extension VS Code à l’aide du fichier ~/.qwen/settings.json. Vous devez indiquer la clé, l’adresse API correcte et le modèle. Voici une configuration prête à l’emploi : copiez-la et remplacez la clé par la vôtre.
Si vous avez installé l’extension Qwen Code Companion depuis le Marketplace VS Code :
- Ouvrez la palette de commandes (Cmd+Shift+P)
- Tapez Qwen Code: Choose Provider
- Si un menu d’options s’affiche, ne choisissez pas Coding Plan (il s’agit d’un autre produit). Choisissez Standard API Key
- Collez la clé de la Management Platform : les clés Token Plan n’ont pas de préfixe fixe
- Région : Singapour
- Modèle :
qwen3.7-max
Si une erreur survient ensuite, configurez l’extension manuellement dans le fichier. Il arrive que l’extension renseigne la mauvaise adresse.
Ouvrez ou créez le fichier ~/.qwen/settings.json et collez-y ceci :
{
"env": {
"TOKEN_PLAN_API_KEY": "YOUR-KEY-FROM-MANAGEMENT-PLATFORM"
},
"modelProviders": {
"openai": [
{
"id": "qwen3.7-max",
"name": "qwen3.7-max",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": { "enable_thinking": true },
"contextWindowSize": 262144
}
},
{
"id": "qwen3.6-plus",
"name": "qwen3.6-plus",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": { "enable_thinking": true },
"contextWindowSize": 1000000
}
},
{
"id": "deepseek-v4-pro",
"name": "deepseek-v4-pro",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"extra_body": { "enable_thinking": true },
"contextWindowSize": 1000000
}
}
]
},
"security": {
"auth": { "selectedType": "openai" }
},
"model": { "name": "qwen3.7-max" }
}
Remplacez YOUR-KEY-FROM-MANAGEMENT-PLATFORM par votre clé obtenue sur la Management Platform. Redémarrez VS Code. C’est terminé.
Pourquoi une erreur 401 apparaît-elle, et comment la corriger ?
À retenir
Dans 90 % des cas, une erreur 401 lors de la configuration de Qwen Code signifie que l’adresse API ou la clé est incorrecte. Token Plan, Coding Plan et Pay-as-you-go utilisent des adresses différentes, et leurs clés ne sont pas interchangeables.
L’auteur décrit les erreurs rencontrées pendant la configuration. Voici la liste complète des causes d’erreurs 401 et les vérifications à effectuer :
| Symptôme | Cause | Solution |
|---|---|---|
invalid_api_key | Une clé Token Plan est envoyée à l’adresse DashScope (ou inversement) | Vérifiez la Base URL. Pour Token Plan : token-plan.ap-southeast-1... ; pour Coding Plan : coding-intl.dashscope... |
invalid access token | Le Standard Seat n’a pas été attribué (0/1) | Allez dans My Subscriptions, cliquez sur Assign ; le statut devrait indiquer 1/1 |
invalid_api_key | L’extension VS Code a créé sa propre clé via le processus d’authentification, au lieu d’utiliser Token Plan | Ouvrez ~/.qwen/settings.json et vérifiez que la clé correspond à celle affichée sur la Management Platform (ne la confondez pas avec la clé Coding Plan, qui commence par sk-sp-) |
invalid_api_key | Un espace ou un saut de ligne a été copié avec la clé | Supprimez la clé et copiez-la à nouveau avec l’icône de copie (ne la sélectionnez pas avec la souris) |
model not found | Votre offre n’inclut pas le modèle | Vérifiez la liste Available Models sur la page d’abonnement |
Insufficient quota | Vous n’avez plus de Credits | Vérifiez la rubrique Usage dans My Subscriptions. Si le taux est à 100 %, attendez la réinitialisation ou achetez un Boost Pack |
Vérification rapide de la clé dans le terminal :
curl -s -o /dev/null -w "%{http_code}" -X POST \
"https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen3.7-max","messages":[{"role":"user","content":"hi"}],"max_tokens":5}'
Si la réponse est 200, la clé fonctionne et le problème vient des paramètres de l’extension. Si la réponse est 401, la clé ou l’adresse est incorrecte.
Quels modèles sont disponibles, et lequel choisir ?
À retenir
Token Plan propose plus de 10 modèles de 5 fournisseurs ; le nouveau modèle phare Qwen3.8-max a été ajouté en août 2026. Pour coder avec l’IA, le modèle polyvalent principal est qwen3.6-plus (un équilibre entre prix et qualité). Pour les tâches complexes, utilisez qwen3.7-max ou le plus récent qwen3.8-max. Pour les modifications rapides, choisissez qwen3.6-flash.
Voici les modèles vraiment utiles pour coder avec l’IA :
| Modèle | Utilisation | Consommation de Credits |
|---|---|---|
| qwen3.8-max | Le nouveau modèle phare d’Alibaba (sorti en août 2026), qualité maximale pour les tâches complexes | Élevée : les Credits s’épuisent plus vite qu’avec 3.7-max |
| qwen3.7-max | Architecture complexe, refactorisation d’un grand projet, génération à partir de zéro | Élevée : le quota s’épuise en une semaine si vous codez tous les jours |
| qwen3.6-plus | Modèle polyvalent au quotidien : modifications, améliorations, revues, explications | Moyenne : suffisant pour un mois à raison de 2–4 heures par jour |
| qwen3.6-flash | Modifications rapides, questions simples, mise en forme | Faible |
| deepseek-v4-pro | Une alternative à Qwen : parfois meilleure pour les tâches algorithmiques et les mathématiques | Moyenne |
| kimi-k2.6 | Long contexte : lecture de grandes bases de code, analyse de documentation | Moyenne |
Passez d’un modèle à l’autre directement dans votre session Qwen Code avec la commande /model : pas besoin de modifier les paramètres ni de redémarrer.
Je commencerais par qwen3.6-plus. Si, au bout d’une semaine, vous constatez que le quota s’épuise trop vite, utilisez qwen3.6-flash pour les tâches courantes et réservez qwen3.7-max aux tâches complexes.
Qwen Code ou Claude Code : lequel choisir ?
À retenir
Claude Code produit un meilleur code et comprend mieux le contexte. Qwen Code coûte moins cher et donne accès à plusieurs modèles avec un seul abonnement. La combinaison idéale : Claude Code pour le travail principal, Qwen Code pour les tâches en parallèle et les expérimentations.
Cette comparaison s’appuie sur le mois de travail de l’auteur avec ces deux outils :
| Critère | Claude Code | Qwen Code |
|---|---|---|
| Qualité du code | Meilleure : Anthropic a depuis sorti de nouveaux modèles (Opus 5.5, 22.09.2026) ; l’écart ne s’est pas réduit | Bonne, mais même le nouveau modèle phare Qwen3.8-max reste derrière les meilleurs modèles d’Anthropic dans des tests indépendants |
| Compréhension du projet | CLAUDE.md + lecture approfondie de l’arborescence = fonctionne comme une personne | Mécanismes similaires, mais moins aboutis |
| Prix | Claude Pro : 20 $/mois (Max : 100–200 $/mois pour coder intensivement) | Token Plan Standard à partir de 20 $/mois, avec plus de 10 modèles |
| Choix des modèles | Claude seulement (Opus/Sonnet/Haiku) | Qwen + DeepSeek + GLM + Kimi + MiniMax |
| Open source | Non (source fermée) | Oui (licence MIT) |
| Extension VS Code | Native, stable | Disponible, mais encore rudimentaire : elle présente parfois des problèmes de clé |
Quand Qwen Code est un meilleur choix :
- Vous avez besoin d’accéder à plusieurs modèles (DeepSeek pour les mathématiques, Kimi pour le long contexte)
- Vous testez différentes approches pour une même tâche
- Votre budget est limité, mais vous codez tous les jours
- Vous voulez un outil open source que vous pouvez personnaliser
Quand Claude Code est indispensable :
- Pour un projet critique où la qualité du code équivaut à de l’argent
- Pour travailler sur un grand projet ancien (Opus conserve mieux le contexte) : j’ai aussi expliqué comment éviter d’épuiser les limites de Claude Code
- Si vous avez besoin d’une extension VS Code stable sans configuration manuelle
La combinaison décrite par l’auteur : Claude Code pour le projet principal, Qwen Code pour les expérimentations et les tâches en parallèle, où vous pouvez rapidement essayer une idée avec un modèle moins cher. Pour une comparaison détaillée avec d’autres outils, consultez Cursor vs Claude Code et Codex vs Claude Code.
Trois pièges que tout le monde rencontre
À retenir
Token Plan et Coding Plan sont des produits différents avec des adresses différentes. L’extension VS Code renseigne la mauvaise clé. Vous devez attribuer le siège manuellement. Ces trois pièges peuvent faire perdre de 30 minutes à plusieurs heures : j’ai rencontré les trois et consigné les solutions.
Piège 1 : Token Plan ≠ Coding Plan
Alibaba désigne ces produits par des noms différents selon les sections de la console. L’option « Coding Plan » dans l’extension VS Code n’est pas le Token Plan. À retenir : depuis le 20.03.2026, le Coding Plan Lite n’est plus disponible à l’achat, et l’offre Pro est épuisée. Si vous n’y avez pas déjà souscrit, vous ne pouvez choisir que le Token Plan. Leurs adresses API sont différentes :
- Token Plan :
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - Coding Plan :
https://coding-intl.dashscope.aliyuncs.com/v1
Si vous avez acheté Token Plan mais configuré l’extension pour Coding Plan, vous obtiendrez une erreur 401. Et inversement.
Piège 2 : l’extension VS Code génère sa propre clé
Lorsque vous configurez l’extension depuis son interface graphique (Cmd+Shift+P - Qwen Code: Choose Provider), elle génère parfois sa propre clé via l’API d’authentification Alibaba. Cette clé a un format différent et n’est pas liée à votre abonnement Token Plan.
Solution : après la configuration graphique, ouvrez ~/.qwen/settings.json et vérifiez que la clé de env correspond à celle affichée sur la Management Platform (Overview - Plan-specific API Key). Si ce n’est pas le cas, remplacez-la manuellement.
Piège 3 : le Standard Seat n’a pas été attribué
Après l’achat du Token Plan, la page My Subscriptions affiche Standard Seat: 0/1. Cela signifie que le siège a été acheté, mais qu’il n’est pas associé à votre compte. La clé API ne fonctionnera pas tant que vous n’aurez pas cliqué sur Assign.
D’après l’expérience de l’auteur, le débogage de l’erreur 401 a duré 20 minutes avant que cette ligne ne soit remarquée.
Comment vérifier que tout fonctionne ?
À retenir
Deux étapes : vérifiez d’abord la clé avec curl dans le terminal (le résultat attendu est 200), puis saisissez n’importe quel prompt dans Qwen Code. Si curl fonctionne, mais pas l’extension, le problème vient des paramètres du fichier ~/.qwen/settings.json.
Étape 1. Vérifiez la clé dans le terminal :
curl -X POST \
"https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen3.6-plus","messages":[{"role":"user","content":"Hello"}]}'
Si la réponse contient du texte généré par le modèle, la clé et l’adresse fonctionnent.
Étape 2. Vérifiez Qwen Code :
Ouvrez VS Code, puis le terminal intégré et tapez qwen. S’il se lance, saisissez quelque chose :
Que contient ce projet dans ce dossier ?
Qwen Code lira la structure et répondra. Si c’est le cas, la configuration est terminée.
Étape 3. Vérifiez la consommation de Credits :
Cinq minutes après vos premières requêtes, accédez à Management Platform - Overview - Usage Consumption. Le pourcentage devrait être supérieur à zéro. S’il est toujours à 0 % après plus de 10 requêtes, vous utilisez la mauvaise adresse (les requêtes ne passent pas par l’abonnement et sont facturées en Pay-as-you-go ou ne vont nulle part).
Et maintenant ?
À retenir
Qwen Code est configuré : vous pouvez commencer à coder avec l’IA. Mais l’outil n’est qu’un début. Ce qui distingue « j’ai installé le CLI » de « je construis un produit avec l’IA », c’est la méthode de travail avec le contexte.
Vous avez installé Qwen Code, et il fonctionne. Vous pouvez ouvrir n’importe quel projet et commencer à le développer dans le cadre d’un dialogue avec l’IA.
La question suivante est la suivante : pourquoi le même prompt dans Qwen Code produit-il un excellent résultat dans un projet et un résultat médiocre dans un autre ? Tout dépend du contexte. Si le projet comprend une structure business/ décrivant le public, les produits et les objectifs, l’IA travaille comme un partenaire. Si le dossier est vide, elle hallucine.
Sources
- Qwen Code sur GitHub — code source et documentation, consultés le 03.10.2026
- Alibaba Cloud ModelStudio — console de gestion des abonnements et des clés
- Présentation du Token Plan — offres actuelles et état du Coding Plan, mise à jour par Alibaba le 28.09.2026, consultée le 03.10.2026
- Documentation Qwen Code : authentification — formats des clés Token Plan et Coding Plan, consultée le 03.10.2026
Continuez à découvrir Ailoot sur ailoot.ai.
Plus de détails
Questions fréquentes : Qwen Code et Qwen 3.7-max : configurer le Token Plan
Que vérifier d’abord si une clé Token Plan renvoie 401 ?
Vérifiez que la clé et la Base URL appartiennent à Token Plan, pas à Coding Plan ni à DashScope ordinaire. Copiez la clé avec le bouton de la console et vérifiez l’attribution du Standard Seat acheté. Comparez ensuite les réglages enregistrés dans l’extension.
Une requête réussie dans le terminal prouve-t-elle que l’extension VS Code est configurée ?
Non. Elle valide seulement sa clé, son endpoint et son modèle. Testez séparément un prompt dans Qwen Code, comparez sa Base URL et sa clé avec la requête réussie, puis vérifiez la consommation dans le bon abonnement.