Authentification

Le menu /auth du premier lancement de Qwen Code propose cinq options principales. Choisissez celle qui correspond à la manière dont vous souhaitez exécuter le CLI :

• Compte Qwen avec abonnement : connectez-vous à votre compte Qwen via Qwen OAuth pour accéder à Qwen Code and Agent grâce à votre abonnement Plus ou Pro depuis chat.qwen.ai. Si vous n’avez pas encore d’abonnement, rendez-vous sur chat.qwen.ai pour souscrire à l’offre Plus ou Pro, puis revenez dans Qwen Code et sélectionnez Compte Qwen avec abonnement.
• QwenCloud : configuration officielle recommandée. Ouvre un sous-menu avec Token Plan (abonnement avec un quota mensuel de Crédits · endpoint dédié, éditions Personal et Team) ou Clé API Standard (paiement à l’usage). Vous choisissez ensuite explicitement la plateforme — Chine — Plateforme AI Qianwen ou International — QwenCloud — afin que la langue de l’interface ne détermine jamais votre endpoint. Les deux méthodes d’accès activent également l’outil intégré web_search sans configuration supplémentaire.
• Alibaba ModelStudio : ouvre un sous-menu avec Coding Plan (pour les développeurs individuels · quota hebdomadaire inclus), Token Plan (pour les équipes et les entreprises · facturation à l’usage avec un endpoint dédié) ou Clé API Standard (connexion avec une clé API ModelStudio existante). Token Plan et Clé API Standard activent également l’outil intégré web_search sans configuration supplémentaire. Les identifiants, endpoints et modèles ModelStudio enregistrés continuent de fonctionner sans modification.
• Third-party Providers : choisissez un fournisseur intégré et connectez-vous avec une clé API (DeepSeek, Grok, MiniMax, Z.AI, Kimi, Idealab, ModelScope, OpenRouter, Requesty).
• Custom Provider : connectez manuellement un serveur local, un proxy ou un fournisseur non pris en charge — prend en charge OpenAI, Anthropic, Gemini et d’autres endpoints compatibles.

Option 1 : Qwen OAuth — Compte Qwen avec abonnement

Qwen OAuth vous permet de vous connecter avec votre compte Qwen et d’utiliser votre abonnement Plus ou Pro depuis chat.qwen.ai pour accéder à Qwen Code and Agent. Dans le menu du premier lancement ou la fenêtre de dialogue /auth, choisissez Compte Qwen avec abonnement pour commencer.

• Fonctionnement : sélectionnez Compte Qwen avec abonnement et suivez le flux de connexion dans le navigateur pour autoriser Qwen Code avec votre compte Qwen.
• Prérequis : un compte Qwen avec un abonnement Plus ou Pro actif depuis chat.qwen.ai et un accès Internet.
• Avantages : accédez à Qwen Code and Agent via votre abonnement Qwen sans configurer manuellement une clé API.
• Coût et quota : l’utilisation est soumise aux conditions de votre plan d’abonnement. Consultez chat.qwen.ai pour plus de détails sur les plans Plus et Pro.

Configuration interactive

1. Si vous n’avez pas encore d’abonnement, rendez-vous sur chat.qwen.ai et souscrivez à l’offre Plus ou Pro. Si vous avez déjà un abonnement actif, passez à l’étape suivante.

2. Démarrez Qwen Code dans votre terminal :

   qwen

3. Dans le menu du premier lancement, choisissez Compte Qwen avec abonnement. Si Qwen Code est déjà en cours d’exécution, saisissez /auth pour ouvrir le menu d’authentification et sélectionnez la même option.

4. Terminez le flux de connexion et d’autorisation dans le navigateur en utilisant le même compte Qwen que celui utilisé pour souscrire à chat.qwen.ai.

5. Revenez dans Qwen Code pour commencer à travailler avec votre abonnement.

Pour les environnements non interactifs où vous ne pouvez pas terminer le flux de connexion dans le navigateur, tels que CI ou conteneurs sans supervision, utilisez plutôt une méthode d’authentification basée sur une clé API.

☁️ Option 2 : QwenCloud

L’entrée officielle de la plateforme. Choisissez-la lorsque votre clé API provient de la Plateforme AI Qianwen (Chine) ou de QwenCloud (International).

