OmniRoute sur le terrain : à quoi sert une passerelle IA à 352 modèles — Claude Code, Codex, Cursor

Quand Claude Code, Codex et Cursor restent ouverts la même semaine, le goulot n’est rarement « trouver un modèle plus fort ». Ce sont trois clés, trois Base URL et trois rustines après une panne de quota. OmniRoute sert lorsqu’il rassemble ces entrées en un AI Gateway local, puis vous laisse choisir quels modèles méritent un profil quotidien.

Point de données : OmniRoute v3.8.50 annonce publiquement 352 providers et environ 1 312 identifiants de modèles de chat. Ce n’est pas « exactement 352 modèles ». Le 352 des titres est la surface d’accès. L’acceptation demande si un endpoint peut servir Claude Code, Codex et Cursor sans nouveau fichier d’environnement chaque après-midi. (GitHub : OmniRoute)

Verdict : unifier l’entrée d’abord, compter les modèles ensuite. Si vous sautez déjà entre trois agents de code et leurs variables, trente minutes d’acceptation valent le coup. Un forfait officiel unique et presque aucune coupure de quota : n’ajoutez pas une passerelle pour une infographie à 352.

Le texte s’adresse aux développeurs solo qui tiennent Claude Code et Cursor ensemble, aux petites équipes qui veulent Codex CLI et l’éditeur sur un jeton, et aux responsables qui préfèrent poser une passerelle sur un Mac cloud plutôt que de la reconstruire sur chaque portable.

Mis à jour le 11 septembre 2026. Les tailles de catalogue sont les chiffres publics de ce jour-là ; confirmez-les avec un appel /v1/models vivant avant un wiki interne.

Ce que 352 veut vraiment dire

Les extraits de recherche écrasent « 352 providers » en « 352 modèles ». La lecture prudente, README et omniroute.online compris, est :

• 352 est le nombre de providers enregistrés ; environ 150 portent un drapeau de découverte gratuite.
• Le catalogue de chat compte 1 200+ identifiants (vers 1 312 autour de v3.8.50).
• Quotas gratuits, voies OAuth, modèles locaux et catalogues cloud n’ont pas le même dénominateur. Ne les additionnez pas en argument commercial.

La question d’achat change. Vous n’achetez pas 352 modèles. Vous demandez si une entrée compatible OpenAI peut pointer les trois outils vers la même machine, si l’épuisement de quota déclenche un repli, et si les journaux séparent clé, identifiant de modèle et protocole de l’outil.

OmniRoute est une passerelle IA auto-hébergée sous MIT. Le port local par défaut est 20128. Les outils envoient vers localhost ; la passerelle route selon catalogue, quota et repli. Le site public la compare aux autres routeurs sur le nombre de providers, la politique de repli, la compression de jetons et le réglage CLI — pas sur une nouvelle fenêtre de chat.

Voyez le catalogue comme un rayon et la passerelle comme un magasinier. Le rayon peut être long ; le magasinier n’expédie que quelques allées par jour. 352 décrit la largeur du rayon. Le profil quotidien décrit les règles d’expédition. Inverser les deux, c’est célébrer « on atteint beaucoup de modèles » sans workflow de code exploitable.

Pourquoi les trois outils ont besoin d’une passerelle

1. Les protocoles diffèrent. Claude Code parle Anthropic Messages ; Codex parle OpenAI Chat Completions ; Cursor veut une URL compatible OpenAI. Sans passerelle, vous gardez trois modèles mentaux.
2. Les clés se dispersent. Anthropic dans Claude Code, OpenAI dans Codex, un troisième agrégateur dans Cursor. Rotation et départ deviennent des conjectures.
3. Les quotas ne se synchronisent pas. Claude s’arrête ; Cursor tape encore l’API officielle. Le pool gratuit de Codex se termine ; l’éditeur n’en sait rien.
4. Les noms ne se réutilisent pas. Le même DeepSeek ou GLM peut avoir trois identifiants. On ne sait plus si l’écart de qualité vient du modèle ou de l’orthographe.

Une passerelle ne fusionne pas les trois produits. Elle fusionne « quelle variable d’environnement je corrige ». Pour une petite équipe, c’est plus proche du quotidien qu’un autre site agrégateur.

S’il faut aussi MCP et des serveurs d’outils sur la même machine, séparez les voies. La note interne déployer un serveur MCP sur un Mac mini cloud est le chemin outils ; OmniRoute est le chemin modèles. Ne déboguez pas les deux dans un seul processus.

Nous demandons aussi si les trois outils partagent un langage d’échec. Si Claude Code expire, Codex renvoie 429 et Cursor n’affiche que « provider error », tandis que le journal de passerelle n’a ni nom de provider commun ni identifiant de modèle, le saut n’apporte presque rien à l’exploitation. L’appel unifié n’est pas trois interfaces identiques. C’est une personne qui explique un échec à partir d’un journal.

Comment les trois outils rejoignent une entrée

La doc officielle fournit des commandes omniroute setup-* qui lisent le catalogue vivant et écrivent la config propre à chaque outil. (CLI Integrations)

Pour une démo, omniroute run claude ou omniroute run codex injecte l’environnement dans un processus. Cela suffit pour une capture, pas pour un poste partagé.

Claude Code filtre encore le sélecteur natif /model vers les identifiants qui commencent par claude ou anthropic lorsque la découverte passerelle est active. Kimi, GLM et DeepSeek passent toujours par un profil ou ANTHROPIC_MODEL ; ils restent hors de ce sélecteur. (Configuration Claude Code)

