项目详情

OmniRoute

免费 AI 网关,一个端点聚合 278+ 供应商让 Claude Code 白嫖到底

GitHub 地址 MIT TypeScriptElectron

更新于 2026-07-23

← 返回汇总
项目速览

一句话定位

免费 AI 网关,一个端点聚合 278+ 供应商让 Claude Code 白嫖到底

自托管 AI 网关。把 Claude Code/Codex/Cursor/Cline/Copilot 指向一个本地端点,背后自动聚合 278+ 供应商(90+ 免费)、500+ 模型。配额耗尽自动 fallback,RTK+Caveman 双引擎压缩省 15-95% token。装上即用——内置 keyless 免费商零配置首请求就响应。25.7k Stars,500+ Contributors。

项目速览

核心数据

25.7k
GitHub Stars
278+
供应商
1.53B
免费 token/月
95%
最高省 token

TypeScript 单仓库 · 500+ Contributors · npm + Docker + Electron 三发行渠道 · 43 语言界面 · 免费层每两周重审(CI 门禁防漂移)

为什么存在

AI 编码的四道枷锁

订阅太贵

Claude Code/Cursor 订阅月费不菲,重度用户配额很快耗尽,触发限流。

免费层零散

几十家供应商各送一点免费额度,分散在几十个 SDK、几十个 rate limit 里,手动堆叠痛苦且不可见。

配额即悬崖

单个供应商配额一耗尽,编码中断。没有自动续命机制。

工具输出冗长

Agent 工具调用产生大量 shell/git/测试日志,吃掉上下文窗口与 token 预算。

核心理念

一个端点,永不停止

把所有 AI 供应商抽象成一条"链"——配额、健康度、成本三层感知,任何一个环节断了,下一个模型毫秒级接管。

编码工具 OmniRoute 端点 Combo 路由链 健康模型
旗舰特性

Combo — 不死的路由链

Combo 是一组模型按序排列的"链"。配额跑光、供应商挂掉、成本飙升——combo 静默滑到下一个。这是 OmniRoute "unbreakable" 的核心。

Model ID优化目标
auto🎯 均衡默认(LKGP——粘住上一个好用的供应商)
auto:cheap💰 优先最便宜/免费的
auto:fast⚡ 优先延迟最低
auto:smart🧠 优先质量最高
oc/… / felo/…直达特定免费后端(OpenCode Free / Felo)

19 种路由策略可组合,自定义 combo 把你的免费层串成永不断流的链。

旗舰特性

零配置即用

装上就响应——无需 API key、无需注册、无需配置。内置 keyless 免费商(OpenCode Free、Felo)已预接进 auto

# 全新安装,零凭证,auto 已可用:
curl http://localhost:20128/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
旗舰特性

RTK + Caveman 双引擎压缩

9 个可组合压缩引擎,在请求抵达模型前重写冗长输出。tool-heavy 会话省 78-95%,代码块与 URL 字节级保留。

Engine 1
RTK(Response Token Kit)
过滤并去重工具输出——shell、git、测试日志的重复行/无关注解压成精简形态。针对 Agent 工具调用场景。
Engine 2
Caveman
基于规则的散文缩短。砍填充词、冗余表述,保留语义。代码块、URL、结构化数据原样不动。

两引擎可叠加:RTK 处理工具噪声 + Caveman 压缩自然语言 = 约 89% token 节省(tool-heavy 会话)。每个 token 都能多走几倍距离。

兼容生态

编码工具全家桶

把下列任一工具的 API 端点指向 OmniRoute,立刻接入免费/多供应商池。

Claude Code

Anthropic 官方 CLI

Codex

OpenAI CLI

Cursor

AI IDE

Cline

VSCode Agent

Copilot

GitHub CLI

OpenCode

开源 CLI

Antigravity

Google Agent

任意 OpenAI 兼容

标准 /v1 端点

运行形态

在哪都能跑

  • Electron 桌面端:macOS/Windows/Linux 原生应用,图形化 Dashboard 管理 provider
  • npm CLInpx omniroute 一行启动,开发者首选
  • Docker:容器化部署,适合服务器常驻
  • PWA:浏览器装为应用,跨设备访问 Dashboard
  • MCP Server:作为 Model Context Protocol 服务暴露给 Agent
  • A2A:Agent-to-Agent 协议支持,编排多 Agent

默认端口 localhost:20128,OpenAI 兼容 API + 多模态支持。

快速上手

三步接入 Claude Code

# 1. 启动 OmniRoute(任选一种)
npx omniroute              # CLI
docker run -p 20128:20128 diegosouzapw/omniroute
# 或下载 Electron 桌面端
# 2. 把 Claude Code 指向 OmniRoute
export ANTHROPIC_BASE_URL=http://localhost:20128
export ANTHROPIC_API_KEY=omniroute
# 3. 启动 Claude Code,用 auto 模型
claude --model auto

首请求即响应——无需注册、无需 API key,auto 自动用内置 keyless 免费商。

适用场景

谁该用 OmniRoute

风险提示

需要清醒认识

潜力评估

未来空间

AI 网关赛道里最"野生"的玩家——不靠企业功能取胜,靠把免费层榨干 + 智能压缩 + 自托管隐私三张牌,精准命中个人开发者与成本敏感团队。25.7k stars 的增速说明痛点真实存在。若免费层生态稳定 + 压缩质量可控,有望成为 AI 编码时代的"省钱基础设施"。但本质上依赖第三方免费商的善意,可持续性是最大变量——它更像一个聪明的"薅羊毛编排器",而非可控的产品。


上一个
LikeC4
下一个
Kronos
1 / 14