← Toutes les ressourcesRessources · Guide gratuit

Claude Code illimité avec OmniRoute

OmniRoute est un outil gratuit et open source qui se place entre Claude Code et des centaines de fournisseurs d'IA. Quand un modèle atteint sa limite, il passe au suivant, et il compresse tes requêtes au passage. Ce guide l'installe de A à Z.

  • 20 min d'installation
  • 0 € avec les offres gratuites
  • Mac · Windows · Linux
  • Open source · licence MIT
  • Vérifié le 6 oct. 2026
Vadim
1Les prérequisNode.js et Claude Code sur ton ordi.
2Installer OmniRouteLe tableau de bord tourne sur ton ordi.
3Brancher des IA gratuitesDes modèles qui répondent, sans payer.
Avant de commencer
Vadim, auteur du guide

Vadim

@vadimvision

Tu diriges une entreprise ? Tes tâches manuelles te coûtent de la marge. Avec mon équipe de développeurs web et IA, je mets l'IA au cœur de tes opérations : un système qui connaît tes méthodes, tourne dans tes outils et prend en charge une partie du travail de chaque service.

Réserver mon audit offert →

N°ÉtapeCe que ça donne
1Les prérequisNode.js et Claude Code sur ton ordi.
2Installer OmniRouteLe tableau de bord tourne sur ton ordi.
3Brancher des IA gratuitesDes modèles qui répondent, sans payer.
4Lancer Claude Code dessusClaude Code passe par OmniRoute.
5La bascule automatiqueUne limite atteinte ? Il change de modèle seul.
6Activer la compressionMoins de tokens envoyés, même résultat.

Le principe. Normalement, Claude Code parle directement aux serveurs d'Anthropic, et ton forfait s'arrête quand tu atteins ta limite. Avec OmniRoute, Claude Code parle à un petit serveur qui tourne sur ton ordi (localhost:20128). C'est lui qui choisit à quel fournisseur envoyer chaque requête : Mistral, Groq, Cerebras, Kimi, GLM, DeepSeek… Le projet recense plus de 150 offres gratuites, qui cumulent environ 1,6 milliard de tokens par mois.

Étape 1

Les prérequis

3 minutes

Il te faut deux choses : Node.js (version 22 ou 24) et Claude Code. Vérifie d'abord ta version de Node dans le terminal :

Terminal
node -v

Si la commande répond v22… ou v24…, c'est bon. Sinon, installe la version LTS depuis nodejs.org. Ensuite, si tu n'as pas encore Claude Code :

Terminal
npm install -g @anthropic-ai/claude-code
Étape 2

Installer OmniRoute

2 minutes

Une seule commande installe OmniRoute, et une deuxième le lance :

Terminal
npm install -g omniroute
omniroute

Ouvre ensuite http://localhost:20128 dans ton navigateur : c'est le tableau de bord d'OmniRoute. Tout tourne sur ton ordi, tes clés y sont chiffrées.

Des avertissements jaunes pendant l'installation ? Les messages npm warn ERESOLVE sont normaux et sans conséquence. Garde la fenêtre du terminal ouverte : si tu la fermes, OmniRoute s'arrête. Sur Mac, l'app de barre de menus OmniRouteTray le garde allumé à ta place.

Étape 3

Brancher des IA gratuites

5 à 10 minutes

Dans le tableau de bord, va dans Providers (fournisseurs). Commence par les deux plus simples :

Les plus rapides à brancher

  • OpenCode Free : aucune inscription, ça répond tout de suite.
  • Kiro AI : des modèles Claude gratuits, environ 50 crédits par mois et par compte. Tu te connectes depuis le tableau de bord.

Avec une clé gratuite (2 min chacun)

  • Mistral : le plus gros quota gratuit du catalogue.
  • Groq et Cerebras : très rapides.
  • OpenRouter : les modèles marqués :free.

Pour ceux de la deuxième colonne : crée un compte sur le site du fournisseur, génère une clé API, puis colle-la dans OmniRoute. Plus tu branches de fournisseurs, plus tu as de tokens gratuits. La page Free tiers du tableau de bord (/dashboard/free-tiers) affiche ton budget mois par mois.

Étape 4

Lancer Claude Code dessus

1 minute

