Authentification

Qwen Code prend en charge deux méthodes d’authentification. Choisissez celle qui correspond à la façon dont vous souhaitez exécuter le CLI :

• OAuth Qwen (recommandé) : connectez-vous avec votre compte qwen.ai dans un navigateur.
• Clé API : utilisez une clé API pour vous connecter à n’importe quel fournisseur pris en charge. Plus flexible — prend en charge OpenAI, Anthropic, Google GenAI, Alibaba Cloud Bailian et d’autres points de terminaison compatibles.

👍 Option 1 : Qwen OAuth (recommandé et gratuit)

Utilisez cette option si vous souhaitez la configuration la plus simple et que vous utilisez les modèles Qwen.

• Fonctionnement : au premier démarrage, Qwen Code ouvre une page de connexion dans le navigateur. Une fois la connexion terminée, les identifiants sont mis en cache localement, vous n’aurez donc généralement plus besoin de vous reconnecter.
• Prérequis : un compte qwen.ai + accès Internet (au moins pour la première connexion).
• Avantages : pas de gestion de clé API, actualisation automatique des identifiants.
• Coût et quota : gratuit, avec un quota de 60 requêtes/minute et 1 000 requêtes/jour.

Démarrez l’interface en ligne de commande et suivez le processus dans le navigateur :

qwen

🚀 Option 2 : Clé API (souple)

Utilisez cette option si vous souhaitez plus de flexibilité concernant le fournisseur et le modèle à utiliser. Prend en charge plusieurs protocoles et fournisseurs, notamment OpenAI, Anthropic, Google GenAI, Alibaba Cloud Bailian, Azure OpenAI, OpenRouter, ModelScope ou un point de terminaison compatible auto-hébergé.

Option 1 : Coding Plan (Aliyun Bailian)

Utilisez cette option si vous souhaitez des coûts prévisibles avec des quotas d’utilisation plus élevés pour le modèle qwen3-coder-plus.

• Fonctionnement : souscrivez à l’abonnement Coding Plan avec des frais mensuels fixes, puis configurez Qwen Code pour utiliser le point de terminaison dédié et votre clé API d’abonnement.
• Prérequis : obtenir un abonnement actif au plan Coding Plan depuis Alibaba Cloud Bailian .
• Avantages : quotas d’utilisation plus élevés, coûts mensuels prévisibles, accès au dernier modèle qwen3-coder-plus.
• Coût et quota : consultez la documentation du plan Coding Plan d’Alibaba Cloud Bailian .

Entrez qwen dans le terminal pour lancer Qwen Code, puis entrez la commande /auth et sélectionnez API-KEY

Après avoir entré, sélectionnez Coding Plan :

Entrez votre clé sk-sp-xxxxxxxxx, puis utilisez la commande /model pour basculer entre tous les modèles pris en charge par le Coding Plan de Bailian :

Option 2 : Clé API tierce

Utilisez cette option si vous souhaitez vous connecter à des fournisseurs tiers tels qu’OpenAI, Anthropic, Google, Azure OpenAI, OpenRouter, ModelScope ou un point de terminaison auto-hébergé.

Le concept clé est celui des Fournisseurs de modèles (modelProviders) : Qwen Code prend en charge plusieurs protocoles d’API, pas uniquement OpenAI. Vous configurez les fournisseurs et modèles disponibles en éditant le fichier ~/.qwen/settings.json, puis vous basculez entre eux au moment de l’exécution à l’aide de la commande /model.

Protocoles pris en charge

Étape 1 : Configurer modelProviders dans ~/.qwen/settings.json

Définissez quels modèles sont disponibles pour chaque protocole. Chaque entrée de modèle nécessite au minimum un id et un envKey (le nom de la variable d’environnement qui contient votre clé API).

Modifiez ~/.qwen/settings.json (créez-le s’il n’existe pas) :

{
  "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"
      }
    ]
  }
}

Vous pouvez mélanger plusieurs protocoles et modèles dans une seule configuration. Les champs de ModelConfig sont :

Pour connaître le schéma complet de modelProviders ainsi que les options avancées telles que generationConfig, customHeaders et extra_body, consultez Référence des paramètres → modelProviders.

É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 la configuration de votre modèle). Il existe plusieurs façons de les fournir, listées ci-dessous par ordre de priorité décroissante :

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

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

 
# Alibaba Dashscope
export DASHSCOPE_API_KEY="sk-..."
 
# OpenAI / Compatible OpenAI
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` (préféré — isole les variables de Qwen Code des autres outils)
2. `.env`

Si rien n'est trouvé, il utilise votre **répertoire personnel** :

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

> [!tip]
>
> `.qwen/.env` est recommandé au lieu de `.env` pour éviter les conflits avec d'autres outils. Certaines variables (comme `DEBUG` et `DEBUG_MODE`) sont exclues des fichiers `.env` au niveau du projet pour éviter d'interférer avec le comportement de Qwen Code.

**3. `settings.json` → champ `env` (priorité la plus faible)**

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

```json
{
  "env": {
    "DASHSCOPE_API_KEY":"sk-...",
    "OPENAI_API_KEY": "sk-...",
    "ANTHROPIC_API_KEY": "sk-ant-...",
    "GEMINI_API_KEY": "AIza..."
  },
  "modelProviders": {
    ...
  }
}

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 conservée d’une session à l’autre.

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

 
# Dans un premier terminal
 
qwen --model "qwen3-coder-plus"
 
# Dans un autre terminal
 
qwen --model "qwen3-coder-next"

Notes de sécurité

• N’ajoutez pas les clés API au système de gestion de versions.
• Préférez le fichier .qwen/.env pour les secrets locaux au projet (et assurez-vous qu’il n’est pas suivi par git).
• Considérez la sortie de votre terminal comme sensible si elle affiche des identifiants à des fins de vérification.