• Fonctionnement : choisissez une méthode d’accès, puis sélectionnez explicitement la plateforme — la langue de l’interface ne détermine jamais votre endpoint. Saisissez la clé émise par cette plateforme et Qwen Code configure l’endpoint correspondant.
• Méthodes d’accès : Token Plan (un abonnement avec un quota mensuel de Crédits sur un endpoint dédié ; éditions Personal et Team) ou Clé API Standard (paiement à l’usage). Le Coding Plan n’est pas proposé ici — c’est un produit Alibaba ModelStudio, voir Option 3.
• Prérequis : une clé Token Plan (préfixée par sk-sp-) générée depuis la console Token Plan, ou une clé à usage payant (préfixée par sk- ou sk-ws-) depuis la page des clés API de la plateforme.
• Avantages : les deux méthodes d’accès activent l’outil intégré web_search sans configuration supplémentaire.

Configuration interactive

Saisissez qwen dans le terminal pour lancer Qwen Code, puis exécutez la commande /auth, sélectionnez QwenCloud, et choisissez Plan Token ou Clé API standard dans le sous-menu. Choisissez la plateforme (Chine — Qianwen AI Platform ou International — QwenCloud), puis saisissez votre clé API.

Qwen Code vérifie la liste des modèles du point de terminaison au démarrage avec votre clé enregistrée ; voir Mises à jour des fournisseurs intégrés.

Configuration headless ou scriptée

Pour les environnements CI, conteneurs ou scripts, configurez la plateforme via des variables d’environnement plutôt que le flux interactif /auth.

# Pay-as-you-go (Standard API Key), International
export QWENCLOUD_API_KEY="sk-your-api-key"
export OPENAI_BASE_URL="https://maas.qwencloudapi.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3.8-max"

# Token Plan, China
export QWENCLOUD_TOKEN_PLAN_API_KEY="sk-sp-your-api-key"
export OPENAI_BASE_URL="https://token-plan.maas.qianwenaiapi.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3.8-max"

Alternative : configurer via settings.json

Si vous préférez ignorer le flux interactif /auth, ajoutez ce qui suit à ~/.qwen/settings.json :

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.8-max",
        "name": "qwen3.8-max (QwenCloud)",
        "baseUrl": "https://maas.qwencloudapi.com/compatible-mode/v1",
        "description": "qwen3.8-max from QwenCloud Standard API Key",
        "envKey": "QWENCLOUD_API_KEY"
      }
    ]
  },
  "env": {
    "QWENCLOUD_API_KEY": "sk-your-api-key"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.8-max"
  }
}

Comme pour les autres clés spécifiques aux fournisseurs, QWENCLOUD_API_KEY et QWENCLOUD_TOKEN_PLAN_API_KEY prennent effet une fois qu’une entrée de fournisseur settings.json les déclare comme étant envKey ; pour sélectionner l’authentification compatible OpenAI uniquement via des variables d’environnement, exportez plutôt OPENAI_API_KEY.

💳 Option 3 : Alibaba Cloud Coding Plan

Utilisez cette option si vous souhaitez des coûts prévisibles avec des options de modèles diversifiées et des quotas d’utilisation plus élevés.

• Fonctionnement : Abonnez-vous au Coding Plan avec un tarif mensuel fixe, puis configurez Qwen Code pour utiliser l’endpoint dédié et votre clé API d’abonnement.
• Prérequis : Obtenez un abonnement actif au Coding Plan depuis Alibaba Cloud ModelStudio(Beijing)  ou Alibaba Cloud ModelStudio(intl) , selon la région de votre compte.
• Avantages : Options de modèles diversifiées, quotas d’utilisation plus élevés, coûts mensuels prévisibles, accès à une large gamme de modèles (Qwen, GLM, Kimi, Minimax et plus encore).
• Coût et quota : Consultez la documentation du Coding Plan d’Aliyun ModelStudio Beijing intl .

Alibaba Cloud Coding Plan est disponible dans deux régions :

Configuration interactive

Saisissez qwen dans le terminal pour lancer Qwen Code, puis exécutez la commande /auth, sélectionnez Alibaba ModelStudio et choisissez Coding Plan dans le sous-menu. Choisissez votre région, puis saisissez votre clé sk-sp-xxxxxxxxx.

Qwen Code vérifie la liste des modèles du point de terminaison au démarrage avec votre clé enregistrée ; voir Mises à jour des fournisseurs intégrés.

Après l’authentification, utilisez la commande /model pour basculer entre tous les modèles pris en charge par Alibaba Cloud Coding Plan (y compris qwen3.5-plus, qwen3.6-plus, qwen3.7-plus, qwen3-coder-plus, qwen3-coder-next, qwen3-max-2026-01-23, glm-5, glm-4.7, kimi-k2.5 et MiniMax-M2.5).

