Skip to main content

​
Laisser mon agent configurer ceci

Copiez cette tâche dans un agent déjà en cours d’exécution sur votre ordinateur :

​
Fonctionnement de la connexion

OpenCodex est un proxy local entre Codex et les API de modèles. Ce guide utilise OpenCodex 2.73.0 et Codex CLI 0.149.0. L’intégration de Chat Completions du preset TokenLab a été publiée et vérifiée de bout en bout dans la version 2.72.0. La version 2.73.0 conserve cette intégration et ajoute un routage spécifique au modèle pour Responses et Anthropic Messages. Les routes listées ci-dessous ont été vérifiées avec TokenLab en streaming de texte et avec des allers-retours function-call/résultat. Codex envoie des requêtes Responses au proxy local OpenCodex. OpenCodex transmet ensuite la requête du modèle sélectionné à TokenLab. Une requête Responses sur la connexion locale ne signifie pas que le modèle est appelé via l’API Responses de TokenLab. L’URL de base (Base URL) du preset est https://api.tokenlab.sh/v1. Ne la modifiez pas : OpenCodex construit lui-même l’URL Messages ou Responses correspondante. Les modèles situés en dehors des valeurs par défaut Responses listées et du routage Claude utilisent l’adaptateur Chat du preset. TokenLab prend en charge l’API native de Gemini pour les modèles qui la déclarent, mais le preset TokenLab d’OpenCodex 2.73.0 appelle Gemini via Chat Completions. Ne modifiez pas l’ensemble du provider pour Responses ou Gemini ; cela modifierait également les requêtes pour les modèles qui n’acceptent pas ce format.

​
Installer ou mettre à jour

Utilisez Node.js 18 ou une version ultérieure pour l’installation via npm :
Codex doit également être installé. OpenCodex fournit des instructions pour l’installation et la connexion à Codex. Windows natif et WSL possèdent des configurations distinctes ; exécutez l’installation et Codex dans le même environnement.

​
Ajouter TokenLab

Créez une clé dans Clés d’API TokenLab. Pour la configuration via le terminal, suivez le Démarrage rapide pour définir TOKENLAB_API_KEY sans inscrire sa valeur dans l’historique des commandes. Démarrez OpenCodex depuis ce terminal ; un service en arrière-plan a besoin de la variable dans son propre environnement d’exécution. Pour une nouvelle installation d’OpenCodex, exécutez ocx init, sélectionnez TokenLab, puis saisissez la clé localement ou utilisez la référence littérale de variable d’environnement ${TOKENLAB_API_KEY}. Vérifiez les choix de connexion à Codex et de démarrage automatique de l’assistant avant de les appliquer. Pour une installation existante, ajoutez le preset sans remplacer les autres providers :
Les guillemets simples enregistrent une référence à la variable d’environnement, et non la valeur de la clé. Cette commande fonctionne également dans PowerShell. Si tokenlab existe déjà, modifiez ce provider dans le tableau de bord au lieu de l’écraser avec --force. Vous pouvez également choisir TokenLab dans la liste Add provider du tableau de bord et y saisir la clé. OpenCodex enregistre sa configuration sous $OPENCODEX_HOME/config.json, généralement ~/.opencodex/config.json. Démarrez le proxy s’il n’est pas déjà en cours d’exécution, puis ouvrez son tableau de bord :
Sur la page du provider, vérifiez la Base URL et les modèles découverts. Le preset interroge GET /v1/models?category=chat et conserve les modèles disposant de la capacité tool-use. Les modèles d’images, de vidéo, d’audio, d’embeddings et de décision sont exclus. La découverte avec une clé reflète les autorisations de modèles et la politique de distribution associées à cette clé. Exécutez ocx sync pour connecter Codex et actualiser son catalogue de modèles, puis démarrez une nouvelle session Codex. Cela modifie la connexion proxy et le catalogue de Codex ; passez en revue les paramètres existants des providers personnalisés et conservez une sauvegarde avant d’effectuer la synchronisation. Cela ne nécessite pas de remplacer votre compte ou votre politique d’autorisations.

​
Sélectionner un modèle et vérifier une requête

