← ScioNos

Claude Code avec RouterLab

Un parcours avec ScioNos, de l’installation au premier appel. Les modèles disponibles dépendent de votre accès et de la version du wrapper.

1. Vérifiez les prérequis

Node.js ^22.13.0 ou ≥23.5.0, Claude Code installé (≥2.1.220) 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.

Terminal shell

node --version
claude --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.

Terminal shell

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

Pour un compte d’essai, choisissez la stratégie Trial. Vérifiez le modèle principal et le modèle des sous-agents : ils doivent tous deux être autorisés par la clé et porter le suffixe -trial. Pour un abonnement, choisissez une stratégie disponible dans votre catalogue. Si aucun modèle compatible n’est proposé, arrêtez le lancement et lancez le diagnostic.

Terminal shell

wrapper-scionos claude-code --service routerlab --strategy trial

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.

Message de test text

Réponds « connexion réussie ». Ensuite, délègue à un sous-agent la lecture du 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.

Diagnostic shell

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

Déconnexion et restauration

Quittez Claude Code puis déconnectez le service pour supprimer la clé stockée par ScioNos. Le proxy local est lié à la session de lancement.

Terminal shell

wrapper-scionos auth logout --service routerlab