Configuration headless ou scriptée

Pour les CI, conteneurs ou scripts, configurez le Coding Plan avec des variables d’environnement ou settings.json au lieu de la commande supprimée qwen auth coding-plan.

export BAILIAN_CODING_PLAN_API_KEY="sk-sp-xxxxxxxxx"
export OPENAI_BASE_URL="https://coding.dashscope.aliyuncs.com/v1"
export OPENAI_MODEL="qwen3-coder-plus"

Utilisez https://coding.dashscope.aliyuncs.com/v1 pour l’endpoint Chine (Pékin), ou https://coding-intl.dashscope.aliyuncs.com/v1 pour l’endpoint international.

Alternative : configurer via settings.json

Si vous préférez ignorer le flux interactif /auth, ajoutez ce qui suit à ~/.qwen/settings.json :

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus (Coding Plan)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "qwen3-coder-plus from Alibaba Cloud Coding Plan",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      }
    ]
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

🪙 Option 4 : Alibaba Cloud Token Plan

Utilisez cette option si votre équipe ou entreprise préfère la facturation à l’usage sur un endpoint ModelStudio dédié.

• Fonctionnement : Abonnez-vous au Token Plan dans Alibaba Cloud ModelStudio, puis configurez Qwen Code pour utiliser l’endpoint Token Plan spécifique à la région et votre clé API. Vous êtes facturé pour la consommation réelle de tokens au lieu d’un tarif mensuel fixe.
• Prérequis : Obtenez une clé API Token Plan depuis Alibaba Cloud ModelStudio(Beijing)  ou Alibaba Cloud ModelStudio(intl) , selon la région de votre compte.
• Avantages : Facturation à l’usage pour les équipes et les entreprises, endpoints dédiés spécifiques à chaque région, accès à une large gamme de modèles (Qwen, DeepSeek, GLM, Kimi, Minimax et plus encore).
• Coût et quota : Consultez la documentation du Token Plan d’Alibaba Cloud ModelStudio Beijing  intl .

Le Token Plan est disponible dans deux régions, chacune avec son propre endpoint dédié :

Configuration interactive

Saisissez qwen dans le terminal pour lancer Qwen Code, puis exécutez la commande /auth, sélectionnez Alibaba ModelStudio, et choisissez Plan Token dans le sous-menu. Choisissez votre région (Chine (Pékin) ou Singapour (International)), puis saisissez votre clé API. L’assistant affiche ensuite son étape finale (Étape 3/3 · ID de modèles), où vous sélectionnez les ID de modèles à configurer : les modèles servis par votre point de terminaison sont proposés là-bas et ne sont appliqués que si vous les sélectionnez explicitement. Les clés API du Plan Token ModelStudio n’ont pas d’exigence de préfixe, contrairement aux clés Coding Plan qui commencent par sk-sp-, et contrairement aux clés distinctes du Plan Token QwenCloud de l’Option 2, qui commencent également par sk-sp-.

Après l’authentification, utilisez la commande /model pour parcourir et basculer entre les modèles configurés pour votre Token Plan. La gamme de modèles évolue au fil du temps, elle n’est donc volontairement pas listée ici ; la découverte des modèles depuis l’endpoint se produit lors de l’étape de configuration /auth ci-dessus (la propre liste de l’endpoint y est proposée et doit être sélectionnée explicitement), puis /model affiche les modèles configurés pour votre plan.

Qwen Code vérifie également la liste des modèles du point de terminaison au démarrage avec votre clé API enregistrée, comme décrit dans Mises à jour des fournisseurs intégrés.

Configuration headless ou scriptée

Pour les CI, conteneurs ou scripts, configurez le Token Plan avec des variables d’environnement ou settings.json au lieu du flux interactif /auth.

export BAILIAN_TOKEN_PLAN_API_KEY="your-api-key"
export OPENAI_BASE_URL="https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3.7-plus"

Utilisez https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 pour l’endpoint Chine (Pékin), ou https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 pour l’endpoint international (Singapour). Remplacez qwen3.7-plus par n’importe quel modèle inclus dans votre plan.

Notez que BAILIAN_TOKEN_PLAN_API_KEY est une clé spécifique au fournisseur : elle prend effet une fois que l’entrée fournisseur settings.json de la section suivante existe, car cette entrée la déclare comme envKey. Pour sélectionner l’authentification compatible OpenAI avec uniquement des variables d’environnement, exportez OPENAI_API_KEY à la place — les clés spécifiques au fournisseur ne sélectionnent pas le type d’authentification à elles seules.

