OmniRoute: cos'è, come si installa e se è davvero sicuro

OmniRoute è un gateway AI open source che installi sul tuo computer o server: offre un solo endpoint compatibile con OpenAI e smista le richieste tra centinaia di provider, passando al successivo quando finisce una quota. Il software è gratis con licenza MIT, ma non lo è sempre ciò che ci colleghi.

Prima di installarlo controlla la versione: fino alla 3.8.51 ci sono due falle gravi.

Cos'è OmniRoute e a cosa serve

OmniRoute si mette tra i tuoi strumenti (Claude Code, Codex, Cursor, Cline, OpenCode) e i modelli. Punti il tool su http://localhost:20128/v1 e il gateway decide dove mandare la richiesta.

• Fallback automatico: se un provider esaurisce la quota o va in errore, passa al successivo.
• Combo: liste ordinate di modelli con 19 strategie di instradamento, dalla priorità fissa al costo più basso.
• Compressione: 12 motori riducono il contesto inviato. Il dichiarato è 15-95% sui contenuti idonei, non sull'intera bolletta.
• Dashboard locale: quote, costi, salute dei provider e log in un'unica pagina.
• MCP e A2A: un server con 110 strumenti per far guidare il gateway a un agente.

Il progetto è pubblico da febbraio 2026 ed è cresciuto molto in fretta: al 9 novembre 2026 ha circa 85.800 stelle e 13.000 fork su GitHub.

Il repository ufficiale ora è cheaper-inference/OmniRoute, perché il progetto è entrato in Cheaper Inference. Attenzione ai fork: controlla sempre di essere sul repository giusto.

OmniRoute vs OpenRouter e LiteLLM

Le differenze con gli altri router, in breve:

• OpenRouter è un servizio ospitato: paghi lui e lui parla con i modelli. Non devi gestire niente.
• LiteLLM è pensato per i team: chiavi condivise, budget per utente, Python.
• OmniRoute gira da te, unisce abbonamenti, chiavi API e piani gratuiti, e punta su fallback e compressione. In cambio hai un'applicazione grande da aggiornare.

Se vuoi solo provare più modelli, parti da OpenRouter. OmniRoute ha senso quando hai davvero più fonti di quota da far lavorare insieme.

Quanto costa OmniRoute: è davvero gratis?

Il software non costa nulla se lo ospiti tu. Paghi invece tre cose:

1. I modelli. Le chiavi API restano a tuo carico, a consumo.
2. La macchina. Se non gira sul tuo PC serve un server: per un agente di coding la documentazione indica almeno 10 GB di memoria al container nella configurazione consigliata.
3. OmniRoute Cloud, se lo scegli. È un'istanza gestita con hosting mensile e inferenza fatturata a parte. Sulla pagina ufficiale non ho trovato un prezzo pubblico.

Poi c'è il titolo che gira di più: circa 1,5 miliardi di token gratis al mese. È un dato dichiarato dal progetto e va letto bene.

Circa un miliardo arriva da un solo provider, Mistral. Quindi due terzi del totale dipendono da un unico piano gratuito, con limiti di richieste da verificare sul tuo account.

Anche i provider senza chiave sono un extra, non una base di lavoro. La guida rapida avverte che possono non essere disponibili o rifiutare i client di terze parti, e che i piani gratuiti possono chiedere registrazione, approvazione o un metodo di pagamento.

Come installare OmniRoute

Serve Node.js 22.22.2 o successivo sulla linea 22, oppure dalla 24 alla 26. La 23 è esclusa. Su npm, al 9 novembre 2026, c'è la 3.8.53.

npm install -g omniroute
omniroute

La dashboard si apre su http://localhost:20128. Con npm 11 o successivi l'installazione può bloccare gli script di post installazione: il messaggio di avviso indica quali pacchetti autorizzare, e autorizzarli significa farli eseguire.

Per un uso continuativo sceglierei Docker, legato soltanto all'interfaccia locale:

docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
  -p 127.0.0.1:20128:20128 -e INITIAL_PASSWORD \
  -v omniroute-data:/app/data diegosouzapw/omniroute:latest

Quel 127.0.0.1 è la parte importante: senza, il gateway ascolta su tutte le interfacce della macchina.

Prima del comando genera una password con export INITIAL_PASSWORD=$(openssl rand -base64 24). Su versioni recenti, senza questa variabile, la password iniziale risultava CHANGEME.

Poi i passaggi sono questi:

1. Apri la dashboard e controlla che il login sia obbligatorio.
2. In Providers aggiungi una chiave API di un servizio di cui hai letto le condizioni.
3. In Endpoints copia la chiave del gateway.
4. Punta il tuo strumento su http://localhost:20128/v1 con quella chiave.
5. Verifica con curl http://localhost:20128/v1/models -H "Authorization: Bearer LA_TUA_CHIAVE".

Il comando omniroute doctor controlla porte, dipendenze e provider quando qualcosa non parte.

OmniRoute con Claude Code: cosa funziona e cosa no

Per collegare OmniRoute a Claude Code imposti due variabili in ~/.claude/settings.json:

ANTHROPIC_BASE_URL=http://localhost:20128
ANTHROPIC_AUTH_TOKEN=la-chiave-del-gateway

Tecnicamente funziona. Però la promessa di "Claude Code gratis" nasconde tre cose:

