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 --versionPré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
| Champ | Valeur |
|---|---|
| Fournisseur | OpenAI Compatible ou Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | La valeur de TOKENHUB_API_KEY |
| Modèle | qwen3-coder-plus ou un autre model ID TokenHub |
Emplacements des réglages
| Champ | Valeur |
|---|---|
| User config | ~/.qwen/settings.json |
| Project config | .qwen/settings.json |
| Provider fields | modelProviders.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ôme | Correction |
|---|---|
| 401 ou échec d’authentification | Vérifiez que TOKENHUB_API_KEY est valide et enregistré dans le même terminal, IDE ou profil client. |
| 404 ou modèle introuvable | Utilisez un model ID présent dans votre espace TokenHub et compatible avec le protocole choisi. |
| Endpoint incorrect | Gardez exactement la Base URL indiquée ci-dessus. Les outils compatibles OpenAI demandent généralement /v1; les outils compatibles Claude non. |
| Timeout | Vé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èle | Revérifiez tous les emplacements chat, edit, apply, fast ou autocomplete. |
Choisir un modèle
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。