Alternative : configurer via settings.json

Si vous préférez ignorer le flux interactif /auth, ajoutez ce qui suit à ~/.qwen/settings.json :

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.7-plus",
        "name": "qwen3.7-plus (Token Plan)",
        "baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
        "description": "qwen3.7-plus from Alibaba Cloud Token Plan",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      }
    ]
  },
  "env": {
    "BAILIAN_TOKEN_PLAN_API_KEY": "your-api-key"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.7-plus"
  }
}

🚀 Option 5 : Clé API (flexible)

Utilisez cette option si vous souhaitez vous connecter à des fournisseurs tiers tels qu’OpenAI, Anthropic, Google, Azure OpenAI, OpenRouter, Requesty, ModelScope, ou un endpoint auto-hébergé. Prend en charge plusieurs protocoles et fournisseurs.

Recommandé : Configuration en un seul fichier via settings.json

Le moyen le plus simple de commencer avec l’authentification par clé API est de tout mettre dans un seul fichier ~/.qwen/settings.json. Voici un exemple complet et prêt à l’emploi :

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "description": "Qwen3-Coder via Dashscope",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-xxxxxxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

Fonction de chaque champ :

Après avoir enregistré le fichier, exécutez simplement qwen — aucune configuration interactive de /auth n’est nécessaire.

Le concept clé est Model Providers (modelProviders) : Qwen Code prend en charge plusieurs protocoles API, pas seulement OpenAI. Vous configurez les fournisseurs et modèles disponibles en modifiant ~/.qwen/settings.json, puis vous basculez entre eux au moment de l’exécution avec la commande /model.

Protocoles pris en charge

Étape 1 : Configurer les modèles et les fournisseurs dans ~/.qwen/settings.json

Définissez les modèles disponibles pour chaque protocole. Chaque entrée de modèle nécessite au minimum un id ; envKey (le nom de la variable d’environnement qui contient votre clé API) est optionnel mais recommandé — s’il est omis, il revient à la clé d’environnement par défaut du type d’authentification (par exemple OPENAI_API_KEY pour openai).

Modifiez ~/.qwen/settings.json (créez-le s’il n’existe pas). Vous pouvez mélanger plusieurs protocoles dans un seul fichier — voici un exemple multi-fournisseur montrant uniquement la section modelProviders :

{
  "modelProviders": {
    "openai": [
      {
        "id": "gpt-4o",
        "name": "GPT-4o",
        "envKey": "OPENAI_API_KEY",
        "baseUrl": "https://api.openai.com/v1"
      }
    ],
    "anthropic": [
      {
        "id": "claude-sonnet-4-20250514",
        "name": "Claude Sonnet 4",
        "envKey": "ANTHROPIC_API_KEY"
      }
    ],
    "gemini": [
      {
        "id": "gemini-2.5-pro",
        "name": "Gemini 2.5 Pro",
        "envKey": "GEMINI_API_KEY"
      }
    ]
  }
}

Champs ModelConfig (chaque entrée dans modelProviders) :

Pour le schéma complet de modelProviders et les options avancées comme generationConfig, customHeaders et extra_body, consultez la Référence des Model Providers.

Étape 2 : Définir les variables d’environnement

Qwen Code lit les clés API à partir des variables d’environnement (spécifiées par envKey dans votre configuration de modèle). Il existe plusieurs façons de les fournir, listées ci-dessous de la priorité la plus élevée à la plus basse :

1. Environnement du shell / export (priorité la plus élevée)

Défini directement dans votre profil shell (~/.zshrc, ~/.bashrc, etc.) ou en ligne avant le lancement :

 
# Alibaba Dashscope
export DASHSCOPE_API_KEY="sk-..."
 
# OpenAI / OpenAI-compatible
export OPENAI_API_KEY="sk-..."
 
# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
 
# Google GenAI
export GEMINI_API_KEY="AIza..."

2. Fichiers .env

Qwen Code charge automatiquement le premier fichier .env qu’il trouve (les variables ne sont pas fusionnées entre plusieurs fichiers). Seules les variables non déjà présentes dans process.env sont chargées.

Ordre de recherche (à partir du répertoire courant, en remontant vers /) :

1. .qwen/.env (recommandé — isole les variables de Qwen Code des autres outils)
2. .env

Si rien n’est trouvé, il revient à votre répertoire personnel :