Choisissez l’entrée tokenlab/<model-id> dans le sélecteur de modèles de Codex, ou sélectionnez-la pour un seul lancement en CLI :
OpenCodex utilise tokenlab/ pour sélectionner le provider ; l’ID de modèle envoyé à TokenLab est gpt-6.1-sol. Choisissez un ID exact actuellement disponible depuis la page Modèles. Pour un test de connexion rapide, envoyez :
Cette requête consomme votre solde TokenLab. Vérifiez la réponse ainsi que le modèle correspondant, l’horodatage et le statut dans Requêtes. La découverte du provider et un démarrage réussi ne suffisent pas à eux seuls à vérifier l’accès à l’inférence. Le streaming et le function calling fonctionnent sur les routes indiquées dans le tableau. La saisie d’images et les contrôles de réflexion dépendent du modèle sélectionné : vérifiez ses capacités et utilisez uniquement les options d’effort proposées par OpenCodex pour ce modèle. Les requêtes avec saisie d’images et réflexion ont été vérifiées sur des modèles représentatifs pour les routes Responses et Messages ; la saisie d’images pour Gemini a été vérifiée sur sa route Chat. Un modèle prenant en charge le raisonnement n’expose pas nécessairement le texte de réflexion et ne prend pas forcément en charge tous les niveaux d’effort.

​
Conserver un modèle Responses sur Chat Completions

Pour utiliser le chemin Chat pour l’un des modèles Responses répertoriés, fusionnez une entrée modelAdapters dans l’objet providers.tokenlab existant de la configuration d’OpenCodex. Cet exemple maintient gpt-6-astra sur Chat pour Codex :
Il s’agit d’un exemple de champ de provider, et non d’un remplacement de la configuration complète. Conservez les autres surcharges de modèles, identifiants et providers, puis redémarrez le proxy et ouvrez une nouvelle session Codex. La suppression de cette seule entrée de modèle rétablit son comportement par défaut Responses. Le routage Messages de Claude est lié au endpoint canonique de TokenLab. La surcharge Chat ci-dessus s’applique aux valeurs par défaut Responses ; elle ne bascule pas Claude vers Chat. Pour un client natif Chat, les modèles Responses listés utilisent déjà Chat sans cette surcharge. Consultez le routage des providers OpenCodex.

​
Politique de distribution et autres outils TokenLab

Le preset ne force pas d’en-tête X-TokenLab-Delivery-Policy. TokenLab utilise la politique de distribution par défaut de votre clé d’API. Le choix entre Chat, Responses ou Messages est distinct du choix d’une politique de distribution ; consultez les paramètres de provider TokenLab. Ajoutez le serveur MCP TokenLab pour d’autres outils d’API, ou les Skills TokenLab pour obtenir des instructions d’intégration. Ceux-ci ne modifient ni le provider ni le format d’API du modèle principal. JEV Auto dans OpenCodex 2.73.0 utilise le backend de décision de TypeSafe. Il ne propose pas TokenLab pour ce backend. L’appel de l’API System One de TokenLab via MCP est une opération distincte ; n’indiquez pas de clé TokenLab dans le champ d’identifiants de TypeSafe.

​
Dépannage et restauration de votre configuration

  • TokenLab est absent du sélecteur : vérifiez ocx --version ; ce guide cible la version 2.73.0. Actualisez le catalogue avec ocx sync et démarrez une nouvelle session Codex.
  • 401 ou identifiants manquants : vérifiez que la clé est active et accessible par le processus exécutant OpenCodex. Une variable d’environnement définie dans un autre terminal ne met pas à jour un service déjà en cours d’exécution.
  • Modèle manquant : vérifiez l’ID exact, les autorisations de votre clé et sa disponibilité actuelle. Les modèles non-chat et les modèles de chat sans tool-use ne sont pas inclus dans ce preset.
  • Requête non prise en charge ou mauvais endpoint : comparez le modèle sélectionné avec le tableau de routage et examinez les surcharges d’adaptateurs enregistrées. Le format requis est tokenlab.accepted_request_formats dans les détails du modèle ; la liste des modèles ne remplace pas ce champ détaillé. Claude et Gemini ne doivent pas être envoyés vers Responses simplement parce que Codex utilise Responses localement.
  • Échec des outils ou de la saisie d’images : conservez l’erreur d’origine et le Request ID. Vérifiez les capacités du modèle et la route OpenCodex active avant de modifier les paramètres ; ne supprimez pas l’historique de conversation ou les résultats d’outils pour masquer une erreur.
Pour cesser de router Codex via le proxy, utilisez ocx stop ; OpenCodex arrête le proxy et rétablit la connexion native de Codex. ocx restore rétablit la connexion native tout en maintenant le proxy en cours d’exécution pour les autres clients. Consultez la référence CLI d’OpenCodex avant de modifier une installation partagée par d’autres clients.