OmniRoute 是一个免费、自托管的 AI 网关,把 Claude Code、Codex、Cursor、Cline 等 AI 编程工具统一接到本地端点 `http://localhost:20128/v1`,自动路由到 353 个提供商(其中 90 多个免费用量层)、1200 多个模型,并在配额耗尽或故障时自动降级,主打"Never stop coding"、零美元起步(宣传约每月 151 亿免费 token 池)。

| 项目 | 内容 |
|---|---|
| 仓库 | diegosouzapw/OmniRoute |
| 语言 / 许可证 | TypeScript / MIT |
| 总星标 | ⭐ 55,922 |
| 本月净增星标 | +25,758 |
| 榜单 | GitHub 官方月度趋势榜 第2名;星标增速榜 第17名 |
OmniRoute 是一个免费、自托管的 AI 网关,把 Claude Code、Codex、Cursor、Cline 等 AI 编程工具统一接到本地端点 `http://localhost:20128/v1`,自动路由到 353 个提供商(其中 90 多个免费用量层)、1200 多个模型,并在配额耗尽或故障时自动降级,主打"Never stop coding"、零美元起步(宣传约每月 151 亿免费 token 池)。
各家编程代理厂商推出的官方套餐额度普遍紧张且价格不菲,开发者迫切需要一个把白嫖额度聚合起来、还能自动切换兜底的中间层。OmniRoute 用一个 OpenAI 兼容端点就把多提供商池化、故障转移和成本优化全部解决,直接命中"省钱不断线"这一刚需,因此本月净增两万五千余星、冲上月度榜第二。
项目以 Node.js 22/24 LTS 运行时为基础,核心代码 100% TypeScript,前端采用 Next.js 16 + React 19 + Tailwind CSS 4;数据层用 better-sqlite3(WAL 模式)加 LowDB,含 FTS5 全文检索与向量量化记忆;测试规模可观——Vitest 下 5100 多个测试文件、39000 多条断言;另有 Electron 桌面版、Termux 安卓部署与 PWA 形态。
需要 Node.js >=22.22.2 且 <23,或 >=24 系列。最快路径是 npm 全局安装;Docker 镜像为 `diegosouzapw/omniroute:latest`;另有 pnpm、Arch AUR(omniroute-bin)、Termux、Nix/Bun 等多种安装源。
npm install -g omniroute && omniroute # 最快方式
docker run -d --name omniroute --restart unless-stopped \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
启动后无需任何配置即可调用:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
omniroute run claude --model openai/gpt-5.4 # 一条命令让 Claude Code 走网关
omniroute configure codex # 直接写入 Codex 自身配置
相比 LiteLLM、One API 这类通用 LLM 代理,OmniRoute 明显更面向"编程工具接入"场景做了特化:Combos 组合路由、token 压缩和一键写入各类编码代理配置的能力是其差异化卖点。