TokenLab

Outils de code

OpenCodex

Connectez Codex à TokenLab via OpenCodex avec un routage API spécifique au modèle

Laissez mon agent configurer ceci

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

Read https://tokenlab.sh/docs/fr/integrations/opencodex and help me connect OpenCodex to TokenLab.
Check my installed OpenCodex and Codex versions, active configuration, and running proxy first.
Preserve existing accounts, providers, models, and permissions. Back up files before changing them.
Have me enter the API key locally; never ask for, print, or paste it in chat.
Use the TokenLab preset and the selected model's documented API format.
Check configuration loading first. Explain the cost before running a small real request.
Match the reply with its TokenLab request record.

Comment fonctionne 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 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 le routage spécifique aux modèles pour Responses et Anthropic Messages. Les routes listées ci-dessous ont été vérifiées avec TokenLab via du texte en streaming et des allers-retours d'appels de fonction/résultats.

Codex envoie des requêtes Responses au proxy local OpenCodex. OpenCodex envoie 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.

Modèles sélectionnés dans CodexOpenCodex → TokenLab
gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, grok-4.7, deepseek-v4.1-flash, deepseek-v4-pro, kimi-k3, glm-5.3Responses: POST /v1/responses
claude-opus-5, claude-opus-5-5, claude-sonnet-5, claude-sonnet-5-5, claude-fable-5, claude-fable-5-1Anthropic Messages: POST /v1/messages
gemini-3.8-flashChat Completions: POST /v1/chat/completions

L'URL de base (Base URL) du preset est https://api.tokenlab.sh/v1. Laissez-la inchangée : OpenCodex construit lui-même l'URL Messages ou Responses correspondante. Les modèles en dehors des valeurs par défaut de Responses 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 changez pas l'ensemble du fournisseur pour Responses ou Gemini ; cela modifierait également les requêtes pour les modèles qui n'acceptent pas ce format.

Installation ou mise à jour

Utilisez Node.js 18 ou une version ultérieure pour l'installation via npm :

npm install -g @bitkyc08/opencodex@2.73.0
ocx --version
codex --version

Codex doit également être installé. OpenCodex fournit des instructions d' installation et de connexion à Codex. Les versions natives Windows et WSL ont des configurations distinctes ; exécutez la configuration et Codex dans le même environnement.

Ajouter TokenLab

Créez une clé dans TokenLab API Keys. Pour la configuration via terminal, suivez le Démarrage rapide pour définir TOKENLAB_API_KEY sans mettre 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 de lancement.

Pour une installation propre d'OpenCodex, exécutez ocx init, sélectionnez TokenLab, et saisissez la clé localement ou utilisez la référence littérale 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 fournisseurs :

ocx provider add tokenlab --api-key '${TOKENLAB_API_KEY}'

Les guillemets simples enregistrent une référence de variable d'environnement, et non la valeur de la clé. Cette commande fonctionne également dans PowerShell. Si tokenlab existe déjà, modifiez ce fournisseur 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 :

ocx start
ocx status
ocx gui

Dans la page du fournisseur, vérifiez l'URL de base et les modèles découverts. Le preset découvre GET /v1/models?category=chat et conserve les modèles avec la capacité tool-use. Les modèles d'images, vidéo, audio, embeddings et de décision sont exclus. La découverte avec une clé reflète les permissions de modèle et la politique de livraison de 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 ; examinez les paramètres des fournisseurs personnalisés existants et effectuez une sauvegarde avant la synchronisation. Cela ne nécessite pas de remplacer votre compte ou votre politique de permission.

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

Choisissez l'entrée tokenlab/<model-id> dans le sélecteur de modèle de Codex, ou sélectionnez-la pour un lancement CLI :

codex -m "tokenlab/gpt-6.1-sol"

OpenCodex utilise tokenlab/ pour sélectionner le fournisseur ; l'ID de modèle envoyé à TokenLab est gpt-6.1-sol. Choisissez un ID exact actuellement disponible dans Models.

Pour une vérification de connexion rapide, envoyez :

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

Cette requête utilise votre solde TokenLab. Vérifiez la réponse et son modèle correspondant, l'heure et le statut dans Requests. La découverte du fournisseur et un démarrage réussi ne suffisent pas à vérifier l'accès à l'inférence.

