Configurer Qwen Code : installation, fournisseurs, interface allemande et API

Qwen Code est l'agent de codage IA open source (Apache-2.0) de l'équipe Qwen d'Alibaba. Sa mise en place se fait en quatre étapes : installer, lancer qwen dans le projet, choisir le fournisseur avec /auth, puis formuler une tâche. Point important : le quota gratuit de Qwen OAuth a pris fin le 15 avril 2026 — les anciens guides ne permettent donc plus de continuer gratuitement. Cette page suit le menu /auth actuel, montre comment passer l'interface en allemand, configurer un endpoint personnalisé pour Claude ou GPT et utiliser les commandes principales. La dernière version est v0.24.7, publiée sur npm le 29 septembre 2026 ; des versions sortent au moins chaque semaine, vérifiez la vôtre avec qwen --version.

Installation

Les commandes proviennent du README officiel. Avec l'installateur autonome, vous n'avez pas à installer Node.js vous-même ; seul npm exige Node.js 22 ou une version ultérieure.

# macOS / Linux (offizieller Standalone-Installer)
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

# Windows (PowerShell)
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

# npm (benötigt Node.js 22 oder neuer)
npm install -g @qwen-code/qwen-code@latest

# Homebrew (macOS / Linux)
brew install qwen-code

Rouvrez ensuite le terminal afin que les variables d'environnement soient prises en compte. Qwen Code était initialement basé sur Google Gemini CLI v0.8.2, mais est développé indépendamment depuis la v0.1 et n'est plus synchronisé avec l'original. Les paramètres et quotas de Gemini CLI ne s'appliquent pas ici.

Premier démarrage et interface allemande

cd /pfad/zu/ihrem-projekt
qwen

# in der Sitzung:
/language ui de-DE        # Oberfläche auf Deutsch
/language output German   # Antworten des Modells auf Deutsch
/auth                     # Anbieter und API-Key einrichten

Après /language ui de-DE, Qwen Code affiche ses propres libellés allemands, tels que « Authentifizierungsmethode auswählen » ou « Werkzeug-Genehmigungsmodus » ; cette page utilise les mêmes termes. La langue des réponses est distincte et se définit avec /language output German.

En plus du terminal, il existe une application de bureau, une interface web dans le navigateur (qwen serve --open, expérimentale), des intégrations pour VS Code, Zed et JetBrains, ainsi qu'un mode sans interface pour les scripts et la CI (qwen -p "..."). Tout se trouve dans le même dépôt gratuit ; vous payez séparément l'inférence.

Choisir le fournisseur avec /auth

/auth (alias /login) ouvre « Authentifizierungsmethode auswählen » avec trois options au niveau supérieur. Si vous souhaitez encore choisir Qwen OAuth, vous verrez : « Eingestellt — wechseln Sie zu Coding Plan oder API Key ».

Les trois voies ModelStudio ne sont pas trois moyens de paiement pour une même facture : la documentation attribue à chacune un endpoint et une clé distincts, et le type de clé et baseUrl doivent correspondre. Au 1er octobre 2026, le Coding Plan était indiqué comme « disponibilité limitée, premier arrivé, premier servi, réapprovisionné chaque jour à 0 h (UTC+8) » — il peut donc être indisponible certains jours. Une tâche consomme plusieurs appels de modèle dans le Coding Plan ; Alibaba en indique généralement 5 à 10 pour les tâches simples, et 10 à 30 ou davantage pour les tâches complexes. La page anglaise Qwen Code pricing traite en détail de la comparaison des coûts.

Utiliser Claude ou GPT : fournisseur personnalisé dans settings.json

La documentation sur l'authentification recommande, pour les fournisseurs tiers comme OpenAI, Anthropic, Google, OpenRouter ou votre propre endpoint, le bloc modelProviders dans ~/.qwen/settings.json. Pour Kunavo, il se présente ainsi :

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI-kompatibel",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

# Den Key nicht in settings.json schreiben, sondern in .qwen/.env oder die Umgebung
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

Quatre points qui facilitent le dépannage :

