Skip to Content
Guide d'Utilisation CLIConfiguration d'Authentification

Configuration de l’authentification

Qwen Code prend en charge deux méthodes d’authentification principales pour accéder aux modèles AI. Choisissez celle qui convient le mieux à votre cas d’usage :

  1. Qwen OAuth (Recommandé) :

    • Utilisez cette option pour vous connecter avec votre compte qwen.ai.
    • Lors du premier démarrage, Qwen Code vous redirigera vers la page d’authentification de qwen.ai. Une fois authentifié, vos identifiants seront mis en cache localement afin d’éviter la connexion web lors des exécutions suivantes.
    • Prérequis :
      • Un compte qwen.ai valide
      • Connexion Internet pour l’authentification initiale
    • Avantages :
      • Accès fluide aux modèles Qwen
      • Actualisation automatique des identifiants
      • Pas de gestion manuelle des API keys requise

    Pour commencer :

    # Démarrez Qwen Code et suivez le flux OAuth qwen

    Le CLI ouvrira automatiquement votre navigateur et vous guidera à travers le processus d’authentification.

    Pour les utilisateurs s’authentifiant via leur compte qwen.ai :

    Quota :

    • 60 requêtes par minute
    • 2 000 requêtes par jour
    • L’utilisation de tokens n’est pas applicable

    Coût : Gratuit

    Remarques : Un quota spécifique pour différents modèles n’est pas précisé ; un fallback de modèle peut survenir pour préserver la qualité de l’expérience partagée.

  2. API compatible OpenAI :

    • Utilisez des API keys pour OpenAI ou d’autres fournisseurs compatibles.
    • Cette méthode vous permet d’utiliser divers modèles AI via des API keys.

    Méthodes de configuration :

    a) Variables d’environnement :

    export OPENAI_API_KEY="your_api_key_here" export OPENAI_BASE_URL="your_api_endpoint" # Optionnel export OPENAI_MODEL="your_model_choice" # Optionnel

    b) Fichier .env du projet : Créez un fichier .env à la racine de votre projet :

    OPENAI_API_KEY=your_api_key_here OPENAI_BASE_URL=your_api_endpoint OPENAI_MODEL=your_model_choice

    Fournisseurs pris en charge :

Changer de méthode d’authentification

Pour basculer entre les méthodes d’authentification pendant une session, utilisez la commande /auth dans l’interface CLI :

# Dans le CLI, tapez : /auth

Cela vous permettra de reconfigurer votre méthode d’authentification sans redémarrer l’application.

Persistance des variables d’environnement avec les fichiers .env

Vous pouvez créer un fichier .qwen/.env dans le répertoire de votre projet ou dans votre répertoire personnel. Créer un simple fichier .env fonctionne également, mais .qwen/.env est recommandé pour isoler les variables de Qwen Code des autres outils.

Important : Certaines variables d’environnement (comme DEBUG et DEBUG_MODE) sont automatiquement exclues des fichiers .env du projet afin d’éviter toute interférence avec le comportement de qwen-code. Utilisez les fichiers .qwen/.env pour les variables spécifiques à qwen-code.

Qwen Code charge automatiquement les variables d’environnement depuis le premier fichier .env qu’il trouve, en utilisant l’ordre de recherche suivant :

  1. En partant du répertoire courant et en remontant vers /, pour chaque répertoire, il vérifie :
    1. .qwen/.env
    2. .env
  2. Si aucun fichier n’est trouvé, il utilise par défaut votre répertoire personnel :
    • ~/.qwen/.env
    • ~/.env

Important : La recherche s’arrête au premier fichier trouvé — les variables ne sont pas fusionnées à partir de plusieurs fichiers.

Exemples

Remplacements spécifiques au projet (prioritaires lorsque vous êtes dans le répertoire du projet) :

mkdir -p .qwen cat >> .qwen/.env <<'EOF' OPENAI_API_KEY="your-api-key" OPENAI_BASE_URL="https://api-inference.modelscope.cn/v1" OPENAI_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct" EOF

Paramètres globaux à l’utilisateur (disponibles dans tous les répertoires) :

mkdir -p ~/.qwen cat >> ~/.qwen/.env <<'EOF' OPENAI_API_KEY="your-api-key" OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1" OPENAI_MODEL="qwen3-coder-plus" EOF

Mode non interactif / Environnements headless

Lorsque vous exécutez Qwen Code dans un environnement non interactif, vous ne pouvez pas utiliser le flux de connexion OAuth.
Vous devez alors configurer l’authentification en utilisant des variables d’environnement.

Le CLI détectera automatiquement s’il s’exécute dans un terminal non interactif et utilisera la méthode compatible avec l’API OpenAI si elle est configurée :

  1. API compatible OpenAI :
    • Définissez la variable d’environnement OPENAI_API_KEY.
    • Vous pouvez également définir OPENAI_BASE_URL et OPENAI_MODEL pour des endpoints personnalisés.
    • Le CLI utilisera ces identifiants pour s’authentifier auprès du fournisseur d’API.

Exemple pour les environnements headless :

export OPENAI_API_KEY="your-api-key" export OPENAI_BASE_URL="https://api-inference.modelscope.cn/v1" export OPENAI_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct" # Exécuter Qwen Code qwen

Si aucune clé API n’est définie lors d’une session non interactive, le CLI s’arrêtera avec une erreur vous demandant de configurer l’authentification.

Last updated on