D'abord, récupère ta clé OmniRoute : dans le tableau de bord, va dans Endpoints et copie la clé. Ensuite, la façon la plus simple de lancer Claude Code à travers OmniRoute, sans rien modifier dans ta configuration :

Terminal
omniroute run claude --model auto/coding

Claude Code s'ouvre comme d'habitude, mais ses requêtes passent par OmniRoute. auto/coding veut dire « le meilleur modèle disponible pour coder ». Pour retrouver ton Claude Code normal, lance simplement claude.

Si tu veux que Claude Code passe toujours par OmniRoute, mets l'adresse dans ses réglages. Remplace la clé par la tienne :

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:20128",
    "ANTHROPIC_AUTH_TOKEN": "ta-cle-omniroute",
    "ANTHROPIC_MODEL": "auto/coding"
  }
}

Attention à l'adresse. Pour Claude Code, c'est http://localhost:20128, sans /v1 à la fin (le /v1 sert aux autres outils comme Cursor ou Cline). Pour revenir en arrière, supprime ce bloc env.

Étape 5

La bascule automatique

2 minutes

Avec le modèle auto, tu n'as rien à régler : OmniRoute construit tout seul une chaîne avec les fournisseurs que tu as branchés, classés en direct. Quand l'un atteint sa limite, tombe en panne ou devient trop lent, il passe au suivant, et ta session continue.

Les variantes d'« auto »

  • auto/coding : la qualité d'abord, pour le code.
  • auto/fast : le plus rapide d'abord.
  • auto/offline : celui qui a le plus de quota restant.

Ou ton propre ordre

  • Dans Combos, crée une chaîne : par exemple Kiro (Claude) en premier, puis GLM, Kimi, DeepSeek.
  • Lance-la avec --model suivi du nom de ta combo.

Pour vérifier que tout est branché, cette commande liste les modèles disponibles. Remplace TA_CLE par ta clé :

Terminal
curl http://localhost:20128/v1/models -H "Authorization: Bearer TA_CLE"
Étape 6

Activer la compression

1 minute

OmniRoute peut alléger chaque requête avant de l'envoyer au modèle. Il retire les mots inutiles, résume l'historique et filtre les longues sorties du terminal. Tu choisis le mode dans la section Compression du tableau de bord :

1
Lite (~15 %)Ne change rien au sens, juste la mise en forme. Le mode sûr à laisser allumé tout le temps.
2
Standard (~30 %)Retire les formules creuses (« s'il te plaît », « en fait »…) sans toucher au sens.
3
RTK (60 à 90 %)Spécial sorties du terminal : logs, tests, git. C'est là que Claude Code consomme le plus.
4
Empilé RTK → Caveman (78 à 95 %)Les deux à la suite : le meilleur gain sur les sessions de code. Le code, les liens et le JSON sont gardés à l'identique.

Les gros pourcentages concernent surtout les sorties du terminal et l'historique. Sur un message court, le gain est plus faible ; le projet annonce 89 % en moyenne sur une requête de code type.

Ce qu'il faut savoir avant de foncer.

Ce n'est pas toujours Claude qui répond. Hors Kiro, ce sont d'autres modèles (GLM, Kimi, DeepSeek, Mistral…), très bons en code, mais pas identiques à Claude.

Le 1,6 milliard, c'est le total des offres gratuites que tu branches toi-même, compte par compte. Ces chiffres sont revus toutes les deux semaines par le projet et bougent dans les deux sens.

Tes données. Certaines offres gratuites peuvent utiliser tes messages pour entraîner leurs modèles. N'y envoie ni code client, ni mots de passe, ni données sensibles.

Les conditions d'utilisation. OmniRoute signale, sur la page Free tiers, les fournisseurs dont les conditions posent question pour ce genre d'usage. C'est à toi de vérifier et de décider. Le projet est prévu pour un usage personnel.

Si ça bloque

Les solutions rapides

?
Quelque chose ne marche pasLance omniroute doctor : il vérifie les fournisseurs, le port et l'installation.
?
Claude Code affiche une erreur de connexionOmniRoute est-il bien lancé (fenêtre du terminal ouverte) ? L'adresse est-elle sans /v1 ?
?
Erreur d'authentificationRecopie la clé depuis Endpoints dans le tableau de bord.
?
Aucun modèle ne répondBranche au moins OpenCode Free ou Kiro à l'étape 3, puis réessaie avec le modèle auto.
Copié dans le presse-papiers