Configuration de l'API personnalisée Qwen Code

Ajoutez un modèle compatible TokenHub OpenAI aux paramètres Qwen Code et choisissez-le en toute sécurité dans la CLI.

Qu’est-ce que Qwen Code ?

Qwen Code est un agent de codage en ligne de commande avec des fournisseurs, des modèles, des compétences et des flux de travail de référentiel configurables.

Ce guide Qwen Code utilise la configuration actuelle modelProviders.openai avec une clé API TokenHub basée sur l'environnement. Il conserve les informations d'identification en dehors des paramètres partagés et démarre par une tâche en lecture seule. La configuration persistante se trouve dans le fichier de paramètres utilisateur sous modelProviders.openai, tandis que la véritable clé API reste dans l'environnement référencé par envKey. Gardez la configuration du projet partagé exempte de secrets, confirmez security.auth.selectedType et le modèle par défaut, et redémarrez la CLI après avoir modifié JSON ou les variables d'environnement.

Qwen Code peut acheminer ses requêtes de modèle via la passerelle API OpenAI compatible de TokenHub. Gardez l’installation officielle, puis remplacez seulement la clé API, la Base URL et l’ID du modèle.

L’endpoint TokenHub utilisé dans ce guide est https://us-api.tokenhub.com/v1/chat/completions.

Quand l’utiliser

Commencez dans un petit dépôt ou un projet de test. Demandez d’abord à l’outil de lire des fichiers, expliquer le code ou proposer un plan, puis activez les modifications.

Installer ou ouvrir l’outil

Suivez la documentation officielle Qwen Code pour installer ou ouvrir l’outil. Si les menus changent, suivez la version actuelle de la documentation.

Pour les outils CLI, vérifiez que l’exécutable fonctionne avant d’ajouter les identifiants TokenHub :

qwen --version

Préparer les identifiants TokenHub

Créez une clé API TokenHub et choisissez dans la liste des modèles TokenHub un modèle adapté à cet outil.

export TOKENHUB_API_KEY="sk-..."

Conservez la clé dans votre shell local, le stockage secret de l’IDE ou le champ API key sécurisé de l’outil. Ne la commitez pas dans le dépôt.

Configurer le fournisseur TokenHub

Dans les réglages Models, Providers, API Keys ou OpenAI Compatible, renseignez les valeurs ci-dessous.

Valeurs du provider

ChampValeur
FournisseurOpenAI Compatible ou Custom
Base URLhttps://us-api.tokenhub.com/v1
API KeyLa valeur de TOKENHUB_API_KEY
Modèleqwen3-coder-plus ou un autre model ID TokenHub

Emplacements des réglages

ChampValeur
User config~/.qwen/settings.json
Project config.qwen/settings.json
Provider fieldsmodelProviders.openai, security.auth.selectedType, model.name
{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "id": "qwen3-coder-plus",
          "name": "TokenHub / qwen3-coder-plus",
          "baseUrl": "__API_BASE_URL__/v1",
          "envKey": "TOKENHUB_API_KEY"
        }
      ]
    }
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

Si votre version installée écrit un schéma légèrement différent, utilisez d’abord la configuration interactive, puis gardez les mêmes valeurs TokenHub : Base URL, API key et model ID.

Si l’outil sépare chat, edit, apply et fast models, utilisez le même modèle TokenHub pour le premier test. Séparez-les ensuite selon le coût, la latence et la capacité de raisonnement.

Variables temporaires pour le diagnostic

Utilisez les variables temporaires seulement pour vérifier la clé, le réseau et le nom du modèle. Après validation, déplacez les mêmes valeurs dans la configuration persistante ci-dessus.

export TOKENHUB_API_KEY="sk-..."
export OPENAI_API_KEY="$TOKENHUB_API_KEY"
export OPENAI_BASE_URL="__API_BASE_URL__/v1"
export OPENAI_MODEL="qwen3-coder-plus"

Vérifier la connexion

Testez d’abord avec une consigne en lecture seule pour confirmer que le modèle lit le contexte sans modifier les fichiers. Testez ensuite les actions d’édition ou d’agent.

Lis le README du projet et résume-le en trois phrases. Ne modifie aucun fichier.

Après un prompt réussi, consultez les logs TokenHub pour vérifier le modèle, l’endpoint, les tokens consommés et le groupe de facturation.

Dépannage

SymptômeCorrection
401 ou échec d’authentificationVérifiez que TOKENHUB_API_KEY est valide et enregistré dans le même terminal, IDE ou profil client.
404 ou modèle introuvableUtilisez un model ID présent dans votre espace TokenHub et compatible avec le protocole choisi.
Endpoint incorrectGardez exactement la Base URL indiquée ci-dessus. Les outils compatibles OpenAI demandent généralement /v1; les outils compatibles Claude non.
TimeoutVérifiez le réseau vers https://us-api.tokenhub.com, les paramètres proxy et l’allowlist de l’espace de travail.
L’outil utilise un autre modèleRevérifiez tous les emplacements chat, edit, apply, fast ou autocomplete.

Choisir un modèle

Charge de travailChoix du modèlePourquoi
Tâches complexesModèle de raisonnement avec outilsAdapté à la planification, aux étapes multiples et aux longs contextes.
Usage quotidienModèle équilibréÉquilibre qualité, vitesse et coût.
Résumés et tâches légèresModèle rapide et économiqueRéduit le coût des résumés et itérations simples.
Voir les modèles TokenHub

FAQ sur l'API personnalisée Qwen Code

Pourquoi Qwen Code démarre-t-il toujours avec son service par défaut ?

Vérifiez que security.auth.selectedType est openai et que le modèle actif apparaît dans modelProviders.openai.

La clé du fournisseur doit-elle être tokenhub ou openai ?

Utilisez la configuration officielle actuelle de modelProviders.openai. TokenHub est connecté via ses baseUrl et envKey ; n'inventez pas une clé de fournisseur non vérifiée.

Un fichier de paramètres de projet peut-il contenir une clé API TokenHub ?

Évitez-le. Conservez envKey, l'URL de base et l'ID de modèle dans une configuration partagée, tout en stockant la clé réelle dans l'environnement local ou dans un gestionnaire de secrets.

Comment ajouter un modèle TokenHub à Qwen Code ?

Ajoutez le modèle sous modelProviders.openai dans ~/.qwen/settings.json, référencez TOKENHUB_API_KEY avec envKey et sélectionnez le même modèle que celui par défaut.

Comment valider les capacités de l'agent Qwen Code ?

Commencez par une question du référentiel en lecture seule et confirmez la demande dans les journaux TokenHub, puis testez les appels, les modifications et les commandes de l'outil de manière indépendante.

Références

Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-04。