3. ~/.qwen/.env
4. ~/.env

3. Champ settings.json → env (priorité la plus basse)

Vous pouvez également définir les clés API directement dans ~/.qwen/settings.json sous la clé env. Celles-ci sont chargées comme solution de secours de plus basse priorité — appliquées uniquement lorsqu’une variable n’est pas déjà définie par l’environnement système ou les fichiers .env.

{
  "env": {
    "DASHSCOPE_API_KEY": "sk-...",
    "OPENAI_API_KEY": "sk-...",
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

C’est l’approche utilisée dans l’exemple de configuration en un seul fichier ci-dessus. C’est pratique pour tout garder au même endroit, mais gardez à l’esprit que settings.json peut être partagé ou synchronisé — préférez les fichiers .env pour les secrets sensibles.

Résumé des priorités :

Étape 3 : Changer de modèle avec /model

Après avoir lancé Qwen Code, utilisez la commande /model pour basculer entre tous les modèles configurés. Les modèles sont regroupés par protocole :

/model

Le sélecteur affichera tous les modèles de votre configuration modelProviders, regroupés par leur protocole (par exemple openai, anthropic, gemini). Votre sélection est persistée entre les sessions.

Vous pouvez également changer de modèle directement avec un argument en ligne de commande, ce qui est pratique lorsque vous travaillez sur plusieurs terminaux.

# In one terminal
 
qwen --model "qwen3-coder-plus"
 
# In another terminal
 
qwen --model "qwen3.5-plus"

Mises à jour des fournisseurs intégrés

Les fournisseurs installés avec une liste de modèles intégrée peuvent proposer une Mise à jour du fournisseur intégré lorsqu’un nouveau préréglage est disponible.

QwenCloud (Plan Token et Clé API standard) et Alibaba ModelStudio (Coding Plan, Plan Token et Clé API standard) vérifient également /models au démarrage. Cette vérification utilise la variable de clé API spécifique au fournisseur enregistrée par /auth (par exemple, BAILIAN_TOKEN_PLAN_API_KEY), y compris les valeurs provenant de settings.env. Une clé fournie uniquement via un indicateur CLI, OPENAI_API_KEY, ou des paramètres d’authentification génériques n’active pas cette vérification ; les clés génériques ne sont pas transmises aux points de terminaison d’autres fournisseurs.

La découverte réussie limite la mise à jour aux modèles intégrés servis par votre clé, tout en préservant les modèles ajoutés par l’utilisateur. Elle peut également proposer une mise à jour lorsque l’ensemble des modèles servis change sans nouvelle version prédéfinie, par exemple après un changement de plan. La découverte seule conserve le modèle sélectionné ; une fois que vous avez changé de modèle, une vérification au démarrage ultérieur peut proposer sa suppression. Si le filtrage ne laisse aucun modèle intégré à installer, la configuration du fournisseur existante est conservée sans demande. Lorsque seul l’ensemble des modèles servis change, la mise à jour ajoute uniquement les nouveaux modèles servis, afin qu’un modèle exclu lors de /auth ne soit pas réajouté. Si rien ne doit changer, la vérification est enregistrée sans demande.

Si la découverte n’est pas disponible, échoue ou ne correspond à aucun modèle intégré, une mise à jour prédéfinie utilise la liste complète des modèles intégrés ; une installation déjà à jour reste inchangée. Les fournisseurs sans découverte continuent d’utiliser la liste des modèles intégrés.

Plus tard attend 24 heures avant de redemander pour la même version ou le même ensemble de modèles servis ; un changement différent peut toujours déclencher une demande. Mettre à jour, ignorer ou enregistrer silencieusement une décision plus récente efface le report précédent. Ignorer conserve votre configuration, y compris les modèles retenus : une version prédéfinie ignorée n’est plus proposée tant qu’une version plus récente n’est pas publiée, et un ensemble de modèles servis ignoré n’est plus proposé tant qu’il ne change pas.

Commande CLI qwen auth supprimée

La commande CLI autonome qwen auth a été supprimée. Utilisez plutôt ces remplacements :

Les invocations héritées telles que qwen auth status affichent un avis de suppression résumant ces chemins de migration, y compris une entrée Token Plan avec les URL de base des deux régions.

Notes de sécurité

• Ne commitez pas les clés API dans le contrôle de version.
• Préférez .qwen/.env pour les secrets locaux au projet (et gardez-le hors de git).
• Considérez la sortie de votre terminal comme sensible si elle affiche des identifiants pour vérification.