O OmniRoute é um gateway de IA gratuito e de código aberto que roda no seu computador. Ele coloca centenas de provedores de IA atrás de um único endereço local, e o Claude Code, o Codex e outras ferramentas passam a usar esses modelos sem você trocar de configuração a cada vez. Se um provedor falhar ou bater o limite, ele pula para o próximo.

Antes de começar

• Um computador com macOS, Windows ou Linux.
• Node.js 24 (LTS). O OmniRoute também aceita a linha 22 a partir da 22.22.2 e as versões 25 e 26. Confira com node --version.
• O Claude Code ou o Codex instalados, se quiser usar o OmniRoute com eles.
• Nenhuma conta paga: dá para começar só com provedores grátis.

Rodar localmente não significa IA offline. O OmniRoute roda na sua máquina, mas cada pedido é enviado ao provedor escolhido. Suas chaves e logins ficam guardados no seu computador, criptografados.

1

Instale e abra o painel

Instale pelo npm:

TerminalCopiar

npm install -g omniroute

Depois, inicie:

TerminalCopiar

omniroute

O painel abre sozinho em http://localhost:20128. Se não abrir, digite esse endereço no navegador. Deixe o terminal aberto: o OmniRoute precisa continuar rodando enquanto você usa.

2

Conecte provedores grátis

No painel, abra Providers e clique em Add Provider. Três opções funcionam sem chave e sem cartão:

• Kiro AI: modelos Claude grátis.
• OpenCode Free: vários modelos, sem login.
• Pollinations: acesso a GPT, Claude, Gemini e outros.

Escolha um e clique em Connect. Depois você pode somar contas de assinatura e chaves de API; o OmniRoute usa tudo junto.

Segundo o projeto, as cotas grátis documentadas somam cerca de 1,51 bilhão de tokens por mês. O painel mostra quanto você já usou em /dashboard/free-tiers.

curl http://localhost:20128/v1/models -H "Authorization: Bearer SUA_CHAVE"

omniroute launch

export OMNIROUTE_API_KEY="SUA_CHAVE"

omniroute launch-codex --model auto

Economize tokens

Antes de mandar o pedido, o OmniRoute pode enxugar o contexto, como logs e saídas de terminal repetidas. Segundo o projeto, a combinação padrão (RTK seguido de Caveman) economiza de 15% a 95% dos tokens; em pedidos com muitos logs, a faixa documentada é de 78% a 95%. No exemplo do projeto, um pedido de 10.000 tokens chega ao provedor com cerca de 1.080. Você não muda nada nas suas ferramentas.

Acompanhe no painel

Em Analytics, você vê quais modelos responderam, quantos tokens usou e quanto teria custado. Em Monitoring/Logs, vê cada pedido.

Problemas comuns

• A ferramenta não conecta ("Can't connect"): o OmniRoute não está rodando. Abra um terminal e rode omniroute.
• "Rate limit exceeded" ou erro 429: o provedor grátis limitou os pedidos. Espere um minuto, use auto ou conecte mais provedores.
• Cannot find module 'better-sqlite3' com npm 11: rode npm approve-scripts better-sqlite3 e instale de novo.
• "Module did not self-register": sua versão do Node está fora da faixa suportada. Instale o Node 24, reinstale com npm install -g omniroute e rode omniroute.
• O Claude Code ignora o OmniRoute: se você configurou à mão, ANTHROPIC_BASE_URL fica sem /v1 no final, e o Claude Code precisa ser reiniciado. Com omniroute launch, isso já vem certo.
• Um provedor com login parou de funcionar: no painel, abra o provedor e clique em Reconnect, ou remova e adicione de novo.

Para diagnosticar provedores e portas, rode omniroute doctor.

O OmniRoute é um projeto open source, com licença MIT, criado pelo brasileiro Diego Souza. Código e documentação: github.com/diegosouzapw/OmniRoute. Este guia foi escrito para a versão 3.8.50.