• Non stai usando Claude. Se dietro ci sono modelli gratuiti, usi l'interfaccia di Claude Code con un altro cervello. Qualità e uso degli strumenti cambiano.
• Anthropic non lo supporta. La documentazione dice che non supporta l'instradamento di Claude Code verso modelli non Claude tramite alcun gateway. Se si rompe qualcosa, sei da solo.
• Il token del gateway spegne l'abbonamento. Con ANTHROPIC_AUTH_TOKEN la sessione non usa il tuo piano claude.ai, e i consumi vanno sull'account collegato al gateway.

Se ti interessa spendere meno con Claude Code, ci sono strade più pulite: le trovi nella guida su come usare Claude Code gratis anche con Ollama e in quella su come ridurre i token. Per i costi ufficiali guarda i prezzi dei piani Claude.

OmniRoute è sicuro? Le due falle da conoscere

Dipende dalla versione e da come lo esponi. Un gateway di questo tipo custodisce le chiavi di tutti i tuoi provider, quindi è un bersaglio di valore. Nel 2026 sono uscite due vulnerabilità pesanti:

• CVE-2026-88062, gravità 9,5 su 10. Fino alla 3.8.49 un endpoint per registrare agenti personalizzati permetteva di eseguire codice sul server, senza autenticazione se il login era disattivato o nella fase iniziale di una nuova installazione.
• CVE-2026-116634, gravità 8,2. Dalla 3.8.50 alla 3.8.51, con login disattivato, chiunque poteva ottenere un token di sincronizzazione e leggere chiavi API e credenziali in chiaro. Quei token restavano validi anche dopo aver riattivato il login.

La seconda è corretta nella 3.8.52. Sulla prima le banche dati pubbliche non sono state concordi per un periodo: una versione alta non basta a dire che sei a posto, conta anche la configurazione.

La checklist che applicherei

1. Aggiorna almeno alla 3.8.52 e tieni il gateway aggiornato: il progetto rilascia spesso.
2. Lascia il login attivo, sempre.
3. Non esporlo su internet. Per l'accesso remoto usa una VPN.
4. Se hai avuto versioni vulnerabili raggiungibili dall'esterno, ruota tutte le chiavi collegate. Non basta aggiornare.
5. Se lo tieni in rete, isola il processo: ne parlo nella guida su Docker Sandbox e in quella su NVIDIA OpenShell.

Le chiavi rubate sono ormai una merce: l'ho raccontato nell'analisi delle API key come nuovo bottino.

Il rischio che pochi citano: gli account

Oltre alle chiavi API, OmniRoute può collegare abbonamenti via OAuth (25 provider) e sessioni web tramite cookie (35 provider, tra cui ChatGPT, Claude e Gemini Web).

La documentazione cita anche la simulazione dell'impronta TLS e delle firme dei client per ridurre il rilevamento come bot. Per me questo è il punto da valutare con più attenzione.

• Anthropic non consente agli sviluppatori di terze parti di raccogliere, conservare o intermediare credenziali e token di sessione Claude.ai.
• Google nelle condizioni di Antigravity non ammette l'accesso tramite proxy e router di terze parti, nemmeno per uso personale. A novembre 2026 sul forum ufficiale compaiono account sospesi con errore 403 che avevano collegato OmniRoute.
• OmniRoute stesso marca alcuni provider come tos: avoid e li esclude dal routing automatico: è un segnale da non ignorare.

La regola che seguirei è semplice: su OmniRoute solo chiavi API, l'abbonamento resta nel client ufficiale. Rischiare la sospensione dell'account con cui lavori tutti i giorni per risparmiare qualche euro non conviene.

OmniRoute in azienda e GDPR

Il gateway è locale, ma i prompt arrivano comunque al provider scelto per ogni richiesta. La telemetria è disattivata di default, le credenziali sono cifrate e c'è un mascheramento opzionale dei dati personali. Tre attenzioni:

• Il modello "auto" decide lui. In azienda definisci combo chiuse con soli fornitori con cui hai un accordo sul trattamento dei dati.
• Niente dati di clienti nei piani gratuiti di cui non conosci le condizioni su conservazione e addestramento.
• Il mascheramento non copre tutto. L'elenco documentato comprende email, telefoni e carte, ma anche identificativi brasiliani e statunitensi: il codice fiscale italiano non è nella lista. Va gestito a parte.

Per un'azienda che deve collegare più modelli partirei da pochi fornitori scelti, con controllo dei costi e dei dati, dentro un progetto di automazione AI.

Quando conviene usarlo

Ha senso se sperimenti su progetti personali, hai diverse chiavi API e vuoi un fallback unico, oppure confronti molti modelli con OpenCode o Hermes Agent.

Lo eviterei se devi trattare codice o dati riservati senza controllo sui fornitori, se non hai tempo di seguirne gli aggiornamenti, o se l'unico motivo è avere Claude gratis. Quello, con OmniRoute, non lo ottieni.

Leggi anche

• AI cinese open source: i modelli che consiglio
• MCP: cos'è e come funziona
• Limiti di Claude Code e come non finirli

Vuoi capire se un gateway serve davvero nel tuo progetto, e come impostarlo senza esporre chiavi e dati? Scrivimi e guardiamo il tuo caso.