L’acceptation réussit si les trois outils apparaissent dans la console OmniRoute, si un échec nomme un provider, et si changer de modèle n’ouvre plus trois tableaux de bord vendeurs.

Au premier branchement, séparez « ça discute » et « ça tient la journée ». Une réponse prouve seulement le port ouvert. L’usage quotidien exige la même tâche courte reproduite dans les trois outils, un échec qui correspond à un identifiant dans le journal, et un changement de profil sans trois visites d’interface. On déclare trop souvent victoire à la première réplique, puis on découvre Cursor encore sur l’API officielle, un /v1 en trop dans Claude Code, ou un profil Codex limité à un onglet de terminal.

Liste d’acceptation de 30 minutes

• [ ] Node.js est installé et omniroute tourne sur le Mac que vous garderez allumé.
• [ ] http://localhost:20128 montre un catalogue, pas une page blanche.
• [ ] /v1/models avec la clé passerelle renvoie un compte réel. Ne collez pas le chiffre marketing.
• [ ] Branchez d’abord un outil — Claude Code ou Codex — pas les trois.
• [ ] Envoyez une tâche courte reproductible et lisez le journal : identifiant, latence, classe d’erreur.
• [ ] Désactivez le modèle préféré et voyez si le repli part.
• [ ] Ajoutez le deuxième outil et confirmez le même catalogue, pas une liste d’alias privés.
• [ ] Les clés vendeurs restent sur la passerelle. Les outils ne gardent que le jeton passerelle.

Si le catalogue ne charge jamais, 352 est une affiche. S’il est immense mais que le repli ne part jamais, vous avez ajouté un proxy et un point de défaillance unique.

Fixez la tâche courte. « Lister les fichiers de test du dossier et expliquer une fonction » suffit. Le bavardage ouvert est un mauvais test : il ne montre ni un identifiant faux, ni si les appels d’outils ont pris la voie supposée. Gardez une ligne avec l’heure, l’outil, l’identifiant, repli oui/non et l’erreur brute. Quinze jours plus tard, ce tableau dit si une mise à niveau a cassé la passerelle ou si un provider gratuit a simplement disparu.

Quand l’adopter, quand s’abstenir

La compression de jetons (le projet cite environ 15–95 % d’économie) n’est pas une imprimante à argent par défaut. Elle aide les longs dépôts et le contexte répété ; sur une courte complétion, elle peut n’ajouter qu’une transformation. Basculez-la sur une tâche et comparez qualité et facture.

Le routage ne répare pas un JSON d’appel d’outils cassé. Si les agents échouent sur les arguments, lisez pourquoi les agents IA dépendent du JSON avant d’ajouter un saut.

Il existe aussi une raison peu glamour de s’abstenir : personne n’est d’astreinte. La passerelle devient un nouveau point unique de défaillance. Un portable fermé, un processus planté, un certificat expiré ou un changement d’API de catalogue peuvent arrêter les trois outils d’un coup. Sans politique de redémarrage ni instantané, le confort d’une entrée unique disparaît à la première panne collective. Tenez la machine, puis parlez de 352.

Pourquoi poser la passerelle sur un Mac cloud

Une passerelle sur portable convient à une personne. Dès que Cursor, Claude Code et un hôte CI partagent un catalogue, le service disparaît avec le capot. Un Mac cloud qui reste allumé, prend des instantanés propres et peut révoquer l’accès est un meilleur foyer.

• Supervisez le processus avec launchd ou l’équivalent.
• N’exposez 20128 que sur un tunnel ou un réseau privé. Ne publiez pas la console.
• Gardez les clés sur la machine, hors Git et hors discussions.
• Prenez un instantané avant les mises à niveau pour pouvoir revenir.

Le Mac n’est pas « un modèle plus cher ». C’est le point de rendez-vous que les trois outils gardent après la mise en veille du portable. Relisez la séparation des accès sur la page d’aide Mac ZekVPS ; le compte passerelle n’est pas l’administrateur de l’hôte.

À partir de deux personnes, nous préférons un hôte passerelle plus l’éditeur de chacun, pas une passerelle par portable. Le second schéma paraît plus isolé, puis recopie règles de routage, logique de gratuit et mises à niveau trois fois. Le prix d’une passerelle partagée est une frontière plus nette : les collègues reçoivent un jeton passerelle, pas les clés amont, et n’éditent pas les routes de production. Une fois la ligne écrite, 352 providers cessent d’être 352 façons de mal cliquer.

FAQ

Unifier l’entrée, puis élargir le catalogue

OmniRoute n’est pas un concours du week-end pour essayer 1 300 modèles. C’est cesser de faire tourner trois clés bientôt expirées, basculer au lieu de s’arrêter, et comparer les modèles sur un seul journal. 352 décrit une largeur, pas votre profil par défaut.

Quand l’essai personnel tient, déplacez la passerelle vers un Mac cloud prêt à l’instantané, pour que les autres éditeurs visent la même entrée. Comparez les frontières d’hôte sur la page de service ZekVPS avant de choisir portable ou nœud distant.

Fermez par une phrase de note hebdo : prouver d’abord que trois outils de code touchent le même port local, décider ensuite quels modèles entrent en liste blanche. Le catalogue peut grandir. Le flux quotidien doit raccourcir, se permuter et se reverser.