Codex CLI avec RouterLab

1. Vérifiez les prérequis

Node.js ^22.13.0 ou ≥23.5.0, Codex CLI installé (≥0.144.1) et une clé RouterLab active. Sous Linux, le stockage sécurisé persistant requiert secret-tool et un service Secret Service disponible. Vérifiez les prérequis de votre version ScioNos dans son README.

node --version
codex --version

2. Installez ScioNos et connectez votre clé

Utilisez le service routerlab. La commande de connexion demande la clé avec une saisie masquée. Ne collez pas la clé dans une commande publiée. Le diagnostic doit confirmer la connexion et un catalogue autorisé non vide.

npm install -g wrapper-scionos
wrapper-scionos --version
wrapper-scionos auth login --service routerlab
wrapper-scionos doctor --service routerlab

3. Choisissez votre modèle et lancez l’outil

Codex utilise le protocole Responses. Dans le sélecteur natif /model, choisissez un modèle proposé par ScioNos et autorisé par votre clé. La présence d’un modèle dans le catalogue général ne prouve pas sa compatibilité Responses. Un compte Trial doit sélectionner une variante -trial compatible.

wrapper-scionos codex launch --service routerlab

4. Réussissez un premier lancement

Ouvrez un dossier de test. Demandez une courte réponse sans outil, puis une lecture de fichier autorisée. Vous devez recevoir une réponse et voir l’usage dans RouterLab. Le résultat exact dépend du modèle.

Réponds « connexion réussie », puis lis le README de ce dossier et résume-le en une phrase. Ne modifie aucun fichier.

Limites et dépannage

401 : reconnectez la clé. 403 ou catalogue vide : vérifiez le plan, l’expiration et les modèles autorisés. 429 : le quota est partagé entre toutes les clés et tous les modèles ; consultez votre budget et sa remise à zéro. Un refus de sous-agent doit être corrigé avec un modèle autorisé. Ne remplacez pas une variante Trial par une route de production pour contourner le refus.

Outils, vision, streaming et raisonnement dépendent du modèle et du protocole. Validez un petit cas représentatif avant de lancer votre projet. Les destinations du service sont fixes ; les variables de base URL personnalisée ne les remplacent pas.

wrapper-scionos doctor --service routerlab
wrapper-scionos auth status --service routerlab

Déconnexion et restauration

Quittez Codex, restaurez la configuration sauvegardée par ScioNos, puis déconnectez le service si vous voulez retirer la clé stockée.

wrapper-scionos codex restore --service routerlab
wrapper-scionos auth logout --service routerlab