Facade Code Documentation
Configurer les agents

Codex + votre fournisseur

Donnez à une configuration Codex son propre fournisseur de modèles, ou réutilisez un profil natif que vous avez déjà.

Rassemblez les informations du fournisseur

Installez Codex et récupérez l’URL de base, la clé d’API et l’identifiant de modèle de votre fournisseur. Le point de terminaison doit prendre en charge l’API Responses d’OpenAI ; la compatibilité Chat Completions ne suffit pas.

L’exemple ajoute Codex · work sans modifier les autres entrées Codex ni la configuration globale de Codex.

Vous avez déjà un profil Codex ? Passez directement à Utiliser un profil Codex existant.

1. Définissez le fournisseur

Ajoutez cette configuration à facade.json (voir Paramètres des agents). Remplacez l’URL de base, la clé et l’identifiant de modèle de l’exemple :

facade.json
{
  "clis": {
    "Codex · work": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "args": [
        "-c",
        "model_provider=work",
        "-c",
        "model_providers.work.name=Work",
        "-c",
        "model_providers.work.base_url=https://api.example.com/v1",
        "-c",
        "model_providers.work.wire_api=responses",
        "-c",
        "model_providers.work.env_key=WORK_API_KEY"
      ],
      "env": {
        "WORK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Utilisez le même identifiant de fournisseur, work, dans model_provider=work et dans chaque paramètre model_providers.work.…. Le nom de la variable qui contient la clé, WORK_API_KEY, doit correspondre à env_key.

2. Vérifiez les paramètres du fournisseur

ParamètreRôle
model_provider=workSélectionne le fournisseur défini par les paramètres work.
model_providers.work.nameDonne un nom d’affichage à ce fournisseur.
model_providers.work.base_urlDéfinit l’URL de base de l’API.
model_providers.work.wire_api=responsesUtilise le format de l’API Responses.
model_providers.work.env_key=WORK_API_KEYIndique à Codex quelle variable d’environnement contient la clé.
env.WORK_API_KEYFournit cette clé au processus Codex.

Chaque option -c définit un réglage Codex pour les agents démarrés avec cette entrée.

L’exemple stocke la clé dans facade.json. Si la clé se trouve déjà dans une variable d’environnement, définissez env.WORK_API_KEY sur ${env:WORK_API_KEY}. L’éditeur doit disposer de cette variable avant le démarrage de l’agent.

3. Démarrez Codex avec cette configuration

Enregistrez facade.json, choisissez New Agent et sélectionnez Codex · work. Utilisez /model pour vérifier le modèle sélectionné, puis envoyez une courte tâche pour votre projet.

Si votre fournisseur affiche la consommation, vérifiez que la requête apparaît sur le bon compte. Pour contrôler la configuration de lancement, exécutez Show Agent Launch et choisissez l’emplacement de travail. Recherchez cette entrée dans le rapport pour voir comment le prochain agent démarrerait avec vos paramètres actuels.

Pour les erreurs de requête, voir Dépannage.

Exemple : QwenCloud

Pour une clé QwenCloud Token Plan, utilisez https://token-plan.maas.qwencloudapi.com/compatible-mode/v1 comme URL de base et conservez wire_api=responses. Utilisez un modèle disponible dans votre formule. Les clés avec facturation à l’usage utilisent le point de terminaison de leur région.

Paramètres Codex actuels de QwenCloud ↗

Utilisez un profil Codex existant

Si vous utilisez déjà un profil Codex natif, sélectionnez-le via les arguments de l’entrée :

facade.json
{
  "clis": {
    "Codex · profile": {
      "type": "codex",
      "args": [
        "--profile",
        "work"
      ]
    }
  }
}

Remplacez work par le profil que vous utilisez. Gardez la configuration du fournisseur dans ce profil au lieu de la répéter dans l’entrée Facade. Enregistrez, choisissez New Agent et sélectionnez Codex · profile. Envoyez une courte tâche et vérifiez la requête dans l’historique d’utilisation de votre fournisseur, si cet historique est disponible.

Afficher en Markdown ↗Documentation

Rechercher dans la documentation

Recherchez dans ce guide. Utilisez ↑ ↓ pour vous déplacer, Entrée pour ouvrir et Échap pour fermer.