Le streaming et l'appel de fonction fonctionnent sur les routes du tableau. L'entrée d'image et les contrôles de réflexion dépendent du modèle sélectionné : vérifiez ses capacités et utilisez uniquement les choix d'effort qu'OpenCodex propose pour ce modèle. L'entrée d'image et les requêtes de réflexion ont été vérifiées sur des modèles représentatifs pour les routes Responses et Messages ; l'entrée d'image Gemini a été vérifiée sur sa route Chat. Un modèle qui prend en charge la réflexion n'expose pas nécessairement le texte de réflexion et ne prend pas 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 listés, fusionnez une entrée modelAdapters dans l'objet existant providers.tokenlab de la configuration d'OpenCodex. Cet exemple conserve gpt-6-astra sur Chat pour Codex :

{
  "modelAdapters": {
    "gpt-6-astra": "openai-chat"
  }
}

Ceci est un exemple de champ de fournisseur, pas un remplacement de la configuration complète. Conservez les autres remplacements de modèles, identifiants et fournisseurs, puis redémarrez le proxy et ouvrez une nouvelle session Codex. Supprimer uniquement cette entrée de modèle restaure sa valeur par défaut Responses.

Le routage Messages de Claude est lié au point de terminaison canonique de TokenLab. Le remplacement Chat ci-dessus s'applique aux valeurs par défaut de Responses ; il ne bascule pas Claude vers Chat. Pour un client natif Chat, les modèles Responses listés utilisent déjà Chat sans ce remplacement. Voir OpenCodex provider routing.

Politique de livraison et autres outils TokenLab

Le preset ne force pas d'en-tête X-TokenLab-Delivery-Policy. TokenLab utilise la valeur par défaut de la politique de livraison de votre clé API. Choisir Chat, Responses ou Messages est distinct du choix d'une politique de livraison ; voir TokenLab provider settings.

Les TokenLab Skills ajoutent des instructions d'intégration. Ils ne modifient pas le fournisseur ou le format 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 comme backend. Appeler l' API System One de TokenLab via MCP est une opération distincte ; ne mettez pas de clé TokenLab dans le champ d'identifiants TypeSafe.

Générer des images et des vidéos dans le même agent

Codex peut également créer des images et de courtes vidéos avec le serveur MCP TokenLab. Chaque génération est payée à partir du même solde TokenLab. OpenCodex achemine uniquement les requêtes de modèle, et Codex lui-même démarre les serveurs MCP. Ajoutez le serveur à Codex dans le terminal où TOKENLAB_API_KEY est défini :

codex mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.48

MCP ne modifie pas le fournisseur ou le format API du modèle principal. Exécutez codex mcp list et vérifiez que tokenlab est listé. Ensuite, essayez dans une nouvelle session Codex :

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video renvoie un ID de tâche. L'agent appelle get_task_status jusqu'à ce que la vidéo soit prête.

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 disponible pour le processus exécutant OpenCodex. Une variable d'environnement dans un terminal différent ne met pas à jour un service déjà en cours d'exécution.
  • Modèle manquant : vérifiez l'ID exact, les permissions de votre clé et la disponibilité actuelle. Les modèles non-chat et les modèles chat sans tool-use ne sont pas inclus dans ce preset.
  • Requête non prise en charge ou mauvais point de terminaison : comparez le modèle sélectionné avec le tableau de routage et inspectez les remplacements d'adaptateurs enregistrés. Le format requis est tokenlab.accepted_request_formats dans model details ; la liste des modèles ne remplace pas ce champ de détail. Claude et Gemini ne doivent pas être envoyés vers Responses simplement parce que Codex utilise Responses localement.
  • Échec des outils ou de l'entrée d'image : conservez l'erreur originale et l'ID de requête. 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 arrêter d'acheminer Codex via le proxy, utilisez ocx stop ; OpenCodex arrête le proxy et restaure la connexion Codex native. ocx restore restaure la connexion native tout en gardant le proxy actif pour d'autres clients. Consultez la référence CLI d'OpenCodex avant de modifier une installation partagée par d'autres clients.

Sur cette page