• baseUrl se termine par /v1. La référence des fournisseurs de modèles indique explicitement de définir la racine /v1 de l'API, et non /v1/chat/completions — le SDK ajoute lui-même le chemin. Avec le chemin, vous obtenez une erreur 404, et non une erreur d'authentification.
• Emplacement de la clé. Qwen Code la lit dans la variable d'environnement indiquée par envKey. Ordre de priorité : export du shell, puis un fichier .env (il est recommandé d'utiliser .qwen/.env ; seul le premier fichier trouvé compte), et enfin env dans settings.json — où la clé est stockée en clair.
• Le fichier est prioritaire sur l'option CLI. Ordre : valeurs de /auth → entrée modelProviders sélectionnée → arguments CLI → variables d'environnement → settings.json. C'est pourquoi --openai-base-url semble parfois sans effet. security.auth.apiKey et security.auth.baseUrl des anciens guides sont obsolètes.
• Commencez avec Chat Completions. Sans wireApi, Chat Completions est utilisé. Avec "responses", il n'y a ni détection d'endpoint ni recours automatique. Les modifications de modelProviders s'appliquent également à une session en cours (/model pour la rouvrir).

Le catalogue Kunavo ne contient aucun modèle de texte Qwen. Il ne s'agit donc pas d'un moyen moins cher d'accéder à Qwen, mais d'un moyen d'utiliser Claude ou GPT dans Qwen Code via un solde prépayé. Kunavo n'a pas non plus exécuté Qwen Code contre son endpoint ; comme la page anglaise de configuration de Qwen Code, la configuration provient de la documentation officielle. Conservez une route fonctionnelle pendant vos essais.

Première tâche et commandes importantes

Le README propose, en substance, comme première tâche : « Explique ce dépôt et indique-moi par où commencer. » Cela vérifie à la fois l'accès aux fichiers et les appels d'outils — un simple « Bonjour » ne révèle pas les problèmes de connexion.

Pour yolo et les autres modes automatiques, la documentation elle-même recommande de les utiliser uniquement dans des environnements de confiance, isolés ou jetables. Les coûts estimés dans /stats model sont calculés par Qwen Code lui-même ; le montant réel figure dans le journal d'utilisation de votre fournisseur.

Limites à connaître

• La recherche web intégrée dépend de l'hôte. Elle utilise la recherche côté serveur de DashScope : activée pour la clé API ModelStudio Standard et le Token Plan, ainsi que pour les entrées sur un hôte DashScope reconnu ; désactivée pour le Coding Plan (non vérifié dans ce cas), les fournisseurs tiers et les endpoints personnalisés sur d'autres hôtes (documentation de web_search). Alternative : un serveur de recherche MCP.
• Kunavo ne fournit que le chat. Kunavo ne propose pas de modèles d'embeddings, de synthèse vocale ou de reconnaissance vocale. La voix en direct de Qwen Code exige de toute façon un endpoint DashScope et conserve sa propre clé, quel que soit l'endpoint du modèle de chat.

Payer pour essayer Kunavo

Kunavo fonctionne avec un solde prépayé sans abonnement et facture à l'utilisation, par token. La recharge minimale est de $10 ; le checkout Stripe propose les cartes (Visa, Mastercard, American Express), Apple Pay, Google Pay et Link, ainsi qu'EPS en Autriche — le prélèvement SEPA n'est actuellement pas proposé. Stripe propose Pay by Bank uniquement aux acheteurs au Royaume-Uni, en Irlande et en Finlande ; en Allemagne, il n'est pour l'instant disponible qu'en préversion fermée (documentation Stripe, au 3 octobre 2026). Détails dans Billing ; créez la clé avec un compte. Après la première tâche, le journal d'utilisation indique le montant réel.

Questions fréquentes

Vérifié le 1er octobre 2026 : README de Qwen Code, documentation sur l'authentification, les fournisseurs de modèles, les commandes et web_search (branche main), textes de l'interface allemande (packages/cli/src/i18n/locales/de.js), @qwen-code/qwen-code 0.24.7 sur npm, ainsi que les pages d'Alibaba Cloud sur le Coding Plan et le Token Plan. Kunavo n'a pas exécuté Qwen Code contre son endpoint.