Documentation

Qwen Code : Claude et GPT via un endpoint compatible OpenAI

Ce guide nécessite une clé API

Créez un compte et générez-en une en une minute environ, puis utilisez-la là où les étapes ci-dessous attendent une clé.

Inscription sans carte · un rechargement est requis pour utiliser l’API

Qwen Code est l'agent terminal open source d'Alibaba ; son réglage modelProviders accepte n'importe quelle base URL compatible OpenAI, donc une clé Code By AI sert Claude et GPT.

Qwen Code est un agent de code terminal dérivé de Gemini CLI. Il lit ~/.qwen/settings.json et peut enregistrer plusieurs modèles compatibles OpenAI, que le sélecteur /model permet de changer.

Une commande (macOS / Linux)

1
curl -fsSL https://www.codebyai.net/setup.sh | sh -s -- --qwen-code

Le script demande votre clé API (saisie masquée), écrit CODEBYAI_API_KEY dans le fichier rc de votre shell et ajoute gpt-5.6-terra et claude-sonnet-5 dans ~/.qwen/settings.json comme modèles par défaut, après avoir sauvegardé le fichier. La clé n'est jamais écrite dans settings.json. Avec QWEN_HOME, le script modifie le fichier à cet emplacement, comme Qwen Code. Le relancer renouvelle la clé et garde le modèle choisi avec /model ; | sh -s -- --uninstall restaure le fichier d'origine. Ouvrez ensuite un nouveau terminal et lancez qwen. Les commentaires de settings.json ne survivent pas à la réécriture ; la sauvegarde les conserve. Les étapes manuelles ci-dessous font la même chose.

1. Installer Qwen Code

Node.js 22 ou plus récent :

1
npm install -g @qwen-code/qwen-code@latest

Sous macOS ou Linux, brew install qwen-code est une alternative. Vérifiez avec qwen --version.

2. Créer une clé API Code By AI

Connectez-vous à Code By AI, ouvrez API Keys et créez une clé. Elle ressemble à sk-proj-....

3. Ajouter les modèles dans settings.json

Ouvrez ~/.qwen/settings.json (niveau utilisateur) et fusionnez ceci dans l'objet existant. Conservez les fournisseurs déjà présents :

1
{
2
  "modelProviders": {
3
    "openai": [
4
      {
5
        "id": "gpt-5.6-terra",
6
        "name": "CodeByAI GPT",
7
        "baseUrl": "https://www.codebyai.net/api/agent/v1",
8
        "envKey": "CODEBYAI_API_KEY"
9
      },
10
      {
11
        "id": "claude-sonnet-5",
12
        "name": "CodeByAI Claude",
13
        "baseUrl": "https://www.codebyai.net/api/agent/v1",
14
        "envKey": "CODEBYAI_API_KEY"
15
      }
16
    ]
17
  },
18
  "security": { "auth": { "selectedType": "openai" } },
19
  "model": { "name": "gpt-5.6-terra" }
20
}

L'ID de fournisseur openai désigne le protocole compatible OpenAI. wireApi est omis, donc Chat Completions est utilisé ; la passerelle sert les deux familles sur cette route. N'ajoutez pas wireApi: "responses" sauf si vous voulez délibérément l'API Responses.

4. Exporter la clé

Les identifiants sont lus dans l'environnement, jamais stockés dans le fichier de réglages :

1
export CODEBYAI_API_KEY="sk-proj-xxxx"

Ajoutez cette ligne à ~/.zshrc ou ~/.bashrc, puis ouvrez un nouveau shell. Sans la variable, Qwen Code ignore la route ou échoue à l'authentification, sans basculer silencieusement vers un autre fournisseur.

5. Lancer Qwen Code

1
cd your-project
2
qwen

Lancez /model, choisissez gpt-5.6-terra ou claude-sonnet-5, puis envoyez une invite. Le choix est conservé pour la session.

Dépannage

  • Les modèles n'apparaissent pas dans /model — modelProviders n'est pas un tableau brut, ou l'ID de fournisseur n'est pas un type d'authentification intégré. Utilisez la forme "openai": [ ... ] ci-dessus.
  • 401 — CODEBYAI_API_KEY n'est pas exportée dans le shell qui a lancé qwen. echo $CODEBYAI_API_KEY doit afficher la clé.
  • 404 — baseUrl contient /chat/completions ou double /v1. Utilisez https://www.codebyai.net/api/agent/v1.
  • Une seule famille fonctionne — vérifiez l'ID sur le Model Plaza ; claude-* part vers le canal Claude, le reste est traité comme un modèle du canal Codex.

Premiers pas

Quatre étapes jusqu’à votre première requête

  1. 01

    Créer un compte gratuit

    Inscrivez-vous avec Google, GitHub ou votre email et définissez un mot de passe. Aucune carte n’est requise.

  2. 02

    Générer une clé API

    Créez une clé en un clic dans le tableau de bord pour authentifier votre CLI auprès de Code By AI.

  3. 03

    Recharger votre solde

    Ajoutez du crédit avant votre première requête ; l’utilisation est facturée au token sur votre solde.

  4. 04

    Pointer votre CLI vers Code By AI

    Exportez une variable d’URL de base, ou ajoutez un bloc de fournisseur de modèle dans config.toml. Les guides d’installation donnent les lignes exactes pour chaque agent.

Utiliser maintenantRecharger pour envoyer une requêteLe coût d’un mois de travail

Inscription sans carte · un rechargement est requis pour utiliser l’API